| [ptp-dev] PTP code formatter - comments formatting |
I'm finally getting around to applying the PTP code formatting template on some PLDT source files.
(Ref: On the wiki under developer guidelines: http://wiki.eclipse.org/PTP/policy/developer_guidelines#PTP_formatting_and_cleanup_profiles_for_Java )
See Eclipse Preferences > Java > Code Style > Formatter
It does more mashing of comments and block comments than I'd like.
The line length for comments was set to 80, where the line length for code is 132.
I would like to propose, on the Comments tab of the Profile editor under Preferences > Java > Code Style > Formatter
1) set comment line length to 132 to match code line length
2) check "Never join lines" so it won't wrap existing comment lines
3) enable @formatting:on and @formatting:off in comments, so that the block comments that have been carefully formatted won't be munged. I don't need these in very many places but it's nice to be able to turn it on when you do.
Comments? I don't think this change will change any existing comments from the old profile.
...Beth
Beth Tibbitts
Eclipse Parallel Tools Platform http://eclipse.org/ptp
IBM STG - High Performance Computing Tools
Mailing Address: IBM Corp., 745 West New Circle Road, Lexington, KY 40511