在Javadoc中哪个标签应该用作段落分隔符?
因此,根据最佳做法,更合适的HTML标记用于分解javadoc的段落/长节?
是<p />
还是<br />
?为什么?
回答:
欢迎来到HTML 3.2领域。
根据编写文档注释的官方指南,分隔段落的正确方法是使用段落标签:<P>
。看一下“
文档注释的格式
”部分中的第七个项目符号。
通常,我强烈建议您不要使用这种过时的,过时的做法进行标记。但是,在这种情况下,有充分的理由例外。Javadoc工具(除非使用自定义Doclet进行彻底更新)会生成旧的,笨拙的,有点破损的标记。浏览器被构建为与当今疯狂的旧标记向后兼容,因此您可以随心所欲地进行浏览。您使用<P>
分隔段落将与其余Javadoc输出保持一致。
以上是 在Javadoc中哪个标签应该用作段落分隔符? 的全部内容, 来源链接: utcz.com/qa/410122.html