1

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

有没有办法抑制这些警告?在这种混乱中很难找到相关的问题。

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

有什么建议么?

4

1 回答 1

0

这不是您正在寻找的解决方案,但您可以尝试-link extdocURL。这样,您至少会分别获得覆盖或实现方法的“覆盖”“指定者”链接。对于开发库,该-linksource选项也很方便。

于 2010-03-31T00:39:27.153 回答