如何确保隐式换行符反映在输出Javadoc中,即换行符转换为<br/>
标签?我发现必须记住在我的评论的每一行添加<br/>
标签,这非常烦人。当然,如果没有<br/>
标签,整个评论会被压缩成一个不可读的块。
也许是一个只用<br/>
代码替换换行符的doclet?我用Google搜索了一下,但没有想出任何东西。在我开始编写自己的doclet之前,我想确保自己没有错过任何内容。
答案 0 :(得分:1)
最好是在需要分段符的位置插入<p>
标记。在你想要换行的地方放置一个换行线是非常难看的 - 当有人使用比你突破的窗口宽得多或窄得多的窗口时,这种做法很糟糕。
注意:如果您要将预先格式化的文本包含在JavaDoc中,则可以在此内容周围使用<pre>
标记,并且不会将文本重新格式化为一个巨大的blob。实际上,如果您想明确决定每个换行符的位置,可以在整个JavaDoc周围使用<pre>
标记,尽管这是滥用此标记的意图。