Javadoc

javadoc.png

Javadoc作成編

ショートカットキーでドキュメントを自動生成☆

Macならば

Command+Alt+j

javadocを出力してみる

Androidでは色々、追加でオプションを入れないとうまくビルドできません
私の環境(Mac)の場合はこういうのをいれないとダメだった

-encoding "utf-8" -charset 'utf-8" -bootclasspath /Applications/sdk/platforms/android-18/android.jar

option.png
http://dev.classmethod.jp/smartphone/javadoc-setting-for-android/

開発中にjavadocチェックするには?

関数をマウスオーバーレイするだけでも出てくるけど、自分のすてきなスタイルシートで見たい場合はどうすればいいのか?

Javadocにパスを通しておくと、エディター内で[Shift] + [F2]とすることで、すぐにJavadocを参照することができます。

APIリファレンスの出力先として、現在作業中のJavaプロジェクト内を指定すると、Eclipseの「パッケージ・エクスプローラー」ビューなどで多くのファイルが生成されていることが、すぐに確認できますね。

JavaDocのスタイルシートをかっこよくするには?

デフォルトのは1990年代から変わってなくてダサいですよね?
oldfashion.png
今風にかっこよくするにはどうしたらいいんでしょう?
JavaDocを生成するときのStyle sheetのところにチェックしましょう
まずStep1はJavadoc1.7以上でコンパイルすること。
Macではデフォルトで1.6までしか入っていない。
1.7以上はSun のサイトからインストールする必要がある。
新しいJavadocでコンパイルしたら、まず???な出力結果になる。
plain.png
どうやらスタイルシートが何も効いていない状態のようである。
このスタイルシートを使えばstylesheet8.css現代風な見た目になる
modern.png


documentation reverse-engineering

サポートサイト Wikidot.com documentationreverse-engineering