For the most part, I'll stay out of this, since I don't work with this code
base much, so my personal preferences shouldn't make a difference.

However, I do want to point out one more consideration regarding line
lengths. Many people like to use tools such as tkdiff (or ViewCVS, for that
matter) to do side-by-side colourised diffs. That becomes a real pain when
the line lengths go much over 80, because you end up having to do a lot of
horizontal scrolling to make sure you've seen all the changes.

--
Martin Cooper


> -----Original Message-----
> From: Mike Bowler [mailto:[EMAIL PROTECTED]]
> Sent: Monday, January 27, 2003 8:39 AM
> To: [EMAIL PROTECTED]
> Subject: [HttpClient] Proposed style change
> 
> 
> I am going through the code and changing it to conform to the 
> style as 
> per checkstyle.  There are two places that I think we may 
> want to be a 
> little more lenient than the defaults and so I'm putting them 
> here for 
> discussion.
> 
> 1) Line length of 80
> 
> The number 80 originally came from the days when printers could only 
> print 80 columns.  These days, that number doesn't make 
> nearly as much 
> sense.  While I think we still want to have a maximum length, 
> I believe 
> that 80 is too short.
> 
> In most of the places that we are exceeding the limit, we are 
> just over 
> by a bit (between 80 and 90).  I propose that we change the 
> max length 
> to 100.  This is still short enough that nobody should have 
> to scroll to 
> see the source but long enough that we aren't artificially 
> breaking lines.
> 
> 2) Instance variable names
> 
> Some of the code uses leading underscores for variable names but this 
> isn't allowed by checkstyle.  The pattern it checks for is 
> ^[a-z][a-zA-Z0-9]*$
> 
> I find significant benefit to being able to quickly 
> distinguish instance 
> variables from local variables and the leading underscore lets me do 
> that easily.  (I personally prefer trailing underscores to 
> leading ones 
> but I can live with either)
> 
> I propose that we change the pattern for instance variables to 
> ^_?[a-z][a-zA-Z0-9]*$ so that we will allow leading 
> underscores but will 
> not insist on it.
> 
> Comments?
> 
> -- 
> Mike Bowler
> Principal, Gargoyle Software Inc.
> Voice: (416) 822-0973 | Email  : [EMAIL PROTECTED]
> Fax  : (416) 822-0975 | Website: http://www.GargoyleSoftware.com
> 
> 
> 
> --
> To unsubscribe, e-mail:   
> <mailto:[EMAIL PROTECTED]>
> For additional commands, e-mail: 
> <mailto:[EMAIL PROTECTED]>
> 
> 


--
To unsubscribe, e-mail:   
<mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: 
<mailto:[EMAIL PROTECTED]>

Reply via email to