Date: Wed, 25 Jul 2012 06:48:30 +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#2012072509000198] Message-ID: <1343191710.531358.521641174.47647.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 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 --=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?1343191710.531358.521641174.47647.2>