2010-08-05 18 views
5

¿Existe alguna herramienta para agregar automáticamente la etiqueta @since a todos los elementos cuando deseo tener una versión de lanzamiento?Etiqueta @since javadoc automática para las versiones

Así que vamos a decir que tengo un montón de métodos y mi sistema base está trabajando ahora, así que deciden liberarla en forma de versión 0.1.0

Lo que quiero ahora es una herramienta que busca para cada @since falta etiquetar y lo agrega en consecuencia.

Estoy usando Eclipse y he encontrado JAutodoc, pero hasta donde puedo ver, solo permite buscar las etiquetas faltantes y tendría que agregarlas manualmente.

EDIT: Una solución que podría ser interesante para alguien: desde el principio, utilice una plantilla de Eclipse con la etiqueta right since y después de cada lanzamiento cambie la plantilla.

+0

Gran pregunta. – whiskeysierra

Respuesta

3

Esto suena como algo que su herramienta de compilación debería proporcionarle. Si está utilizando maven, debería echar un vistazo a javadoc: corregir. Parece que hace exactamente lo que quiere:

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

+0

Intenté investigar a maven hace un tiempo. Al principio parecía muy prometedor y todavía lo hace. Pero hasta ahora nunca logré que funcionara. De todos modos, a partir del próximo mes espero tener más tiempo y volveré a echar un vistazo. ¡Así que gracias hasta ahora! – Mene

0

¿Puedo añadir una lección que aprendí hace unos 27 años: no trate de hacer que sus números de control de versión se alinean con sus números de versión del producto. De esa manera, la locura miente.

+0

Bueno, el problema es: si su API es pública y otras lo están usando y tiene lanzamientos diferentes y no todos tienen lo último, entonces es bueno que la gente sepa si pueden usar un método específico o no. ¿O tienes una mejor solución? Siempre estoy abierto; D – Mene

Cuestiones relacionadas