Yeap... podrías escribir más al respecto? Según entiendo lo rehicieron internamente para usar el API del compiler, pero no sé si eso implique cambios en la forma de uso.
Los cambios son mayormente internos como el uso (aún no completo) del API de compiler, uso de métodos más robustos para generar los HTML. También se apega a la generación de HTML válido y accesible.
Además la documentación ahora hace uso de hojas de estilo que se pueden personalizar después de generadas.
No habrá cambio alguno en la forma de invocar a javadoc (Aunque con eso de los IDEs pues sólo damos un click y listo).
Aunque se tardaron mucho en introducir modificaciones, es bueno saber que están haciendo actualizaciones (ya tienen contemplados los cambios para la próxima versión).
Nota: El cambio es en el doclet, no en las APIs generales de javadoc que no conozco para nada. Nunca he utilizado otro doclet que no sea el que viene por default.
Como hace alusión el primer comentario en ese blog, ojalá con este nuevo estilo (que también a mi me gusta) nos de ganas de escribir (más) documentación,
Yeap... podrías escribir más
Yeap... podrías escribir más al respecto? Según entiendo lo rehicieron internamente para usar el API del compiler, pero no sé si eso implique cambios en la forma de uso.
Cambios en javadoc
Los cambios son mayormente internos como el uso (aún no completo) del API de compiler, uso de métodos más robustos para generar los HTML. También se apega a la generación de HTML válido y accesible.
Además la documentación ahora hace uso de hojas de estilo que se pueden personalizar después de generadas.
No habrá cambio alguno en la forma de invocar a javadoc (Aunque con eso de los IDEs pues sólo damos un click y listo).
Y para darnos una idea de como luce, aquí está la documentación de JDK 7.
Aunque se tardaron mucho en introducir modificaciones, es bueno saber que están haciendo actualizaciones (ya tienen contemplados los cambios para la próxima versión).
Nota: El cambio es en el doclet, no en las APIs generales de javadoc que no conozco para nada. Nunca he utilizado otro doclet que no sea el que viene por default.
Un enlace con un ejemplo
Aquí otro enlace a un blog donde hacen una pruebas con el nuevo formato.
Como hace alusión el primer comentario en ese blog, ojalá con este nuevo estilo (que también a mi me gusta) nos de ganas de escribir (más) documentación,