blocks|key|3201043|text|JavaDoc显示定义CSS样式的方式。您可以编辑与段落标签关联的CSS样式来执行以下操作：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|3201044|p+{
++++line-height:+25px;
}|code-block|syntax|javascript|3201045|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

JavaDoc displays the way the CSS styles have been defined. You could edit the CSS styles associated with paragraph tags to do this:

<pre><code>p {
 line-height: 25px;
}
</code></pre>

blocks|key|2987560|text|它与Netbeans没有任何关系。我怀疑您在一种情况下查看源代码，在另一种情况下查看Javadoc的输出。换行符在HTML中不重要:因此，输出不会显示它们。如果需要换行符，请使用或 。|type|unstyled|depth|inlineStyleRanges|offset|length|style|CODE|entityRanges|data|2987561|entityMap^0|2H|3|2L|4|0^^$0|@$1|2|3|4|5|6|7|H|8|@$9|I|A|J|B|C]|$9|K|A|L|B|C]]|D|@]|E|$]]|$1|F|3|-4|5|6|7|M|8|@]|D|@]|E|$]]]|G|$]]

It has nothing to do with Netbeans. I suspect you are looking at the source code in one case and the output of Javadoc in the other case. Newlines are not significant in HTML: ergo the output will not show them. If you want a newline use a <code>&lt;p&gt;</code> or a <code>&lt;br&gt;</code>.

blocks|key|3201208|text|这是一个伪解|type|unstyled|depth|inlineStyleRanges|entityRanges|data|3201209|(遗憾的是，这只影响生成的javadoc，但不会影响的源代码内javadoc显示)。|offset|length|style|BOLD|3201210|指定包含以下内容的样式表：|3201211|div.block+{
++++white-space:+pre;
}|code-block|syntax|javascript|3201212|entityMap^0|0|M|4|0|0|0^^$0|@$1|2|3|4|5|6|7|Q|8|@]|9|@]|A|$]]|$1|B|3|C|5|6|7|R|8|@$D|S|E|T|F|G]]|9|@]|A|$]]|$1|H|3|I|5|6|7|U|8|@]|9|@]|A|$]]|$1|J|3|K|5|L|7|V|8|@]|9|@]|A|$M|N]]|$1|O|3|-4|5|6|7|W|8|@]|9|@]|A|$]]]|P|$]]

This is a pseudo-solution 
(which sadly affects only generated javadoc, but does not affect Netbeans' in-source javadoc display).

Specify a stylesheet which contain the following:

<pre><code>div.block {
 white-space: pre;
}
</code></pre>

blocks|key|277067|text|我不知道Eclipse在这里做什么，但是如果你想要这种行为(不仅仅是集成开发环境)，你可能必须创建一个新的Doclet+(它可能基于默认的HTML+doclet)，在那里在每个空行插入一个。|type|unstyled|depth|inlineStyleRanges|offset|length|style|CODE|entityRanges|data|277068|entityMap^0|2M|3|0^^$0|@$1|2|3|4|5|6|7|H|8|@$9|I|A|J|B|C]]|D|@]|E|$]]|$1|F|3|-4|5|6|7|K|8|@]|D|@]|E|$]]]|G|$]]

I have no idea what Eclipse is doing here, but if you want this behavior in general (not only an IDE), you may have to create a new Doclet (which may be based on the default HTML doclet) instead, there inserting a <code>&lt;p&gt;</code> at every empty line or such.

blocks|key|282700|text|我同意你的观点，HTML不属于源代码。遗憾的是，我在谷歌上找不到太多的帮助。它实际上很容易实现。|type|unstyled|depth|inlineStyleRanges|entityRanges|data|282701|下面是您可以编译和使用的自定义Doclet：|282702|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+=+" \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-block|syntax|javascript|282703|下面是如何使用javadoc调用它的示例：|282704|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|282705|entityMap^0|0|0|0|0|0^^$0|@$1|2|3|4|5|6|7|O|8|@]|9|@]|A|$]]|$1|B|3|C|5|6|7|P|8|@]|9|@]|A|$]]|$1|D|3|E|5|F|7|Q|8|@]|9|@]|A|$G|H]]|$1|I|3|J|5|6|7|R|8|@]|9|@]|A|$]]|$1|K|3|L|5|F|7|S|8|@]|9|@]|A|$G|H]]|$1|M|3|-4|5|6|7|T|8|@]|9|@]|A|$]]]|N|$]]

I agree with you, HTML doesn't belong in source-code. Sadly, I didn't find much help Googling around for this. It's actually quite easy to implement.

Here's the custom Doclet that you can compile and use:

<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 = "&lt;br/&gt;\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>

An example of how to invoke it using javadoc:

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

blocks|key|280648|text|我不确定这对OP的情况是否有帮助，但是我在文档周围放了<pre></pre>，这样netbean就不会弄乱我的格式。所以它看起来就像|type|unstyled|depth|inlineStyleRanges|offset|length|style|CODE|entityRanges|data|280649|/**
+*+<pre>
+*+Paragraph+One
+*
+*+Paragraph+Two
+*+</pre>
+*/|code-block|syntax|javascript|280650|这最接近于以文本格式显示新行。我使用的是NetBeans+7.1.2。使用code+format选项的这种方式不会重新格式化文档。在提示中显示文档仍然是格式化的。|280651|更新:在Netbeans+8.x中，代码格式化中有一个选项可以禁用格式化注释。|280652|entityMap^0|R|B|0|0|11|B|0|0^^$0|@$1|2|3|4|5|6|7|Q|8|@$9|R|A|S|B|C]]|D|@]|E|$]]|$1|F|3|G|5|H|7|T|8|@]|D|@]|E|$I|J]]|$1|K|3|L|5|6|7|U|8|@$9|V|A|W|B|C]]|D|@]|E|$]]|$1|M|3|N|5|6|7|X|8|@]|D|@]|E|$]]|$1|O|3|-4|5|6|7|Y|8|@]|D|@]|E|$]]]|P|$]]

