From owner-cvs-doc@FreeBSD.ORG Sat May 14 22:22:33 2011 Return-Path: Delivered-To: cvs-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 4400C106566C; Sat, 14 May 2011 22:22:33 +0000 (UTC) (envelope-from marcus@freebsd.org) Received: from av-tac-rtp.cisco.com (hen.cisco.com [64.102.19.198]) by mx1.freebsd.org (Postfix) with ESMTP id 03E898FC0A; Sat, 14 May 2011 22:22:32 +0000 (UTC) X-TACSUNS: Virus Scanned Received: from rooster.cisco.com (localhost.cisco.com [127.0.0.1]) by av-tac-rtp.cisco.com (8.13.8+Sun/8.13.8) with ESMTP id p4EMMWBW006724; Sat, 14 May 2011 18:22:32 -0400 (EDT) Received: from fruit-rollup.marcuscom.com (jclarke-pc.cisco.com [172.18.254.236]) by rooster.cisco.com (8.13.8+Sun/8.13.8) with ESMTP id p4EMMSPT021562; Sat, 14 May 2011 18:22:28 -0400 (EDT) Message-ID: <4DCF00A3.9090100@freebsd.org> Date: Sat, 14 May 2011 18:22:27 -0400 From: Joe Marcus Clarke Organization: FreeBSD, Inc. User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US; rv:1.9.2.17) Gecko/20110414 Thunderbird/3.1.10 MIME-Version: 1.0 To: Doug Barton References: <201105141806.p4EI6upK087278@repoman.freebsd.org> <4DCEEA98.4090300@FreeBSD.org> <4DCEF2E8.8060106@freebsd.org> <4DCEF864.50105@FreeBSD.org> In-Reply-To: <4DCEF864.50105@FreeBSD.org> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit 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 X-BeenThere: cvs-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the doc and www trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 14 May 2011 22:22:33 -0000 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@FreeBSD.org FreeNode / #freebsd-gnome http://www.FreeBSD.org/gnome