javadoc不是用jdk 1.9生成的,而是用jdk 1.8

时间:2017-08-28 18:48:32

标签: java-8 javadoc java-9

我使用相同的命令用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的解决方法

2 个答案:

答案 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工具。

有关详细信息,请参阅-Xoldjavadoc documentation