documentation feature request: don't alphabetize subcommands

David Demelier markand at malikania.fr
Mon Apr 1 09:20:34 UTC 2019


Le 25/03/2019 à 11:34, frederik at ofb.net a écrit :
> Dear Mercurial People,
> 
> I don't use Mercurial or know much about it. Every once in a while I
> think to myself "I should learn about Mercurial", and I start reading
> the man page and scroll down until I see "add" ... "addremove" ...
> "annotate" ... "archive" ... and then I give up...

Sorting or not sorting does not help anything. Mercurial commands are 
not meant to be used in a specific order.

As some other stated too, manual pages are usually not meant to be 
"tutorials" but more a reference of all available things and this is 
clean. Once you know the basics, you're happy to see that reference 
manual is just a set of commands described along with their arguments.

Example: you can't understand how to develop a program by reading the 
gcc manual page. It requires much more knowledge.

Regarding Mercurial/Git, it also requires basic knowledges of what a SCM 
is before diving into a pure reference documentation.

Regards,

-- 
David




More information about the Mercurial mailing list