javadoc 不是用 jdk 1.9 生成的，而是用 jdk 1.8 生成的答案

【问题标题】：javadoc not generated with jdk 1.9 but getting generated with jdk 1.8javadoc 不是用 jdk 1.9 生成的，而是用 jdk 1.8 生成的
【发布时间】：2018-02-06 02:37:06
【问题描述】：

我使用相同的命令生成带有 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 中观察到相同的错误，但我无法理解为什么 doc 不是用 1.9 生成的。请建议使用 jdk1.9 生成 javadoc 的解决方法

【问题讨论】：

也许 JDK 9 变得更严格了？您是否尝试过修复错误（即使只是通过删除有问题的文件）并查看会发生什么？
您是否尝试过使用-Xdoclint:-<group> 或-Xdoclint:none 关闭某些检查？如果这没有帮助，您可以使用 -Xold 调用旧版 javadoc 工具。请参阅javadoc -X 了解更多信息。
@DavidConrad 你应该把它变成一个答案。
@DavidConard 谢谢，-Xold 工作正常，请忽略最后一条评论
@SNEHALGUPTA 使用 Java 9，您能否分享完整的错误日志。此外，仅出于洞察力docs.oracle.com/javase/9/whatsnew/… 应该可以帮助您弄清楚在生成方面发生了什么变化。您可能想深入了解taglet 和module system 的解释。

标签： java-8 javadoc java-9

【解决方案1】：

在 JDK 9 中有意将错误视为不可恢复并退出而不生成 javadoc。这记录在 JDK 9 发行说明 (http://jdk.java.net/9/release-notes#JDK-8175219) 中。

如 cmets 中所述，使用旧 doclet（带有 -Xold）可能适用于这种情况，但它不支持模块信息。旧的 doclet 也将在下一个版本中删除。

【讨论】：

【解决方案2】：

通过使用-Xdoclint:-<group> 关闭某些检查，您可能会获得更好的运气，尤其是-Xdoclint:-reference，这将导致它忽略与Javadoc 标签中对Java API 元素的引用相关的问题，甚至-Xdoclint:none关闭所有支票。如果这没有帮助，您可以使用 -Xold 调用旧版 javadoc 工具。

请参阅javadoc -X 或javadoc documentation 了解更多信息。

【讨论】：

在 Java 10+ 中不再有 -Xold 选项。是否有任何忽略错误的新选项组合，例如我试图为其创建 javadocs 的源文件中不存在的类和包？旧工具报告完全相同的错误和警告，但仍会继续生成 HTML 文件，生成的 Javadoc 工作得非常好，当然，除了缺少的类不能“点击”。
@kriegaex 我刚刚使用 JDK 17 进行了尝试，它仍然会生成 HTML 文件，即使它在我创建的测试中报告了一些错误和警告。你用的是什么版本？
我在写评论时使用了 9 到 16 之间的所有内容。警告本来可以，但错误意味着我的 Maven 构建失败。据我记得，在我的案例中也没有生成文件，但我不记得 100%。