Antタスクを使用してプロジェクトのドキュメントを生成します。いくつかの場所で、標準クラスからドキュメントを継承したかったので{@inheritDoc}
、EclipseでJavadocを表示できるように使用しましたが、HTMLファイルには表示されませんでした。問題は、解凍したsrc.zip(J2SEソース)をソースパスに含めていなかったことです。これを修正した後、のようなファイルでのSun独自のAPIの使用について数百の警告が表示されるようになりlib/jdk-src/java/lang/Class.java
ました。
これらの警告を抑制する方法はありますか?この混乱の中で関連する問題を見つけるのは難しいです。
私が考えた解決策は、ソースパスにJ2SEソースを含めずにJavadocタスクを1回実行することでした。これにより、実際の問題が明らかになります。次に、J2SEソースを含めてJavadocをもう一度実行し、出力を完全に破棄します。これにより、適切に機能するドキュメントが作成されます{@inheritDoc}
。Antでこれを達成するための最良の方法については完全にはわかりません。言うまでもなく、Javadocを2回実行すると汚い修正になります。
助言がありますか?