Eclipse/javaDoc の編集 - dekuyou's knowledge base.

#navi(Eclipse)

#contents

*EclipseでjavaDoc [#nc07ded8]
普通にjavaのソースにjavadocコメントを書いただけでは、概要ページがのっぺらぼうのjavadocが生成されます。~
なので、概要ページに記述されるべき物の設定やらの覚書~
各クラス・メソッドにはjavaDocコメントが記述されているのが前提~

**概要の説明ファイル作る [#i7e81b2c]
-[[JavaDoc覚書>Java/JavaDoc覚書]]

**EclipseでjavaDoc生成 [#o6d7ae67]
-[プロジェクト]→[javadoc の生成]選択

***javaDoc生成ウィザードの設定 [#xc6ed84b]

-次のウィンドウでjavadocを生成したいプロジェクトを選択します
#ref(javadoc01.jpg)
-次へ進みます

-次のウィンドウで[文書タイトル]にチェックを入れタイトルを記入します。
--このタイトルは概要ページの先頭にあるタイトルのことです。((j2seだったら「JavaTM 2 Platform,  Standard Edition, 1.4.0 API 仕様」とか書いてるやつです))
#ref(javadoc02.jpg)
-次へ進みます

-次のウィンドウで[概説]にチェックを入れ[ブラウズ]から概要の説明ファイルoverview.htmlにパスを通します。
#ref(javadoc03.jpg)
-終了でjavadocを生成します。
--javadoc1.4では[-quiet]なんてパラメータを付加してやると生成時のコンソールのコメントがErrorのみになります。((正常に生成されてるのにコメントはかれるのはうざいのでおすすめ))

***生成されたjavadocはこんな感じ [#gfd8c68f]

-するとこんな感じで概要のページが生成されます。
#ref(javadoc04.jpg)
-なんとなくそれらしくなったかと思います。

~
~

*情報 [#q2b459fb]
-クラスに禁則文字を使っているとjavaDocの生成対象から外れるそうです。 -- [[javadoc1.4]] SIZE(10){2003-10-29 (水) 22:16:00}
-[overview.html]のファイル名はjavadoc生成時にpathを通すのでぶっちゃけどんなファイル名でも良いと思うのですが、標準的に[overview.html]にするようです。 -- [[概要]] SIZE(10){2003-10-29 (水) 22:22:40}

*備考 [#ydf6014b]
参考
-[[javadoc ・Java API ドキュメントジェネレータ:http://java.sun.com/j2se/1.4/ja/docs/ja/tooldocs/win32/javadoc.html]]

タイムスタンプを変更しない