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

时间:2010-03-30 15:55:38

标签: java ant javadoc inheritdoc

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

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

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

有什么建议吗?

1 个答案:

答案 0 :(得分:0)

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