cvs commit: doc/en_US.ISO8859-1/books/porters-handbook book.sgml

[Joe Marcus Clarke]

On 5/14/11 4:48 PM, Doug Barton wrote:
> Isn't the issue whether or not 70 characters will wrap in any of the
> places that COMMENT is used?

That's a concern, but the fact is most people base the length of COMMENT
on the recommendation of portlint (which has been 70 characters
forever).  No one has complained about COMMENT wrapping at 70 characters
that I have heard of.  Do you know of any place where a COMMENT > 60
characters wraps?

Joe

> 
> 
> 
> On 05/14/2011 11:06, Joe Marcus Clarke wrote:
>> marcus      2011-05-14 18:06:56 UTC
>>
>>    FreeBSD doc repository
>>
>>    Modified files:
>>      en_US.ISO8859-1/books/porters-handbook book.sgml
>>    Log:
>>    Correct a discrepancy between the Porter's Handbook and portlint
>> with regard
>>    to COMMENT.  Portlint recommends a COMMENT no longer than 70
>> characters where
>>    as the Porter's Handbook recommends 60.  Given that most people
>> have built
>>    COMMENT based on the portlint's recommendation, update the handbook
>> to say
>>    COMMENT should be no longer than 70 characters.
>>
>>    PR:             156832 
>> http://www.FreeBSD.org/cgi/query-pr.cgi?pr=156832
>>    Discussed with: portmgr
>>
>>    Revision  Changes    Path
>>    1.1105    +1 -1     
>> doc/en_US.ISO8859-1/books/porters-handbook/book.sgml
>>
>> http://www.FreeBSD.org/cgi/cvsweb.cgi/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml.diff?&r1=1.1104&r2=1.1105&f=h
>>
>>
> 
> 
> 


-- 
Joe Marcus Clarke
FreeBSD GNOME Team	::	gnome at FreeBSD.org
FreeNode / #freebsd-gnome
http://www.FreeBSD.org/gnome