NetBeans - автоматически добавляет @author к классу при изменении кода

Question

Как я могу сделать NetBeans 8.1+ для автоматического добавления тега @author в JavaDoc класса, который я редактирую?

Answer 1

Ближайшие иметь этот процесс автоматизирован в Netbeans, чтобы запустить Tools -> Analyze Javadoc перед фиксацией в хранилище и отметьте все синие (модифицированный) и зеленый (новых) запись для пропавших без вести Javadoc для класса. Однако этот процесс не добавит тега @author, если комментарий для класса уже существует или не обновляет существующий тег. Вот the manual.

Я не уверен в целесообразности автоматической маркировки каждого файла, который был затронут как автор того, кто его коснулся, хотя это может быть причиной того, что такая функция недоступна. Класс, который изменился на 1%, заслуживает изменения автора? Как насчет 40%? Как насчет перестановки импорта? и так далее ... Думаю, можно было бы найти альтернативное решение, например, ввести @lasteditor или несколько тегов @author или @editor, но я все еще не уверен, что это добавит большой ценности.

git blame (Team -> Show Annotations), git log и т. Д., Похоже, больше подходят для задачи отслеживания авторов и редакторов.

Одним из вариантов решения, по крайней мере, для проектов Maven, может быть javadoc:fix целью Javadoc plugin, но это только гарантировало бы, что каждый класс Javadoc имеет @author тега и ничего фантазию кроме того:

<plugin> 
    <artifactId>maven-javadoc-plugin</artifactId> 
    <groupId>org.apache.maven.plugins</groupId> 
    <version>2.10.3</version> 
    <configuration> 
     <fixTags>author</fixTags> 
     <force>true</force> 
     <fixFieldComment>false</fixFieldComment> 
     <fixMethodComment>false</fixMethodComment> 
    </configuration> 
</plugin>