java - 当只有一些更改时如何防止生成所有 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 处理仅更改的文件，但不推荐这样做。考虑一个已经移动到不同包的类。单独在该 .java 文件上运行 javadoc 不会更新其他部分对该类的引用(例如包摘要、@link 引用)。

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