Javadoc: разрывы строк без HTML-тегов?

Извините за возможный вопрос типа FAQ, но я просто не могу найти ответ.

Насколько я помню, Eclipse, пустая строка в комментарии Javadoc отображается (во всплывающих окнах Javadoc в исходном коде) как разрыв строки (с дополнительным вертикальным интервалом).

Однако в Netbeans это не так.

Могу ли я настроить Javadoc на интерпретацию пустой строки как разрыва строки?

Дополнительный вопрос: могу ли я переопределить поведение Netbeans по умолчанию (связанное с этим) для всплывающих окон Javadoc в исходном коде?

Я говорю о следующем:

Источник

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

Интерпретация затмения

 Paragraph One

 Paragraph Two

Интерпретация Netbeans

 Paragraph One Paragraph Two

Это не имеет ничего общего с Netbeans. Я подозреваю, что в одном случае вы смотрите на исходный код, а в другом - на вывод Javadoc. Новые строки не имеют значения в HTML: поэтому вывод не будет их отображать. Если вам нужна новая строка, используйте a <p>или <br>.

Я не уверен, помогает ли это в случае OP, однако я выложил <pre></pre>свой документ, чтобы netbean не испортил мое форматирование. Так это будет выглядеть

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

Это ближе всего к отображению новых строк в текстовом формате. Я использую NetBeans 7.1.2. Таким образом, использование code formatoption не приведет к переформатированию документа. Отображение документа в подсказках все еще отформатировано.

Обновление: в 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 не входит в исходный код. К сожалению, я не нашел особой помощи в этом поиске в Google. На самом деле это довольно просто реализовать.

Вот настраиваемый доклет, который вы можете скомпилировать и использовать:

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;
}

Я понятия не имею , что делает здесь затмение, но если вы хотите это поведение в целом (не только IDE), возможно , придется создать новый Doclet (который может быть основан на по умолчанию HTML доклета) вместо этого, там вставляя <p>в каждая пустая строка или что-то в этом роде.