Javadoc：没有HTML标记的换行符？

对不起，可能是常见问题，但我只是找不到答案。

据我所记得的Eclipse，Javadoc注释中的空白行显示为（在源Javadoc弹出窗口中）作为换行符（具有额外的垂直间距）。

但是，在Netbeans中并非如此。

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

附加问题：我可以为源Javadoc弹出窗口覆盖默认的Netbeans行为（与此相关）吗？

我在说的是：

资源

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

Eclipse解释

 Paragraph One

 Paragraph Two

Netbeans解释

 Paragraph One Paragraph Two

它与Netbeans无关。我怀疑您在一种情况下正在查看源代码，而在另一种情况下正在查看Javadoc的输出。换行符在HTML中并不重要：ergo输出不会显示它们。如果要换行，请使用<p>或<br>。

我不确定这是否对OP有用，但是我放好<pre></pre>了文档，因此netbean不会弄乱我的格式。所以看起来像

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

这是我最接近以文本格式显示新行的方法。我正在使用NetBeans 7.1.2。这种使用code formatoption的方式不会重新格式化文档。在提示中显示doc仍被格式化。

更新：在Netbeans 8.x中，代码格式化中有一个选项可以禁用格式化注释。

中已经有一个选项NetBeans-在8.2版中经过测试-可让您保留注释中的新行，和/或在需要时添加<p>标签Javadoc

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

我同意您的意见，HTML不属于源代码。可悲的是，我没有在谷歌搜索周围找到太多帮助。实际上很容易实现。

这是您可以编译和使用的自定义Doclet：

import com.sun.javadoc.*;
import com.sun.tools.doclets.standard.*;

/**
 * Formats text-only comments with HTML.
 */
@SuppressWarnings("restriction")
public final class TextDoclet {
    private static final Pattern NEWLINE_REGEX = Pattern.compile("\\n");
    private static final String BR = "<br/>\n";

    public static boolean start(RootDoc rootDoc) {
        for ( ClassDoc classdoc : rootDoc.classes())
            classdoc.setRawCommentText(formatText(classdoc.getRawCommentText()));

        return Standard.start(rootDoc);     
    }

    private static String formatText(String text) {
        return NEWLINE_REGEX.matcher(text).replaceAll(BR);
    }
}

如何使用javadoc调用它的示例：

javadoc -docletpath ~/project/text-doclet/target/text-doclet-1.0.0-SNAPSHOT.jar -doclet com.myorg.textdoclet.TextDoclet -sourcepath ~/project/myapp/src/main/java -subpackages com.myorg.myapp

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

p {
    line-height: 25px;
}

这是一个伪溶液
（其可悲仅影响生成的Javadoc，但并没有在源极的Javadoc显示影响Netbeans的）。

指定一个包含以下内容的样式表：

div.block {
    white-space: pre;
}

我不知道Eclipse在这里做什么，但是如果您想要一般的行为（不仅是IDE），您可能不得不创建一个新的Doclet（它可能基于默认的HTML doclet），而是<p>在其中插入一个每个空行等。