martes
oct122010
Doclava para los que estéis cansados de la salida de javadoc
martes, octubre 12, 2010 at 6:31PM
Parece que los chicos de Google no utilizan el javadoc normal. Doclava es un proyecto que se configura como un doclet de javadoc y permite generar una salida más elegante (ver como ejemplo el API de Guice y el de Android), aparte de otras funcionalidades extra.
En concreto a mí me gana la posibilidad (mediante @sample) de insertar en la documentación snippets de código extraidos de los fuentes (hasta ahora sólo había visto esto en Rails y Gradle, y es una gozada). Imagina poder incluir un ejemplo de uso del API sacado directamente de la batería de pruebas.
El proyecto lleva desde Julio de 2010 y todavía no tiene descargables, aunque puede descargarse este jar presente entre las librerías de Guice.
in j2se
Reader Comments