Как создать ссылку на Javadoc в класс в модуле братьев и сестер?JAVA

Программисты JAVA общаются здесь
Anonymous
Как создать ссылку на Javadoc в класс в модуле братьев и сестер?

Сообщение Anonymous »

Учитывая, что: < /p>
  • Комментарии Marckdown Javadoc могут ссылаться на ссылки < /li>
    Ссылки определяются, в частности:

    Самая общая форма ссылки: < /p>

    Код: Выделить всё

    module/package.class#member
  • Эта структура проекта:

Код: Выделить всё

.
├── build.gradle
├── com.example.moduleone
│   ├── build.gradle
│   └── src
│       └── main
│           └── java
│               ├── com
│               │   └── example
│               │       └── botany
│               │           ├── fruit
│               │           │   └── Tomato.java
│               │           └── package-info.java
│               └── module-info.java
├── com.example.moduletwo
│   ├── build.gradle
│   └── src
│       └── main
│           └── java
│               ├── com
│               │   └── example
│               │       └── food
│               │           ├── package-info.java
│               │           └── vegetable
│               │               └── Potato.java
│               └── module-info.java
├── gradle
│   └── wrapper
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
├── lib
│   └── markista.docagrams.jar
└── settings.gradle

Я бы предположил, что с правильными параметрами команды Javadoc следующий комментарий Javadoc будет отображаться как ссылка на класс томата в com.example.moduleone :

Код: Выделить всё

/// [com.example.moduleone/com.example.botany.fruit.Tomato] is a reference to a class

< /code>
Вместо этого, когда я запускаю Javadoc, я получаю ошибку: < /p>
javadoc -d build/doc/com.example.moduletwo \
--module-path com.example.moduleone/build/classes/java/main:com.example.moduletwo/build/classes/java/main \
--source-path com.example.moduleone/src/main/java:com.example.moduletwo/src/main/java \
-subpackages com.example.food.vegetable:com.example.botany.fruit \
-link ../com.example.moduleone --add-modules com.example.moduleone \
com.example.moduletwo/src/main/java/module-info.java \
com.example.moduletwo/src/main/java/com/example/food/vegetable/Potato.java \
com.example.moduletwo/src/main/java/com/example/food/package-info.java

Loading source file com.example.moduletwo/src/main/java/module-info.java...
Loading source file com.example.moduletwo/src/main/java/com/example/food/vegetable/Potato.java...
Loading source file com.example.moduletwo/src/main/java/com/example/food/package-info.java...
Loading source files for package com.example.food.vegetable...
Loading source files for package com.example.botany.fruit...
Constructing Javadoc information...
Creating destination directory: "build/doc/com.example.moduletwo/"
error: Error reading file: build/doc/com.example.moduletwo/../com.example.moduleone/element-list
Building index for all the packages and classes...
Standard Doclet version 24.0.1
Building tree for all the packages and classes...
Generating build/doc/com.example.moduletwo/com.example.moduletwo/com/example/food/vegetable/Potato.html...
Generating build/doc/com.example.moduletwo/com.example.moduletwo/com/example/botany/fruit/Tomato.html...
Generating build/doc/com.example.moduletwo/com.example.moduletwo/com/example/botany/fruit/package-summary.html...
Generating build/doc/com.example.moduletwo/com.example.moduletwo/com/example/botany/fruit/package-tree.html...
Generating build/doc/com.example.moduletwo/com.example.moduletwo/com/example/food/vegetable/package-summary.html...
Generating build/doc/com.example.moduletwo/com.example.moduletwo/com/example/food/vegetable/package-tree.html...
Generating build/doc/com.example.moduletwo/com.example.moduletwo/module-summary.html...
Generating build/doc/com.example.moduletwo/overview-tree.html...
Generating build/doc/com.example.moduletwo/allclasses-index.html...
Building index for all classes...
Generating build/doc/com.example.moduletwo/allpackages-index.html...
Generating build/doc/com.example.moduletwo/index-all.html...
Generating build/doc/com.example.moduletwo/search.html...
Generating build/doc/com.example.moduletwo/index.html...
Generating build/doc/com.example.moduletwo/help-doc.html...
1 error

< /code>
Полный путь к классу томата и его источником: < /p>
com.example.moduleone/build/classes/java/main/com/example/botany/fruit/Tomato.class
com.example.moduleone/src/main/java/com/example/botany/fruit/Tomato.java
< /code>
module-info.java от com.example.moduleone:  < /p>
/// Example module
module com.example.moduleone {
exports com.example.botany.fruit;
}
< /code>
module-info.java от com.example.moduletwo: < /p>
/// Example module
module com.example.moduletwo {
exports com.example.food.vegetable;
}
git Repo с воспроизводимой задачей:
https://github.com/sandydunlop/javadoc- ... -not-found

Подробнее здесь: https://stackoverflow.com/questions/797 ... ing-module

Вернуться в «JAVA»