I'm not sure if this helps for OP's case, however I put <code>&lt;pre&gt;&lt;/pre&gt;</code> around my document so netbean does not mess up my formatting. So it will look like

<pre><code>/**
 * &lt;pre&gt;
 * Paragraph One
 *
 * Paragraph Two
 * &lt;/pre&gt;
 */
</code></pre>

This is closest I get to showing new lines in text format. I'm using NetBeans 7.1.2. This way using <code>code format</code> option will not reformat the document. Showing doc in hints is still formatted.

Update: in Netbeans 8.x there is an option in code formatting to disable formatting comments.

blocks|key|3201438|text|在NetBeans中已经有一个选项--在8.2版上经过测试--允许您在注释中保留新行，并且/或者在需要时向Javadoc添加标记|type|unstyled|depth|inlineStyleRanges|offset|length|style|CODE|entityRanges|data|3201439|如果您还想添加+tag|BOLD|3201440|Check++tag.|unordered-list-item|3201441|
，则此操作将保留新行，而不会在Javadoc部分中添加tag.复选框|3201442|​|3201443|📷|atomic|3201444|3201445|entityMap|0|IMAGE|mutability|IMMUTABLE|imageUrl|https://ask.qcloudimg.com/http-save/yehe-900000/58f19bd1197c3f3bac2a474b3e4839d5.png|imageAlt^0|1|8|1H|7|1Q|3|0|7|3|B|3|7|3|0|6|3|A|3|6|3|0|G|7|S|3|P|9|0|0|0|1|0|0|0^^$0|@$1|2|3|4|5|6|7|12|8|@$9|13|A|14|B|C]|$9|15|A|16|B|C]|$9|17|A|18|B|C]]|D|@]|E|$]]|$1|F|3|G|5|6|7|19|8|@$9|1A|A|1B|B|H]|$9|1C|A|1D|B|H]|$9|1E|A|1F|B|C]]|D|@]|E|$]]|$1|I|3|J|5|K|7|1G|8|@$9|1H|A|1I|B|H]|$9|1J|A|1K|B|H]|$9|1L|A|1M|B|C]]|D|@]|E|$]]|$1|L|3|M|5|6|7|1N|8|@$9|1O|A|1P|B|C]|$9|1Q|A|1R|B|C]|$9|1S|A|1T|B|H]]|D|@]|E|$]]|$1|N|3|O|5|6|7|1U|8|@]|D|@]|E|$]]|$1|P|3|Q|5|R|7|1V|8|@]|D|@$9|1W|A|1X|1|1Y]]|E|$]]|$1|S|3|O|5|6|7|1Z|8|@]|D|@]|E|$]]|$1|T|3|-4|5|6|7|20|8|@]|D|@]|E|$]]]|U|$V|$5|W|X|Y|E|$Z|10|11|-4]]]]

There is already an option in <code>NetBeans</code> - tested on version 8.2 - that allows you to preserve new lines in your comments, and/or add a <code>&lt;p&gt;</code> tag to your <code>Javadoc</code> if needed

<ul>
<li>Just from the <code>Tools</code> menu, chose <code>Options</code></li>
<li>Go to <code>Editor</code> tab, then <code>Formatting</code> tab</li>
<li>In the <code>Language</code> menu chose <code>Java</code>, and in <code>Category</code> menu chose <code>Comments</code></li>
<li>Check the <code>Preserve New Lines</code> checkbox in the <code>General</code> section if you want to preserve new lines in your comments. This will preserve new lines without adding <code>&lt;p&gt;</code> tag</li>
<li>Check <code>Generate "&lt;p&gt;" on Blank Lines</code> checkbox in the <code>Javadoc</code> section if you also want to add <code>&lt;p&gt;</code> tag.</li>
</ul>

<a href="https://i.stack.imgur.com/yFecK.png" rel="nofollow noreferrer"><img src="https://i.stack.imgur.com/yFecK.png" alt="enter image description here"></a>

Sorry for a probable FAQ kind of question, but I just can't find the answer.

As far as I remember Eclipse, a blank line in a Javadoc comment is displayed (in in-source Javadoc popups) as a line break (with extra vertical spacing).

In Netbeans, however, this is not the case.

Can I configure Javadoc to interpret a blank line as a line break?

Additional question: Can I override default Netbeans behavior (related to this) for in-source Javadoc popups?

What I'm talking about is:

<h2>Source</h2>

<pre><code>/**
 * Paragraph One
 *
 * Paragraph Two
 */
 void someMethod() { }
</code></pre>

<h2>Eclipse interpretation</h2>

<pre><code> Paragraph One

 Paragraph Two
</code></pre>

<h2>Netbeans interpretation</h2>

<pre><code> Paragraph One Paragraph Two
</code></pre>

Javadoc: line breaks without HTML-tags?

集成开发环境

Eclipse

对于可能的常见问题，我很抱歉，但我就是找不到答案。据我所知，在Eclipse中，Javadoc注释中的空行(在源代码中的Javadoc弹出窗口中)显示为换行符(带有额外的垂直间距)。然而，在Netbeans中，情况并非如此。我是否可以将配置为将空行解释为换行符？附加问题:我是否可以覆盖源代码内Javadoc弹出窗口的默...

问Javadoc:没有HTML标记的换行？
EN

社区

活动

资源

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问Javadoc:没有HTML标记的换行？EN

社区

活动

资源

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问Javadoc:没有HTML标记的换行？
EN