我使用 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 两次将是一个肮脏的修复。
有什么建议么?