From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jari Aalto Subject: Re: [PATCH] git-commit.txt: Order options alphabetically Date: Thu, 02 Dec 2010 00:35:23 +0200 Organization: Private Message-ID: <87r5e1t93o.fsf@picasso.cante.net> References: <1291215526-11428-1-git-send-email-jari.aalto@cante.net> <20101201165043.GF26120@burratino> <87r5e1v2g8.fsf@picasso.cante.net> <7vzkspuw8g.fsf@alter.siamese.dyndns.org> Mime-Version: 1.0 Content-Type: text/plain To: git@vger.kernel.org X-From: git-owner@vger.kernel.org Wed Dec 01 23:40:19 2010 Return-path: Envelope-to: gcvg-git-2@lo.gmane.org Received: from vger.kernel.org ([209.132.180.67]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PNvLT-0003WY-Iv for gcvg-git-2@lo.gmane.org; Wed, 01 Dec 2010 23:40:15 +0100 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756124Ab0LAWkG (ORCPT ); Wed, 1 Dec 2010 17:40:06 -0500 Received: from lo.gmane.org ([80.91.229.12]:34056 "EHLO lo.gmane.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1756046Ab0LAWkF (ORCPT ); Wed, 1 Dec 2010 17:40:05 -0500 Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1PNvLI-0003Pt-Fx for git@vger.kernel.org; Wed, 01 Dec 2010 23:40:04 +0100 Received: from a91-155-187-216.elisa-laajakaista.fi ([91.155.187.216]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 01 Dec 2010 23:40:04 +0100 Received: from jari.aalto by a91-155-187-216.elisa-laajakaista.fi with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 01 Dec 2010 23:40:04 +0100 X-Injected-Via-Gmane: http://gmane.org/ X-Complaints-To: usenet@dough.gmane.org X-Gmane-NNTP-Posting-Host: a91-155-187-216.elisa-laajakaista.fi User-Agent: Gnus/5.110011 (No Gnus v0.11) Emacs/23.2 (gnu/linux) Cancel-Lock: sha1:mX3ob78onSYWxwwG8gP97qreY/Y= Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: 2010-12-01 21:30 Junio C Hamano : > > Alphabetical ordering is somewhat last century Tell me aftter many more decades and I may believe it. When computer screen is no more alike print media. > the documentation is often more useful if the options are > grouped together by features and concepts they relate to. Where do you see grouping all the sudden? Manaula pages are not primarily used to learn things, they are used as reference. Just like Book indexes. I haven't seed anyone for 10's of years who would have read full manaul page from top to botton; every single line at one stop. They come and go, come and go to read it. Learn bit by bit. And there is the strenght od proper indexing, the alphabetical. Jari