Re: [PATCH] git-commit.txt: Order options alphabetically

2010-12-01 21:30 Junio C Hamano <gitster@pobox.com>:

>
> 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