From: Jari Aalto Date: Wed, 01 Dec 2010 22:28:06 GMT Subject: Re: [PATCH] git-add.txt: Order options alphabetically Message-ID: <8739qhuo09.fsf@picasso.cante.net> In-Reply-To: <1291232706.11917.35.camel@drew-northup.unet.maine.edu> 2010-12-01 21:45 Drew Northup : > On Wed, 2010-12-01 at 21:29 +0200, Jari Aalto wrote: > >> 2010-12-01 20:53 Drew Northup : >> > (lacking a commit message to tell me), WHY? [alphabetical] >> >> Quoting >> >> - You read from top to bottom, therefore A-Z. >> - GNU project uses it in manual pages. It looks good, it looks >> professional, it looks clean. And it works when searching (= no >> oriantation problems regardless of tools; even when you print on >> paper when you don't have any computerized aids to help your search.). >> >> Jari > > THAT belongs in a commit message!!! It does not. No need to clutter 10's of message that long in there.. > As an aside, you haven't looked at the sed and gawk manpages, have you? There are plenty of pages that are bad examples. Let's make ours better. Jari