和 在 JavaDoc 预格式化文本块中允许吗？ [复制]答案

【问题标题】： and allowed in JavaDoc pre-formatted text block? [duplicate] 和 在 JavaDoc 预格式化文本块中允许吗？ [复制]
【发布时间】：2020-04-11 20:04:17
【问题描述】：

我想在 JavaDoc 中使用  和  以获得更好的格式。然而，JavaDoc 似乎在与这些元素作斗争。至少 maven-javadoc-plugin 充斥着这样的警告信息。 Java 11 无论如何都应该支持 和。似乎它不喜欢<pre>element 中的。

这里是一个例子：

[INFO] /knx-link/target/checkout/knx-core/src/main/java/li/pitschmann/knx/core/datapoint/DPT19.java:50: error: tag not allowed here: <sub>
[INFO]  * Format:     8 octets (U<sub>8</sub> [r<sub>4</sub>U<sub>4</sub>] [r<sub>3</sub>U<sub>5</sub>] [r<sub>3</sub>U<sub>5</sub>] [r<sub>2</sub>U<sub>6</sub>] [r<sub>2</sub>U<sub>6</sub>] B<sub>16</sub>)

在我完全忽略它之前（因为它不会阻止我发布它）我想问一下是否有一个很好的技巧可以使用元素  和  而文本是预先格式化的并且是JavaDoc 接受了吗？

旁注：

Java：JDK11
插件：maven-javadoc-plugin（通过 maven-release-plugin）

【问题讨论】：

版主，能否请您重新打开这个问题。它不应该被标记为重复，因为 Java 11 无论如何都支持 _{和 ^{。意思是，这个问题是一个完全不同的问题。}}

标签： java javadoc maven-javadoc-plugin

【解决方案1】：

标签  和  自 JDK 9 起允许使用，因此您只需要升级 JDK，可能还需要升级源代码级别。

这里是代码：http://hg.openjdk.java.net/jdk/jdk/annotate/68adcd2fbc6b/src/jdk.compiler/share/classes/com/sun/tools/doclint/HtmlTag.java#l310

【讨论】：

我正在使用 OpenJDK 11（并且还在 maven 中配置为使用 Java 11 作为源/目标级别）。我想应该已经好了。
可能JavaDoc不喜欢/里面的<pre>？