我使用相同的命令用jdk 1.8和1.9生成javadoc,而doc在jdk 1.8中生成错误和警告但是没有用1.9生成。
以下是我正在使用的命令: -
C:\Program Files\Java\jdk1.8.0_05\bin>javadoc -d D:\APIdoc -sourcepath D:\MyFile\src\main\java -subpackages com.abc.dap.pqr
Output:
100 errors
100 warnings
Doc generated successfully
C:\Program Files\Java\jdk-9\bin>javadoc -d D:\APIdoc1 -sourcepath D:\MyFile\src\main\java -subpackages com.abc.dap.pqr
Output:
100 errors
Doc not generated
Below are the errors:-
error: package [package_name] does not exist
error: cannot find symbol
在jdk1.8和1.9中观察到相同的错误,但我无法理解为什么没有使用1.9生成doc。 请建议使用jdk1.9生成javadoc的解决方法
答案 0 :(得分:4)
JDK 9中的故意更改是将错误视为不可恢复并在不生成javadoc的情况下退出。这在JDK 9发行说明(http://jdk.java.net/9/release-notes#JDK-8175219)中有记录。
如评论中所述,使用旧doclet(使用-Xold)可能适用于此情况,但它不支持模块信息。此外,旧的doclet将在下一版本中删除。
答案 1 :(得分:1)
使用-Xdoclint:-<group>
关闭某些检查可能会更好运,尤其是-Xdoclint:-reference
,这将导致它忽略与Javadoc标记中对Java API元素的引用相关的问题,甚至{ {1}}关闭所有支票。如果这没有帮助,您可以使用-Xdoclint:none
调用旧版javadoc工具。
有关详细信息,请参阅-Xold
或javadoc documentation。