JavaDoc预格式化的文本块中允许<sub>和<sup>吗?

时间:2019-12-19 08:48:54

标签: java javadoc maven-javadoc-plugin

我想在JavaDoc中使用<sub><sup>以获得更好的格式。但是,看来JavaDoc正在努力解决这些问题。至少maven-javadoc-plugin充满了此类警告消息。 Java 11应该仍然支持<sub><sup>。似乎不喜欢<sub>元素中的<pre>

这里有个例子:

[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>)

在我完全忽略它之前(因为它不会阻止我释放它),我想问一下在文本为pre之前是否有一个不错的技巧可以使用元素<sub><sup>格式并被JavaDoc接受?

侧注:

  • Java:JDK11
  • 插件:maven-javadoc-plugin(通过maven-release-plugin)

enter image description here

1 个答案:

答案 0 :(得分:0)

自JDK 9起允许使用标签<sub><sup>,因此您只需要升级JDK以及可能的源代码级别。

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