2

在构建我们的文档时,我们决定使用一些自定义标签在类级别添加详细信息,并利用 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 给了我一个如下所示的部分:

序列步骤:

methodOne() 方法一细节,methodTwo() 方法二细节

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

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

序列步骤:

methodOne() 方法一细节

methodTwo() 方法二细节

或者

序列步骤:

methodOne() 方法一细节

序列步骤:

methodTwo() 方法二细节

4

1 回答 1

2

试试这个:

/**
 * @SequenceStep 
 * <p>{@link package.DummyClass#methodOne()} Method one specifics</p>
 * <p>{@link package.DummyClass#methodTwo()} Method two specifics</p>
 */
于 2013-04-23T19:55:17.947 回答