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

时间:2013-04-23 19:37:07

标签: java ant javadoc

在构建我们的文档时,我们决定使用一些自定义标记在类级别添加详细信息,从而为构建利用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给了我一个看起来像这样的部分:

  

序列步骤:

     方法一个细节,methodTwo()方法两个细节

我的期望是获得更与@param工作方式相同的东西,列出每个标签使用一个。

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

  

序列步骤:

     

methodOne()方法一个细节

     

methodTwo()方法二具体细节

  

序列步骤:

     

methodOne()方法一个细节

     

序列步骤:

     

methodTwo()方法二具体细节

1 个答案:

答案 0 :(得分:1)

试试这个:

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