java - 当只有一些更改时如何防止生成所有 javadoc 文件

Question

我正在使用 JAutodoc 在 eclipse neon 2 中自动注释 java 文件。我使用以下方法创建了 javadoc 文件：

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

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

有没有办法做到这一点？

Answer 1

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

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

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