java 9 改进 javadoc
javadoc 工具可以生成 java 文档, java 9 的 javadoc 的输出现在符合兼容 html5 标准。
java 9 之前的旧版本文档
考虑以下文件代码 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:javatester.html... generating c:javapackage-frame.html... generating c:javapackage-summary.html... generating c:javapackage-tree.html... generating c:javaconstant-values.html... building index for all the packages and classes... generating c:javaoverview-tree.html... generating c:javaindex-all.html... generating c:javadeprecated-list.html... building index for all classes... generating c:javaallclasses-frame.html... generating c:javaallclasses-noframe.html... generating c:javaindex.html... generating c:javahelp-doc.html...
执行以上命令会再 c:/java 命令下生成文档页面,如下图所示:

java 9 生成的文档兼容 html5 标准
使用 jdk 9 javadoc 命令中的 -html5 参数可以让生成的文档支持 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:javatester.html... generating c:javapackage-frame.html... generating c:javapackage-summary.html... generating c:javapackage-tree.html... generating c:javaconstant-values.html... building index for all the packages and classes... generating c:javaoverview-tree.html... generating c:javaindex-all.html... generating c:javadeprecated-list.html... building index for all classes... generating c:javaallclasses-frame.html... generating c:javaallclasses-frame.html... generating c:javaallclasses-noframe.html... generating c:javaallclasses-noframe.html... generating c:javaindex.html... generating c:javahelp-doc.html...
执行以上命令会再 c:/java 命令下生成文档页面,如下图所示:

【说明】:本文章由站长整理发布,文章内容不代表本站观点,如文中有侵权行为,请与本站客服联系(QQ:254677821)!