Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 14 May 2011 17:23:52 -0400
From:      Joe Marcus Clarke <marcus@freebsd.org>
To:        Doug Barton <dougb@freebsd.org>
Cc:        doc-committers@freebsd.org, cvs-doc@freebsd.org, cvs-all@freebsd.org
Subject:   Re: cvs commit: doc/en_US.ISO8859-1/books/porters-handbook book.sgml
Message-ID:  <4DCEF2E8.8060106@freebsd.org>
In-Reply-To: <4DCEEA98.4090300@FreeBSD.org>
References:  <201105141806.p4EI6upK087278@repoman.freebsd.org> <4DCEEA98.4090300@FreeBSD.org>

next in thread | previous in thread | raw e-mail | index | archive | help
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@FreeBSD.org
FreeNode / #freebsd-gnome
http://www.FreeBSD.org/gnome



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4DCEF2E8.8060106>