Description Albert Lin 2004-03-23 19:51:07 EST

Using Eclipse 3.0 M7

In the new code formatter, you can enable/disable comment formatting. However, there 
should be an option so that the code formatter formats ONLY Javadoc comments but 
NOT normal comments (i.e., single line comments beginning with // and multi-line 
comments /*  */).

The reason for this is that normal comments are often used to comment out blocks of 
code, or provide inline notes. When the code formatter attempts to wrap and reformat 
these normal comments , it often completely destroys the original spacing -- which may 
have been significant!

This is especially apparent if you comment out a block of code and then run the code 
formatter with comment formatting on.  All the spacing and indentation of the commented-
out code is destroyed.