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

[Joe Marcus Clarke]

On 5/14/11 5:47 PM, Doug Barton wrote:
> On 05/14/2011 14:23, Joe Marcus Clarke wrote:
>> 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?
> 
> You're the one asserting that 70 characters is safe. :)
> 

I'm asserting that people have been limiting their COMMENTs to 70
characters based on portlint's recommendations for some time.  pkg_info
[-I] will truncate COMMENTs at 59 characters, but even with that limit,
the COMMENTs may wrap.  The goal is to give porters enough space to
display a meaningful COMMENT while not overflowing a standard 80 column
terminal.  When viewing the COMMENT in the Makefile strlen(COMMENT=) +
70 < 80.

Joe

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