Eclipse formatter and javadoc.

Eclipse formatter and javadoc.

[Nurdin Premji]

The eclipse formatter currently mangles javadoc by indenting the first 
line 2 spaces, and then indenting the following lines 8 spaces.

I'm not sure how to correct this, however this behaviour can be avoided 
by turning off formatting of javadoc.
To do this go to project->properties->java code style->formatter and 
edit the formatter. Select the "comments" tab, the far right tab. (Here 
you can see a preview of what I'm talking about with the javadoc). 
Uncheck enable comment formatting.

If people are happy with this change then it can be committed.

Re: Eclipse formatter and javadoc.

[Sami Wagiaalla]

There are several ways to fix this:

One is to change Tab policy under indentation from mixed to spaces only 
(which I recommend. Isn't that what emacs does ?).

The other is to change to "Tab size" from 8 to 2 (not so elegant).

Overall i dont think formatting of java docs should be turned off.


Nurdin Premji wrote:
> The eclipse formatter currently mangles javadoc by indenting the first 
> line 2 spaces, and then indenting the following lines 8 spaces.
>
> I'm not sure how to correct this, however this behaviour can be 
> avoided by turning off formatting of javadoc.
> To do this go to project->properties->java code style->formatter and 
> edit the formatter. Select the "comments" tab, the far right tab. 
> (Here you can see a preview of what I'm talking about with the 
> javadoc). Uncheck enable comment formatting.
>
> If people are happy with this change then it can be committed.

Re: Eclipse formatter and javadoc.

[Stan Cox]

On Wed, 2007-05-16 at 11:17 -0400, Sami Wagiaalla wrote:
> Isn't that what emacs does?

Emacs indent-region, indent-to-column etc use a mixture of tabs and
spaces, using tabs where possible.  It has an option to use only spaces,
but most folks using emacs to edit C/C++ don't use that.