java - 如何解决 "javadoc: warning - Multiple sources of package comments found for package a.b.c"？

Question

我已经非常过时了，但我刚刚将我的项目从 JDK 1.4 升级为使用 JDK 1.5，现在在运行 mvn javadoc:javadoc 时，我遇到以下 javadoc 警告:

[WARNING] javadoc: warning - Multiple sources of package comments found for package "com.a"
[WARNING] javadoc: warning - Multiple sources of package comments found for package "com.b"
[WARNING] javadoc: warning - Multiple sources of package comments found for package "com.c"
[WARNING] javadoc: warning - Multiple sources of package comments found for package "com.a"

我需要做什么来修复它们？从 JDK 1.4 到 1.5 有什么变化吗？

谢谢!

Answer 1

(在原始答案 10 年后更新。)

旧thread in the Oracle forums讨论了这个。 (不幸的是，链接现在已断开，我在新的 Oracle 开发人员社区中找不到相同的线程，也找不到 in the Wayback machine)。

据我所知(并且可以从一些 google 中收集到)，javadoc 的行为在 JDK 1.4 和 1.5 之间发生了变化，因此多次遇到的包文档会产生此警告。这似乎特别发生在旧版本的 Maven 上——更新到新版本的 Maven(或 maven-javadoc-plugin)似乎有所帮助。

(当然，这意味着 Maven 版本是 2011 年的最新版本，因此您现在拥有的任何版本都应该没问题。)