Améliorations de Javadoc dans Java 9
Nouveautés de Java 9L'outil javadoc peut générer de la documentation Java. Dans Java 9, la sortie de javadoc est désormais conforme au standard compatible HTML5.
Documentation des anciennes versions antérieures à Java 9
Considérez le code du fichier suivant C:/JAVA/Tester.java :
Exemple
Utilisez javadoc du JDK 7 pour générer la documentation :
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...
L'exécution de la commande ci-dessus générera une page de documentation dans C:/JAVA, comme le montre la figure ci-dessous :
La documentation générée par Java 9 est compatible avec la norme HTML5
L'utilisation du paramètre-html5de la commande javadoc du JDK 9 peut permettre à la documentation générée de prendre en charge la norme HTML5 :
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...
L'exécution de la commande ci-dessus générera une page de documentation dans C:/JAVA, comme le montre la figure ci-dessous :
