– 正しく出力されるので害はないものの、毎回警告がでていたので調べてみた。警告内容は次の通り。
javadoc: 警告 – パッケージ “x.y.z” に複数のパッケージコメントのソースが検出されました。
英語だと以下。
Multiple sources of package comments found for package “x.y.z”
Java Forums <http://forum.java.sun.com/thread.jspa?threadID=599721&tstart=0> にずばり回答が。
Yep. The Doclet interface of the Doclet API specifies a method
void setRawCommentText(String text)
prior to 1.5 this method did exactly what its name implies. With 1.5 the implementation was changed to generate a warning and do nothing if it was attempted to set the comment text multiple times.
What happens is this:
Javadoc sees the package.html files in the sources, creates an appropriate Doc (PackageDoc) instance and sets the comment text. Then for some reason Javadoc encounters package.html files for already existing Doc instances and tries to set the comment text a second (third, fourth, …) time.
So, all you need to do is to ensure that Javadoc parses the package.html file for a given package only once, i.e. ensure that only sourcepath points to the package.html files but not classpath.
1.5 から package.html が複数見付かった時に上書きしつつ、警告を出すようになったとのこと。
ここで例にあるとおり、 javadoc のオプションで、 sourcepath でパッケージのある場所を示しつつ、なおかつ classpath でも示していたのが原因だった。Eclipse ではリリースディレクトリにも package.html をコピーしてくれていて、結局それが source のものと重複してしまった。
そもそも不要な、classpath からリリースディレクトリ(bin)の指定を外して解決。