Date: Sat, 14 May 2011 15:27:05 -0700 From: Jason Helfman <jhelfman@e-e.com> To: Joe Marcus Clarke <marcus@freebsd.org> Cc: Doug Barton <dougb@freebsd.org>, doc-committers@freebsd.org, cvs-all@freebsd.org, cvs-doc@freebsd.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/porters-handbook book.sgml Message-ID: <20110514222705.GA17588@eggman.experts-exchange.com> In-Reply-To: <4DCF00A3.9090100@freebsd.org> References: <201105141806.p4EI6upK087278@repoman.freebsd.org> <4DCEEA98.4090300@FreeBSD.org> <4DCEF2E8.8060106@freebsd.org> <4DCEF864.50105@FreeBSD.org> <4DCF00A3.9090100@freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, May 14, 2011 at 06:22:27PM -0400, Joe Marcus Clarke thus spake: >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 I updated the handbook sometime ago to the limit of 60, from 70. Is that incorrect? I do agree, though, that portlint should warn on that. > >-- >Joe Marcus Clarke >FreeBSD GNOME Team :: gnome@FreeBSD.org >FreeNode / #freebsd-gnome >http://www.FreeBSD.org/gnome >_______________________________________________ >cvs-doc@freebsd.org mailing list >http://lists.freebsd.org/mailman/listinfo/cvs-doc >To unsubscribe, send any mail to "cvs-doc-unsubscribe@freebsd.org" > -- Jason Helfman System Administrator experts-exchange.com http://www.experts-exchange.com/M_4830110.html E4AD 7CF1 1396 27F6 79DD 4342 5E92 AD66 8C8C FBA5
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20110514222705.GA17588>