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

Question

我在eclipse neon2中使用JAutodoc自动注释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删除了它们)。