Java 9: Generar JavaDocs HTML5 con la Herramienta Javadoc

La documentación de Java se puede generar usando la herramienta javadoc. Actualmente genera documentación en formato HTML 4.0. En Java 9, podemos generar documentación en formato HTML 5 usando la opción -html5 en los argumentos de línea de comandos.

Documentación Java Estilo Antiguo

Considera el siguiente código en la carpeta C:/JAVA.

Tester.java

/**
 * @author MahKumar
 * @version 0.1
 */
public class Tester {
    /**
     * Método por defecto para ejecutar e imprimir
     * <p>Hola mundo</p>
     * @param args argumentos de línea de comandos
     */
    public static void main(String[] args) {
        System.out.println("Hola Mundo");
    }
}

Ahora ejecuta la herramienta javadoc de jdk 7 para generar documentación.

C:\JAVA>javadoc -d C:/JAVA Tester.java
Loading source file tester.java...
Constructing Javadoc information...
Standard Doclet version 1.7.0_21
Building tree for all the packages and classes...
Generating C:\JAVA\Tester.html...
Generating C:\JAVA\package-frame.html...
Generating C:\JAVA\package-summary.html...
Generating C:\JAVA\package-tree.html...
Generating C:\JAVA\constant-values.html...
Building index for all the packages and classes...
Generating C:\JAVA\overview-tree.html...
Generating C:\JAVA\index-all.html...
Generating C:\JAVA\deprecated-list.html...
Building index for all classes...
Generating C:\JAVA\allclasses-frame.html...
Generating C:\JAVA\allclasses-noframe.html...
Generating C:\JAVA\index.html...
Generating C:\JAVA\help-doc.html...

Creará la página de documentación Java en el directorio C:/JAVA y verás la siguiente salida.

Nueva Documentación Java con Búsqueda y Soporte HTML5

Ejecuta la herramienta javadoc de jdk 9 con la bandera -html5 para generar el nuevo tipo de documentación.

C:\JAVA> javadoc -d C:/JAVA -html5 Tester.java
Loading source file Tester.java...
Constructing Javadoc information...
Standard Doclet version 9.0.1
Building tree for all the packages and classes...
Generating C:\JAVA\Tester.html...
Generating C:\JAVA\package-frame.html...
Generating C:\JAVA\package-summary.html...
Generating C:\JAVA\package-tree.html...
Generating C:\JAVA\constant-values.html...
Building index for all the packages and classes...
Generating C:\JAVA\overview-tree.html...
Generating C:\JAVA\index-all.html...
Generating C:\JAVA\deprecated-list.html...
Building index for all classes...
Generating C:\JAVA\allclasses-frame.html...
Generating C:\JAVA\allclasses-frame.html...
Generating C:\JAVA\allclasses-noframe.html...
Generating C:\JAVA\allclasses-noframe.html...
Generating C:\JAVA\index.html...
Generating C:\JAVA\help-doc.html...

Creará la página de documentación Java actualizada en el directorio D:/test y verás la siguiente salida.