ドキュメントを作成するとき、いくつかのカスタム タグを使用してクラス レベルで詳細を追加し、ビルドに 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 には、次のようなセクションが表示されます。
シーケンスステップ:
methodOne() メソッド 1 の詳細、methodTwo() メソッド 2 の詳細
私の期待は、タグの使用ごとに 1 つをリストして、@param の動作と同等のものを取得することでした。
可能であれば、代わりに次の出力のいずれかを取得する方法について提案を提供できますか?
シーケンスステップ:
methodOne() メソッド 1 の詳細
methodTwo() メソッド 2 の仕様
また
シーケンスステップ:
methodOne() メソッド 1 の詳細
シーケンスステップ:
methodTwo() メソッド 2 の仕様