在Javadoc中哪个标签应该用作段落分隔符?

因此,根据最佳做法,更合适的HTML标记用于分解javadoc的段落/长节?

<p /> 还是<br />?为什么?

回答:

欢迎来到HTML 3.2领域。

根据编写文档注释的官方指南,分隔段落的正确方法是使用段落标签:<P>。看一下“

文档注释的格式

”部分中的第七个项目符号。

通常,我强烈建议您不要使用这种过时的,过时的做法进行标记。但是,在这种情况下,有充分的理由例外。Javadoc工具(除非使用自定义Doclet进行彻底更新)会生成旧的,笨拙的,有点破损的标记。浏览器被构建为与当今疯狂的旧标记向后兼容,因此您可以随心所欲地进行浏览。您使用<P>分隔段落将与其余Javadoc输出保持一致。

以上是 在Javadoc中哪个标签应该用作段落分隔符? 的全部内容, 来源链接: utcz.com/qa/410122.html

回到顶部