Javadocのパッケージ説明

Javadocを生成した所、パッケージの説明が空白でした。
調べたら、パッケージごとにpackage.htmlを置く、と出てきましたが、HTMLを置くのは微妙だなぁと。

と、さらに調べるとJavaSE 5からはpackage-info.javaなるソースを追加して記述できるとのこと。

/**
 * パッケージの説明だおー
 */
 package jp.co.xxx.packagename;

こちらを採用。