Bug 102784 - Distinction between Javadoc and comment formatting
Summary: Distinction between Javadoc and comment formatting
Status: RESOLVED DUPLICATE of bug 52115
Alias: None
Product: JDT
Classification: Eclipse Project
Component: Core (show other bugs)
Version: 3.1   Edit
Hardware: PC Windows XP
: P3 enhancement with 2 votes (vote)
Target Milestone: ---   Edit
Assignee: JDT-Core-Inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-07-05 16:13 EDT by Andreas Zimmer CLA
Modified: 2006-12-14 10:51 EST (History)
5 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Andreas Zimmer CLA 2005-07-05 16:13:53 EDT
FEATURE/ENHANCEMENT REQUEST in the name of the jcoffee development team 
(www.jcoffee.com)

We would like to request a clear distinction between JAVADOC formatting
and Java COMMENT formatting. Javadoc formatting makes much sense most of
the times and can be done in a standardized way whereas we believe comment 
formatting may often not make sense and is difficult to standardize and we 
would wish we could just switch it off (but still retain Javadoc formatting).

By the way - if this feature would be provided and COMMENT formatting could 
then be switched off independently from Javadoc formatting, the COMMENTS shall 
then really NOT BE TOUCHED AT ALL, even not with regard to indentation or 
other beautyfying. This is even true for such obvious things like inserting 
blanks in a comment like '/*comment*/' (--> '/* comment */') because we use 
simple comments for our code generator tags (like '/*>*/' and other similar 
ones) and such tags shall not be touched by a formatter.

The content and structure of simple Java comments isn't standardized like 
Javadoc comments - therefore we believe it could not easily be formatted in a 
standardized way as is the case for Javadoc.

Thanks for consideration of this feature/enhancement request.

Andreas
Comment 1 Olivier Thomann CLA 2005-07-05 17:02:48 EDT
This cannot be done for 3.1.1 as it implies an API addition and a maintenance
release doesn't add new API.
Comment 2 Andreas Zimmer CLA 2005-07-05 17:16:03 EDT
Will it be taken into consideration for 3.2?
Comment 3 Olivier Thomann CLA 2005-07-05 17:29:22 EDT
I cannot say yes for sure, but I see no limitation that prevents this from being
investigated for 3.2.
Philippe, any comment?

I think it makes sense to make a distinction between different kinds of comment
for formatting purpose. Users might want to format javadoc comments, but don't
change the line or block comments.
Comment 4 Olivier Thomann CLA 2005-07-05 17:55:08 EDT
Add CC
Comment 5 Markus Keller CLA 2006-12-14 10:30:40 EST
Sounds like a dup of bug 52115.
Comment 6 Olivier Thomann CLA 2006-12-14 10:51:41 EST

*** This bug has been marked as a duplicate of bug 52115 ***