通过 Ant 任务使用来自 J2SE 类的 {@inheritDoc} 的 Javadoc

Question

我使用 Ant 任务为项目生成文档。在几个地方，我想从标准类继承文档，因此我使用了 {@inheritDoc}，它允许我在 Eclipse 中查看 Javadoc，但它不会显示在 HTML 文件中。问题是我没有将解压的 src.zip (J2SE 源代码)包含在源路径中。解决这个问题后，我现在收到了数百条关于在 lib/jdk-src/java/lang/Class.java 等文件中使用 Sun 专有 API 的警告。

有什么办法可以抑制这些警告吗？在这困惑的环境中很难找到相关的问题。

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

有什么建议吗？

Answer 1

这不是您正在寻找的解决方案，但您可以尝试 -link extdocURL 。这样你至少会得到 "Overrides"或"Specified by"分别覆盖或实现的方法的链接。对于开发库，-linksource这个选项也很方便。