On Mon, Sep 29, 2008 at 02:10:31AM +0200, Jakub Narebski wrote: > peff> The manpage, on the other hand, is a comprehensive reference > peff> and so should probably be alphabetized for easy reading. > > [...] > > Second, large manpages with large number of options are usually divided > into sections, see git-rev-list(1) manpage, or rpmbuild(8) manpage. So > there is precedent for that. And I think it is good precedent. I am not opposed to dividing it into sections, with options alphabetized in each section, as long as the section divisions make sense (e.g., in rev-list, an obvious section is "commit formatting options"). I just didn't think we had enough here to bother subdividing. Either way will be in improvement on the current status, which is apparently random (it looks like it was probably alphabetized at one point, and then new options were added to the end). -Peff -- 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
