Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [ptp-dev] PTP code formatter - comments formatting

Beth,

 

80 characters sounds so, um, Fortran-esque!.  I’m trying to imagine living within these bounds, having a hard time with that…

 

Jay

 

 

From: ptp-dev-bounces@xxxxxxxxxxx [mailto:ptp-dev-bounces@xxxxxxxxxxx] On Behalf Of Beth Tibbitts
Sent: Tuesday, April 19, 2011 1:44 PM
To: ptp-dev@xxxxxxxxxxx
Subject: [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


Back to the top