Java 8 javadoc doclint 功能“此处不允许标记”

Posted 2023-03-30

【中文标题】Java 8 javadoc doclint 功能“此处不允许标记”

【英文标题】：Java 8 javadoc doclint feature 'tag not allowed here'

【发布时间】：2016-02-03 10:59:40

【问题描述】：

我最近将我的项目从 Java 7 升级到 8。由于 javadoc 的 doclint 功能，我偶然发现了一些错误。 错误：此处不允许标记：

java文件中的html标签：

<a name="ThpSslEnabled"></a>

我尝试检查锚标记是否符合 W3C HTML 标准，但没有找到任何有用的东西。

【问题讨论】：

您能粘贴包含错误的完整 javadoc 块吗？

【参考方案1】：

您是否使用 Maven 或任何其他构建软件？

DocLint 在 Java 8 中默认启用，并且会在生成 Javadocs 之前运行大量检查。您需要为 Java 8 关闭此功能。

检查这个答案： Maven is not working in Java 8 when JavaDoc tags are incomplete

<properties>
    <additionalparam>-Xdoclint:none</additionalparam>
</properties>

【讨论】：

我正在使用 gradle，目前我正在通过关闭 doclint 来抑制错误，但想修复错误。

如何在 gradle 中关闭它？