javadoc: разрывы строк без html-тегов?

<p><em> извините за возможный вопрос типа faq, но я просто не могу найти ответ. </em></p><p>насколько я помню eclipse, пустая строка в комментарии javadoc отображается (во всплывающих окнах javadoc в исходном коде) как разрыв строки (с дополнительным вертикальным интервалом).</p><p>в netbeans, однако, это не так.</p><p><strong>могу ли я настроить javadoc для интерпретации пустой строки как перенос строки?</strong></p><p><strong>дополнительный вопрос: можно ли переопределить поведение netbeans по умолчанию (связанное с этим) для всплывающих окон javadoc в исходном коде?</strong></p><p>то, о чем я говорю, это:</p><h2>источник</h2><pre><code>/** * paragraph one * * paragraph two */ void somemethod() { } </code></pre><h2>затмение интерпретации</h2><pre><code> paragraph one paragraph two </code></pre><h2>интерпретация netbeans</h2><pre><code> paragraph one paragraph two </code></pre>

<p>это не имеет ничего общего с netbeans. я подозреваю, что вы смотрите на исходный код в одном случае и вывод javadoc в другом случае. новые строки не имеют значения в html: <em>ergo</em> вывод не будет их отображать если вы хотите новую строку, используйте <code><p></code> или <code><br></code>.</p>

<p>я не уверен, поможет ли это в случае с op, но я поставил <code><pre></pre></code> вокруг моего документа, чтобы netbean не испортило мое форматирование. так будет выглядеть</p><pre><code>/** * <pre> * paragraph one * * paragraph two * </pre> */ </code></pre><p>это ближе всего я показываю новые строки в текстовом формате. я использую netbeans 7.1.2. таким образом, использование опции <code>code format</code> не переформатирует документ. показ документа в подсказках все еще отформатирован.</p><p>обновление: в netbeans 8.x в форматировании кода есть возможность отключить форматирование комментариев.</p>

<p>в <code>netbeans</code> уже есть опция, протестированная на версии 8.2, которая позволяет сохранять новые строки в комментариях и/или добавлять тег <code><p></code> к вашему <code>javadoc</code> при необходимости.</p><ul> <li>просто из меню <code>tools</code> выберите <code>options</code></li> <li>перейдите на вкладку <code>editor</code>, затем на вкладку <code>formatting</code></li> <li>в меню <code>language</code> выбрал <code>java</code>, а в меню <code>category</code> выбрал <code>comments</code></li> <li>установите флажок <code>preserve new lines</code> в разделе <code>general</code>, если вы хотите сохранить новые строки в ваших комментариях. <strong> это сохранит новые строки без добавления тега <code><p></code> </strong></li> <li>установите флажок <code>generate "<p>" on blank lines</code> в разделе <code>javadoc</code> <strong>, если вы также хотите добавить тег <code><p></code> </strong>.</li> </ul><p> <a href="https://i.stack.imgur.com/yfeck.png"><img src="https://i.stack.imgur.com/yfeck.png" alt="enter image description here"></a> </p>

<p>я согласен с вами, html не входит в исходный код. к сожалению, я не нашел особой помощи, погугливая по этому поводу. это на самом деле довольно легко реализовать.</p><p>вот пользовательский doclet, который вы можете скомпилировать и использовать:</p><pre><code>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); } } </code></pre><p>пример того, как вызвать его, используя javadoc:</p><pre><code>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 </code></pre>

<p>javadoc отображает способ определения стилей css. вы можете отредактировать стили css, связанные с тегами абзаца, чтобы сделать это:</p><pre><code>p { line-height: 25px; } </code></pre>

<p>это псевдо-решение<br> (что, к сожалению, влияет только на сгенерированный javadoc, но <strong>не</strong> влияет на отображение javadoc в netbeans).</p><p>укажите таблицу стилей, которая содержит следующее:</p><pre><code>div.block { white-space: pre; } </code></pre>

<p>я понятия не имею, что здесь делает eclipse, но если вам нужно такое поведение в целом (не только в ide), вам, возможно, придется создать новый doclet (который может быть основан на html-доклете по умолчанию), вставив туда <code><p></code> на каждой пустой строке или тому подобное.</p>