ant - 使用 ant 创建带标签的 javadoc

标签 ant javadoc

我已经使用像 {@see myPackage.MyClass} 这样的标签通过 javadoc 注释了我的 java 源代码。

我必须从终端使用 ant 生成 javadoc,但我收到此警告:

[javadoc] src/calendar/annotation/DataType.java:11: warning - Tag @see cannot be used in inline documentation.  It can only be used in the following types of documentation: overview, package, class/interface, constructor, field, method.

在 build.xml 中有这一行:

<javadoc  sourcepath="${sourceDir}" destdir="${docDir}" windowtitle="MyProject" />

有人可以帮我吗?

编辑:

我的使用方式是正确的。例如我有

/**
 * <p>Metoda provede požadovaný dotaz do databáze za použití předaných parametrů.
 * Pokud jsou parametry nedostatečně nedefinované, SQL dotaz neexistuje nebo nastane
 * problém s komunikací, dojde k vygenerování {@see calendar.exception.LoadException}.
 * Pokud žádné entity neodpovídají požadavku, dochází k vrácení prázdného seznamu.
 * V případě, že nějaké entity odpovídají požadovanému pravidlu, jsou načteny především ty,
 * které již jsou definovány v persistenční vrstvě. Pokud tam entity nejsou zavedeny, dochází
 * k jejich načtení z databáze.</p>
 * @param entityClass
 * @param query
 * @param params
 * @return
 * @throws calendar.exception.LoadException
 */
<EntityClass extends AbstractEntity> Collection<EntityClass> find( Class<EntityClass> entityClass, String query, Map<String, Object> params ) throws LoadException;

最佳答案

关于ant - 使用 ant 创建带标签的 javadoc,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/929799/

相关文章:

java - 在处理中找不到 android 模式

java - 有自动更新Javadoc的工具吗?

java - Javadoc 注释中的多行代码示例

android - Kotlin 文档不支持像 '<p>' 这样的标签

java - 如何从 javadoc Ant 任务的结果中排除特定的方法/构造函数?

Java ant 帮助,不同的文件集用于不同的目标

java - 我可以在 ANT 中使用 less4j 将 less 编译成 css 吗?

java - 用于 apache-commons 风格打包的样板 ant/maven 配置

java - 在更新到 junit 5 时保持 build.xml 的语法兼容性

java - 为什么 IntelliJ IDEA 会发出此文件 javadoc 悬空的警告?