Description R.W. Shore 2004-07-13 11:03:12 EDT

I do a fair amount of development using XDoclet. Whenever I reformate the code, 
any special, manual formatting of the XDoclet tag parameters gets munged into a 
single line. The tags still work, but the reformatting spoils the look of the 
comments. I'd like to see the "Comments" tab under the code-formatter edit 
button on the preferences->Java->CodeStyle->CodeFormatter preferences page to 
include the following functionality:

o Under "Indent Javadoc tags", a checkbox for "Reformat other @xxx tags". If 
checked, this would cause the reformatter to behave the way that it does now. 
If unchecked, the reformatter would leave unchanged any text included in an 
@xxx tag. "Included in" means all lines up to (not including) either the end of 
the comment, the next blak line in the comment, or the start of the next "@" 
tag.

o Under the "Reformat other @xxx tags" checkbox there is a subsidiary 
checkbox "Indent lines after @xxx". This box is active only if the "Reformat 
other" box is checked. If this "Indent lines" box is checked, then the 
formatter indents all lines included in an "@" tag by some uniform amount. The 
amount might be computed from the length of the string following the "@", up to 
the first white space.

There may be other ways to achieve the same functionality. The overall goal, 
though, is to provide an option that blocks the total reformatting of the 
information included in an "@" tag such as (but not limited to) "@" tags 
associated with XDoclet.