当前位置:首页 > JAVA教程 > JAVA基础

Java 9 改进 Javadoc

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)!