Javadoc:没有HTML标签的换行符？

Question

对不起有一个可能的FAQ问题,但我找不到答案.

据我记得Eclipse,Javadoc注释中的空行显示(在源代码中的Javadoc弹出窗口中)作为换行符(具有额外的垂直间距).

然而,在Netbeans中,情况并非如此.

我可以配置Javadoc将空行解释为换行符吗？

其他问题:我可以覆盖源内Javadoc弹出窗口的默认Netbeans行为(与此相关)吗？

我在说的是:

资源

/**
 * Paragraph One
 *
 * Paragraph Two
 */
 void someMethod() { }

Eclipse解释

 Paragraph One

 Paragraph Two

Netbeans解释

 Paragraph One Paragraph Two

Answer 1

它与Netbeans无关.我怀疑你在一个案例中查看源代码,在另一个案例中查看Javadoc的输出.HTML中的换行符并不重要:ergo输出不会显示它们.如果你想换行使用a <p>或a <br>.

Answer 2

我不确定这对OP的情况是否有帮助,但是我放<pre></pre>了我的文档,所以netbean不会弄乱我的格式.所以它看起来像

/**
 * <pre>
 * Paragraph One
 *
 * Paragraph Two
 * </pre>
 */

这是最接近我以文本格式显示新行.我正在使用NetBeans 7.1.2.这种方式使用code format选项不会重新格式化文档.显示提示中的文档仍然是格式化的.

更新:在Netbeans 8.x中,代码格式化中有一个选项可禁用格式化注释.

Answer 3

NetBeans在版本8.2中已经有一个选项- 允许您在评论中保留新行,和/或在需要时添加<p>标记Javadoc

• 从Tools菜单中选择Options
• 转到Editor选项卡,然后Formatting选项卡
• 在"语言"菜单中选择Language,然后在"类别"菜单中选择Java
• 如果要在注释中保留新行,请Category选中该Comments部分中的复选框.这将保留新行而不添加Preserve New Lines标记
• 如果您还想添加标记,请General选中该<p>部分中的复选框.Generate "<p>" on Blank Lines

Answer 4

JavaDoc 显示 CSS 样式的定义方式。您可以编辑与段落标签关联的 CSS 样式来执行此操作：

p {
    line-height: 25px;
}