Автоматический тег @since javadoc для релизов - PullRequest
5 голосов
/ 05 августа 2010

Существует ли инструмент для автоматического добавления тега @since ко всем элементам, когда я хочу получить версию выпуска?

Итак, допустим, у меня есть куча методов, и моя базовая система сейчас работает, поэтому я решил выпустить ее как версию 0.1.0

Теперь мне нужен инструмент, который ищет каждый отсутствующий тег @since и добавляет его соответствующим образом.

Я использую Eclipse, и я нашел JAutodoc, но, насколько я вижу, он позволяет только искать недостающие теги, и мне нужно было бы добавить их вручную.

EDIT: Один обходной путь, который может быть кому-то интересен: с самого начала используйте шаблон Eclipse с правильным тегом начиная с и после каждого выпуска меняйте шаблон.

Ответы [ 2 ]

3 голосов
/ 15 августа 2010

Это звучит как то, что должен предоставить вам ваш инструмент для сборки.Если вы используете Maven, вы должны взглянуть на javadoc: fix.Похоже, он делает именно то, что вы хотите:

http://maven.apache.org/plugins/maven-javadoc-plugin/fix-mojo.html

0 голосов
/ 15 августа 2010

Могу ли я просто добавить урок, который я узнал около 27 лет назад: не пытайтесь привести ваши контрольные номера в соответствие с номерами выпусков вашего продукта. Так лежит безумие.

...