From owner-svn-ports-all@FreeBSD.ORG Wed Jul 25 09:11:31 2012 Return-Path: Delivered-To: svn-ports-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id C75D4106564A; Wed, 25 Jul 2012 09:11:31 +0000 (UTC) (envelope-from cs@freebsd.org) Received: from mail.319.ch (319.ch [88.198.108.251]) by mx1.freebsd.org (Postfix) with ESMTP id 786FC8FC19; Wed, 25 Jul 2012 09:11:31 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by mail.319.ch (Postfix) with ESMTP id 6E98218CC06; Wed, 25 Jul 2012 11:11:30 +0200 (CEST) Received: from mail.319.ch ([127.0.0.1]) by localhost (maia.319.ch [127.0.0.1]) (maiad, port 10024) with ESMTP id 18383-06; Wed, 25 Jul 2012 11:11:24 +0200 (CEST) Received: from c-st.net (84-72-44-58.dclient.hispeed.ch [84.72.44.58]) (Authenticated sender: cs@carlostrub.ch) by mail.319.ch (Postfix) with ESMTPA id 3595118CC03; Wed, 25 Jul 2012 11:11:24 +0200 (CEST) Content-Type: text/plain; charset="utf-8" Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Powered-BY: OTRS - Open Ticket Request System (http://otrs.org/) X-Mailer: OTRS Mail Service (3.1.6) Date: Wed, 25 Jul 2012 11:11:23 +0200 Message-ID: <1343207483.443770.592586933.47646.2@c-st.net> To: dougb@FreeBSD.org, Organization: Carlo Strub From: Carlo Strub In-Reply-To: <500F6088.5070500@FreeBSD.org> References: <500F6088.5070500@FreeBSD.org><201207242127.q6OLRE9x075919@svn.freebsd.org> <20120725022501.GA98315@FreeBSD.org> <500F5B18.1010105@FreeBSD.org> <20120725024628.GA3065@FreeBSD.org> X-Virus-Scanned: Maia Mailguard Cc: svn-ports-head@freebsd.org, svn-ports-all@freebsd.org, danfe@FreeBSD.org, ports-committers@freebsd.org Subject: Re: svn commit: r301497 - in head: databases/rubygem-dm-migrations deskutils/libgcal deskutils/p5-ZConf- [...] [ID#2012072509000189] X-BeenThere: svn-ports-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: SVN commit messages for the ports tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 25 Jul 2012 09:11:31 -0000 07/25/2012 05:00 - Doug Barton wrote: > On 07/24/2012 19:46, Alexey Dokuchaev wrote: > > Now that you've mentioned it, yes, we have a large diversity in using > > indefinite article in the beginning of COMMENT line. I would also want= us > > to settle on some standard. If you say it should be dropped, so let it= be. >=20 > Oh how I wish I had such power. :) >=20 > The rule has always been "No article at the beginning of the COMMENT." > Unfortunately not only is TPH insufficiently clear on this point, the > actual (long-time historical) example given is misleading in the sense > that it seems to not only allow, but to encourage an indefinite article. > The specific usage in the case of the port referenced would be allowed > because it's a whimsical description of what the port does, rather than > a description of the port itself. However, it's still a painfully bad > example. >=20 > I would gladly punch up this page of the handbook if there is consensus > to do so. >=20 > Doug >=20 > --=20 >=20 > Change is hard. >=20 >=20 >=20 >=20 Go on with your improvements for the standards. I totally agree. Thank you very much for your additional comments in an earlier mail. There = is so much to do in COMMENTS, its incredible. I have started to implement t= he "," where it applies and have deleted where it does not belong... I will= not touch the articles for the moment. Although I agree that they don't be= long there, it has to be postponed until I have fixed the most important ot= her typos. Thanks again for the flowers. I hope, I didn't make anybody unhappy about m= y changes. Carlo -- Carlo Strub Ports committer --=