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