为啥我不能在我的 JavaDoc 中使用 <abbr> 标记？

Posted 2023-03-30

【中文标题】为啥我不能在我的 JavaDoc 中使用 <abbr> 标记？

【英文标题】：Why can't I use the <abbr> tag in my JavaDoc?为什么我不能在我的 JavaDoc 中使用 <abbr> 标记？

【发布时间】：2017-01-02 06:31:35

【问题描述】：

我正在尝试使用 Java 8 javadoc 工具，但它抱怨 abbr 是一个未知标签：

error: unknown tag: abbr

但据我所知，它是html 4.01 spec 和HTML 5 spec 中的有效标签。

我看到有ways to disable the doclint，但我真的很想知道支持哪些标签列表（或者为什么不支持这个）。

this question、this question 和this blog post 提供更多信息。

【参考方案1】：

This is a bug，已在 JDK 9 中修复。

根据更新日志，JDK 8 中缺少以下标签：

缩写 首字母缩略词 地址 德尔 插入 kbd q s 采样 罢工

如果您必须使用这些标签之一，则需要在 JDK 8 中禁用 HTML lint。