On Dec 1, 2010, at 11:30 AM, Junio C Hamano wrote: >> 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. I completely agree. Alphabetical sorting is only useful when you already know the name of the command you want, and you have no search function. If you don't know the name of the command you want, then grouping by functionality is far better, and if you have a search function, then there is no real benefit at all to A-Z sorting. Trying to make the manpage look "nice" at the expense of removing functional grouping is misguided. -Kevin Ballard -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html