如何在只有一些更改时阻止生成所有javadoc文件

Question

我正在使用JAutodoc在eclipse neon 2中自动评论java文件。 我使用：

创建了javadoc文件

然后我改变一些java文件并再次生成javadoc。 当我检查git repo时，我观察到“所有文档”被修改而不是仅修改了文件。

问题是javadoc会生成所有文件，我希望javadoc只生成更改的java文件。

有没有办法做到这一点？

Answer 1

无论源文件是否已更改，

javadoc都将重新生成所有文档。给定特定参数，javadoc处理可以通过包名称和/或文件/路径名限制为选择的文件集，但不受文件条件限制（即，具有/没有改变，时间戳等）。您可以通过查看javadoc - The Java API Documentation Generator了解有关控制javadoc的更多信息。

虽然可以创建仅将javadoc处理限制为已更改文件的脚本，但不建议这样做。考虑一个已移至不同包的类。仅在javadoc文件上运行.java不会更新其他部分对该类的引用（例如包摘要，@link引用）。

由于Javadocs通常是从源代码生成的工件，因此就版本控制而言，在存储库中跟踪它们没有任何好处。您可以通过.gitignore排除它们（一旦您使用git rm删除它们）。