修复 Javadoc 错误 Java 8

Question

我正在尝试将现有应用程序的 javadoc 编辑为 Java-8 兼容。我不想跳过检查错误。我想修理它们。我对 HTML 标签感到困惑，即：

<code></code>
<ul></ul>
<li></li>
<ol></ol>

我知道我可以将 @code 用于 <code></code> 等，但是有很多 HTML 标签，根据 javadoc 不允许使用它们。我试图逃避他们，即：

&lt;code&gt;&lt;/code&gt;
&lt;ul&gt;&lt;/ul&gt;
&lt;li&gt;&lt;/li&gt;
&lt;ol&gt;&lt;/ol&gt;

但是它们像往常一样在 Javadoc 中作为文本打印，而不是作为 HTML 标签打印。我可以看到它在 Javadoc.

的相应位置写了 <code></code>

如何修复 Javadoc at Java 8 的此类错误？

Answer 1

Javadoc 在 Java 8 检查有效的 HTMLs。因此，您不需要转义任何内容，只需遵守有效 HTML 的规则风格。

Fixing Javadoc Errors for Java 8