Java 5から、Javadocのパッケージコメントはpackage-info.javaというJavaファイルに書けるようになったのだそうだ。ついこのあいだまで知らなかった。EclipseではNew Java Classで作ろうとするとクラス名が不正だと怒られるので、New Fileで作るとよろしい。
/** * ここにパッケージの説明を書く。 */ package org.mypkgname;
前はpackage.htmlってのに書かなくちゃいけなくて、プラットフォームごとのエンコーディング問題とかがややこしかったから助かる。