accidentalmente puedo olvidar para describir algunos parámetros o lanzar una excepción (o algo más) para la catalogación de los métodos o clases, etc.¿Es posible obtener advertencias de javadoc cuando algo se perdió en javadoc-comments?
¿Es posible ejecutar javadoc de tal manera que me advierte sobre los elementos que faltan de documentación?
(yo uso la escritura de hormigas para la generación de documentación)
Use Checkstyle! Tiene una asombrosa integración Ant y también soporta cientos de otras comprobaciones importantes para su código fuente.
El JavadocType checker es lo que necesitarás sin embargo.
No sé de cualquier opción de javadoc que emitirá una advertencia acerca de los elementos no documentados.
Sin embargo, si quieres pasar a utilizar Eclipse, echar un vistazo a la configuración en
Ventana -> Preferencias -> Java -> Generador -> Javadoc
ahí, se puede decir Eclipse para emitir advertencias en artículos indocumentados.
Sí, es decir, en Eclipse ha incorporado control para todo lo que defina, por lo que es posible poner esto como "advertencias" y de lo que podrá ver dónde comete errores.
Usamos Doc Check Doclet para un proyecto anterior. Se puede integrar con la construcción y genera informes útiles que le dicen qué código tiene poca documentación.
NOTA: la herramienta es beta y ya no es compatible con Sun.
La misma respuesta en el mismo tiempo;) Eclipse es la madre del desarrollo de Java ...;) – vaske
Gracias, esto es útil, pero no es exactamente lo que necesito. Me gustaría tener alguna herramienta de línea de comandos, si javadoc no permite hacer lo que necesito. – sergtk