From: Junio C Hamano <gitster@pobox.com>
Date: Wed, 01 Dec 2010 19:30:23 GMT
Subject: Re: [PATCH] git-commit.txt: Order options alphabetically
Message-ID: <7vzkspuw8g.fsf@alter.siamese.dyndns.org>
In-Reply-To: <87r5e1v2g8.fsf@picasso.cante.net>

Jari Aalto <jari.aalto@cante.net> writes:

>> why would I want sorted option lists in all manpages?
>
> Does that really need an answer?

Yes.

> You read from top to bottom, therefore
> A-Z.

I used to think that back when I referred to printed documentation more
often than online, but not anymore.  Alphabetical ordering is somewhat
last century; the documentation is often more useful if the options are
grouped together by features and concepts they relate to.