Как предотвратить генерацию всех файлов JavaDoc, когда есть только некоторые изменения

Question

Я использую JAutodoc для автоматического комментирования файлов Java в затмении неона 2. Я создал файл JavaDoc с помощью:

Тогда Я изменяю некоторые java-файлы и снова создаю javadoc. Когда я проверяю git repo, я наблюдаю, что «все doc» изменено, а не только измененные файлы.

Проблема в том, что javadoc генерирует все файлы, и я хочу, чтобы javadoc генерировал только измененные java-файлы.

Есть ли способ сделать это?

Answer 1

javadoc будет регенерировать все документы независимо от того, были ли исходные файлы изменены. При определенных аргументах обработка javadoc может быть ограничена выбором набора файлов либо по имени пакета, либо по имени файла/пути, но не по условиям файла (т. Е. Не изменилось, отметки времени и т. Д.). Вы можете узнать больше об управлении javadoc, просмотрев javadoc - The Java API Documentation Generator.

Хотя можно создавать скрипты, ограничивающие обработку только измененными файлами javadoc, это не рекомендуется. Рассмотрим класс, который переместился в другой пакет. Запуск javadoc на том, что только файл .java не будет обновлять ссылки на этот класс в других частях (например, сводки пакетов, @link ссылок).

Поскольку Javadocs - это артефакты, обычно генерируемые из исходного кода, отслеживание их в вашем репозитории не имеет никакой пользы в отношении контроля версий. Вы можете просто исключить их через .gitignore (как только вы удалили их с помощью git rm).