いや、正確には昨日なんだけど...。
社員さんがjavadocで一行目の最後になぜか半角のドットつけてたんでなんでって聞いたら『前のプロジェクトで"区切りだからつけろ"って怒られた』だそうで...。
説明文の1行目は概要として扱われるので、機能を簡潔に記述すること。半角ピリオドで終わっているかどうかで文として認識しているので、日本語で記述する場合にも、全角の「。」「,」は使えない。
Javadoc用のコメントの書き方
1997年のドキュメントでございました。そんなルールまったく知らず(汗
てなわけでそのあたりを調べてて網に引っかかりました的な感じなものをつらつらと。
複数のJavaDocファイルをまとめて、Wordのファイルにする方法
http://blog.goo.ne.jp/xmldtp/e/f37870f7ee449fbb36f670a5c46891fb