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

Question

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

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

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

有没有办法做到这一点？

Answer 1

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

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

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