From owner-svn-ports-all@FreeBSD.ORG Wed Jul 25 04:48:41 2012 Return-Path: Delivered-To: svn-ports-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3E5F71065672; Wed, 25 Jul 2012 04:48:41 +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 E33E98FC12; Wed, 25 Jul 2012 04:48:40 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by mail.319.ch (Postfix) with ESMTP id D3FAC18CC06; Wed, 25 Jul 2012 06:48:32 +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 16185-05; Wed, 25 Jul 2012 06:48:30 +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 661D218CC03; Wed, 25 Jul 2012 06:48:30 +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 06:48:30 +0200 Message-ID: <1343191710.531358.521641174.47647.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#2012072509000198] 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 04:48:41 -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 Hi Doug, hi Alexey, Thanks for the kind words and hints. When I started searching for typos, I = thought there will be just a few. I am really shocked how many, sometimes s= tupid, errors there are just in COMMENT -- not to mention pkg-descr... Plea= se, all committers, make sure you double check spelling in your submissions. And yes, Doug, please do add your comments to TPH. Regarding your comments = Alexey, I try to fix them and more grammatical errors (I was aware of them)= . But, so far I am happy if I can fix the simple typos in our many ports :-) Maybe fixing the pkg-descr files could become a good Google Code-In project= for young people. Cheers, Carlo -- Carlo Strub Ports committer --=