mieki256's diary



2008/03/08() [n年前の日記]

#1 [iappli] Javadocを試しに出力したり

最終提出時にはソースについて説明した文書が必要らしいので、昨日弄ってたJavaアプレットのソースを使って、eclipseから操作してJavadocを試しに出力してみたり。

メソッド等の概略の一文がどこで区切られるのかがよく判らず。検索してみたところ、「.」(ピリオド)+改行で区切られるらしい。が、どうも昨今のJavadocでは「。」+改行も区切りとして認識してくれる模様。たぶん。

基本的には、public指定したメソッド・フィールド等について出力することが多いらしく、その点についてはちょっと頭を抱えてしまった。自分のiアプリのソースは、private指定してる箇所がほとんどなわけで…。パッケージ中の全てのソレを出力するようにオプションを与える(というかeclipseからの操作時に「private」を選ぶ)しかないか…。

自分のiアプリのソースは、フィールド(メソッド変数?)のコメントが「// 〜」なのもちょっと困ったなと。Javadoc は、「/** 〜 */」しか見てくれないらしいし…。ソース中の「// 〜」を「/** 〜 */」に書き換えていくしかないか。

しかしコメント部分を変更するためだけに、ソースを編集してしまうのもどうなんだという感も。また、「// 〜」なら1行で済むところを、「/** 〜 */」にすると3行になってしまうのも見た目的になんだかなと。Javadocを使うこと前提でソースを書いてることを知らない人が見た場合、「なんでコイツ、こんなわけの判らない書き方をしてるんだ?」と思われてしまうのだろうな…。

以上です。

過去ログ表示

Prev - 2008/03 - Next
1
2 3 4 5 6 7 8
9 10 11 12 13 14 15
16 17 18 19 20 21 22
23 24 25 26 27 28 29
30 31

カテゴリで表示

検索機能は Namazu for hns で提供されています。(詳細指定/ヘルプ


注意: 現在使用の日記自動生成システムは Version 2.19.6 です。
公開されている日記自動生成システムは Version 2.19.5 です。

Powered by hns-2.19.6, HyperNikkiSystem Project