Java9-improved-javadocs

Java 9-JavaDocsの改善

Javadocは、javadocツールを使用して生成できます。 現在、HTML 4.0形式のドキュメントを生成します。 Java 9では、コマンドライン引数で-html5オプションを使用して、html 5形式のドキュメントを生成できます。

古いスタイルのJavaドキュメント

C：/JAVAフォルダーの次のコードを検討してください。

Tester.java

/**
 *@author MahKumar
 * @version 0.1
*/
public class Tester {
  /**
 *Default method to be run to print
     * <p>Hello world</p>
 *@param args command line arguments
  */
   public static void main(String []args) {
      System.out.println("Hello World");
   }
}

ここで、jdk 7のjavadocツールを実行してドキュメントを生成します。

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\Testerl...
Generating C:\JAVA\package-framel...
Generating C:\JAVA\package-summaryl...
Generating C:\JAVA\package-treel...
Generating C:\JAVA\constant-valuesl...
Building index for all the packages and classes...
Generating C:\JAVA\overview-treel...
Generating C:\JAVA\index-alll...
Generating C:\JAVA\deprecated-listl...
Building index for all classes...
Generating C:\JAVA\allclasses-framel...
Generating C:\JAVA\allclasses-noframel...
Generating C:\JAVA\indexl...
Generating C:\JAVA\help-docl...

C：/JAVAディレクトリにjavaドキュメントページが作成され、次の出力が表示されます。

javadoc output

検索とHTML5をサポートする新しいJavaドキュメント

-html5フラグを指定してjdk 9のjavadocツールを実行し、新しいタイプのドキュメントを生成します。

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\Testerl...
Generating C:\JAVA\package-framel...
Generating C:\JAVA\package-summaryl...
Generating C:\JAVA\package-treel...
Generating C:\JAVA\constant-valuesl...
Building index for all the packages and classes...
Generating C:\JAVA\overview-treel...
Generating C:\JAVA\index-alll...
Generating C:\JAVA\deprecated-listl...
Building index for all classes...
Generating C:\JAVA\allclasses-framel...
Generating C:\JAVA\allclasses-framel...
Generating C:\JAVA\allclasses-noframel...
Generating C:\JAVA\allclasses-noframel...
Generating C:\JAVA\indexl...
Generating C:\JAVA\help-docl...

D：/testディレクトリに更新されたJavaドキュメントページが作成され、次の出力が表示されます。

java 9でのjavadoc出力