Wrap JavaDoc wraps too much

In IDE Settings->Code Style->JavaDoc, the option "Wrap at right margin" causes short lines to be joined and then wrapped.

For example:

The returned array contains the following values:
1: disk major number
2: disk minor number
3: disk read sectors
4: disk write sectors

becomes:

The returned array contains the following values: 1: disk major number 2: disk minor number 3: disk read sectors 4: disk write sectors

(wrapped at the right margin)

--Dan

2 comments

On 12/10/03 6:03 PM, in article
3563566.1071068633833.JavaMail.javamailuser@localhost, "Dan Clark"
<no_mail@jetbrains.com> wrote:

The returned array contains the following values:
1: disk major number
2: disk minor number
3: disk read sectors
4: disk write sectors

Can't reproduce the problem. Would you please submit an SCR for this with
sample javadoc attached as well as your formatting options (an xml under
%IDEA%/config/codestyle or project file if you're storing your codestyle
there).

Thanks
--
Maxim Shafirov
JetBrains, Inc
http://www.intellij.com
"Develop with pleasure!"


0

I do not see this behavior when remormatting the code.

However, when viewing the 'Quick Javadoc' (Ctrl-Q), you will see your numbered list as a single line. This is in fact correct, because it is exactly how the HTML output of the javadoc tool would appear.

The javadoc tool ignored line breaks in your comments. If you want a numbered list you should be using and

  • tags. Or you can use
    or

    ]]>

  • tags to force line breaks...



    0

    Please sign in to leave a comment.