java - Javadoc 中的多个自定义标签单独显示?

标签 java ant javadoc

在构建文档时,我们决定使用一些自定义标签在类级别添加详细信息,并利用 Ant 任务进行构建。以下是 ant 任务目标的示例:

<target name="doc">
    <javadoc 
        access="public" 
        additionalparam=" -tag SequenceStep:a:&quot;Sequence Step:&quot;"
        author="true" 
        destdir="ant/doc" 
        doctitle="Test"
        nodeprecated="false" 
        nodeprecatedlist="false" 
        noindex="true" 
        nonavbar="true" 
        notree="true" 
        source="1.6" 
        sourcepath="${src.dir};${test.dir}" 
        splitindex="false" 
        use="false" 
        version="true"
        private="on"
        failonerror="false">
            <classpath path="${full.test.classpath}" />
    </javadoc>

在我一直在测试的类的内部,这里有一个示例 Javadoc:

/**
 * @SequenceStep {@link package.DummyClass#methodOne()} Method one specifics
 * 
 * @SequenceStep {@link package.DummyClass#methodTwo()} Method two specifics
 */

我生成的 Javadoc 给了我一个如下所示的部分:

Sequence Step:

methodOne() Method one specifics, methodTwo() Method two specifics

我的期望是得到与 @param 的工作方式更等效的东西,每次使用该标签都会列出一个。

如果可能的话,任何人都可以提供有关如何获得以下输出之一的建议吗?

Sequence Step:

methodOne() Method one specifics

methodTwo() Method two specifics

Sequence Step:

methodOne() Method one specifics

Sequence Step:

methodTwo() Method two specifics

最佳答案

试试这个:

/**
 * @SequenceStep 
 * <p>{@link package.DummyClass#methodOne()} Method one specifics</p>
 * <p>{@link package.DummyClass#methodTwo()} Method two specifics</p>
 */

关于java - Javadoc 中的多个自定义标签单独显示?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/16177760/

相关文章:

java - 如何使用 Apache ivy 解决多个文件的依赖关系?

java - 如何覆盖子类中 final方法的 javadoc?

java - Java 并发中如何真正访问方法

java - 变量只在 while 循环内才有值?

java - 从 "Java Webservices: Up and Running"导入项目

java - 在 Eclipse 中为现有代码生成 JavaDoc 注释

javadoc - 记录 Salesforce.com Apex 类文件

java - 我可以使用 retryWhen 并在达到限制时返回可观察值吗?

java - 安卓JAVA : Reading variables that a thread is accessing

java - 无法验证 ANT 1.9.7 设置