2

Antを使用してドキュメントを作成しています。{@inheritDoc}、、、などのメソッドequalsに使用hashCodeしましtoStringた。ただし、これらのメソッドの説明は表示されません。スクリーンショットを参照してください：

ここに画像の説明を入力してください

これが私のAntスクリプトです：

<project name="javadoc" default="javadoc.tool">
  <description>
    Provides JavaDoc. 
  </description>

  <import file="build.xml" />
  <property name="javadoc.dir" location="${build.dir}/javadoc" />
  <property name="javadoc.failonerror" value="false" />

  <target name="javadoc.tool" depends="compile" description="Generate JavaDoc.">
    <mkdir dir="${javadoc.dir}" />
    <javadoc classpathref="compile.classpath"
             sourcepath="${src.dir}"
             destdir="${javadoc.dir}"
             author="true"
             version="true"
             use="true"
             package="true"
             overview="${src.dir}/overview.html"
             windowtitle="${system.name} API"
             doctitle="${system.name} API"
             failonerror="${javadoc.failonerror}"
             excludepackagenames="junit"
             linksource="true" />
  </target>
</project>

継承されたメソッドの説明をドキュメントに表示するにはどうすればよいですか？あなたのアドバイスは大歓迎です。ありがとう！

4

2 に答える 2

3

標準のJavaクラスからドキュメントを継承しようとしている場合は、ソースパスにJDKを含める必要があるsrc.zipと思います。（あなたもそれを解凍する必要があるかもしれません;私は思い出しません。）

とは言うものの、メソッドが「予期しない」ものである場合は、とにかく独自のドキュメントを作成する必要があります。そうでない場合、IMOは実際にはそれらの説明を必要としません。

于 2012-09-08T21:29:27.160 に答える
0

これが古いスレッドであることは知っていますが、javadoc Antタスクを使用して外部APIにリンクする適切な方法は、ネストされた<link>要素を使用することです。たとえば、Java7APIにリンクするには次のようにします。

<javadoc ... >
  ...
  <link href="http://docs.oracle.com/javase/7/docs/api/" />
</javadoc>

詳細については、関連するAntのドキュメントをお読みください。

于 2014-05-07T20:37:52.660 に答える