我最近开始使用DocCheck来检查代码文件中JavaDoc的有效性。
有什么方法可以将DocCheck设置为eclipse插件吗?
最佳答案
这被认为是一个好主意back in 2002,但仍然asked for in 2004 ...
但是从那时起,Java项目属性的“Java Compiler / Javadoc
”部分几乎覆盖了Sun Doc Check Doclet(最初在Sun内部开发并发布给开发人员社区以供原样使用的实验代码)的所有功能(尽管没有HTML融洽的输出)
如果您确实想要DocCheck报告,我建议您制作一个custom Project Builder,例如this one(与DocCheck完全无关,这里只是一个例子)
(来源:bell-labs.com)
另请参见 FAQ How do I implement an incremental project builder? 或 FAQ How do I create an external tool builder?
我还建议您仅在执行填充构建(IncrementalProjectBuilder.FULL_BUILD
)时设置此自定义构建器,调用DocCheck,以避免每次保存文件时都等待。
最终用户可以通过在导航器中选择一个项目,选择“属性”,然后转到构建器页面来添加外部工具构建器。
在“构建选项”选项卡上,您可以指定构建器应在自动构建,手动构建还是在 Clean 上运行。
在大多数情况下,在自动构建期间运行外部工具构建器会造成破坏性,因为它们运行时间过长。