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には重要ではありません：エルゴ出力は、それらを表示されません。改行が必要な場合は、<p>またはを使用します<br>。

これがOPの場合に役立つかどうか<pre></pre>はわかりませんが、netbeanがフォーマットを台無しにしないように、ドキュメントを整理しました。だからそれは次のようになります

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

これは、新しい行をテキスト形式で表示するのに最も近い方法です。NetBeans7.1.2を使用しています。このようにcode formatオプションを使用しても、ドキュメントは再フォーマットされません。ヒントでドキュメントを表示することはまだフォーマットされています。

更新：Netbeans 8.xには、コメントのフォーマットを無効にするオプションがコードフォーマットにあります。

NetBeansコメントに新しい行を保持<p>したりJavadoc、必要に応じてタグを追加したりできるオプションがすでにあります（バージョン8.2でテスト済み）。

• Toolsメニューから、Options
• Editorタブに移動し、次にFormattingタブ
• でLanguageメニューを選んだJava、としてCategoryメニューを選びましたComments
• コメントの新しい行を保持する場合Preserve New Linesは、Generalセクションのチェックボックスをオンにします。これにより、<p>タグを追加せずに新しい行が保持されます
• タグも追加する場合Generate "<p>" on Blank Linesは、Javadocセクションのチェックボックスをオンにします。<p>

私はあなたに同意します、HTMLはソースコードに属していません。悲しいことに、私はこれについてグーグルで回る助けをあまり見つけられませんでした。実際、実装は非常に簡単です。

コンパイルして使用できるカスタムドックレットは次のとおりです。

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にのみ影響しますが、Netbeansのソース内のjavadoc表示には影響しません）。

以下を含むスタイルシートを指定します。

div.block {
    white-space: pre;
}

私は、Eclipseがここで何をしているのか分からないが、あなたは一般的な（だけではなくIDE）でこの動作をしたい場合は、代わりに、そこに挿入する（デフォルトHTMLドックレットに基づいていてもよい）、新しいドックレットを作成する必要があります<p>でのすべての空の行など。