在构建文档时,我们决定使用一些自定义标签在类级别添加详细信息,并利用 Ant 任务进行构建。以下是 ant 任务目标的示例:
<target name="doc">
<javadoc
access="public"
additionalparam=" -tag SequenceStep:a:"Sequence Step:""
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/