Date: Wed, 25 Jul 2012 11:11:23 +0200 From: Carlo Strub <cs@FreeBSD.org> To: dougb@FreeBSD.org, 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] Message-ID: <1343207483.443770.592586933.47646.2@c-st.net> 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>
next in thread | previous in thread | raw e-mail | index | archive | help
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 --=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?1343207483.443770.592586933.47646.2>