J2SE类中带有{@inheritDoc}的Ant任务通过Javadoc

Question

我使用Ant任务为项目生成文档。 在某些地方，我想从标准类继承文档，所以我使用了{@inheritDoc} ，它使我可以在Eclipse中查看Javadoc，但不会显示在HTML文件中。 问题是我没有在源路径中包含解压缩的src.zip（J2SE源）。 修复此问题之后，我现在在lib/jdk-src/java/lang/Class.java类的文件中收到有关使用Sun专有API的数百条警告。

有什么办法可以抑制这些警告？ 在这个混乱中很难找到相关的问题。

我想到的一种可能的解决方案是一次运行Javadoc任务，而在sourcepath中不包括J2SE源，这将揭示任何实际问题。 然后，我可以再次使用包含J2SE源的Javadoc来运行，完全丢弃输出，这将产生工作正常的{@inheritDoc}的文档。 我并不完全确定在Ant中完成此操作的最佳方法，更不用说两次运行Javadoc会是一个肮脏的修复程序。

有什么建议么？

Answer 1

这不是您要寻找的解决方案，但是您可以尝试-link extdocURL 。 这样，您至少将分别获得重写或实现的方法的“替代”或“指定者”链接。 对于开发库， -linksource选项也很方便。