documentation feature request: don't alphabetize subcommands
Ludovic Chabant
ludovic at chabant.com
Mon Mar 25 17:17:16 UTC 2019
> 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...
Hi! To be honest, I'm not sure I've ever _not_ given up learning
anything from a man page... I always find it more productive to find a
book or blog post or article with a tutorial of some kind.
FWIW, `hg help` (on a recent enough Mercurial) will show you the list of
commands in a "topical" order, with different sections... for instance
first it shows "clone" and "init", then it shows commands for
pushing/pulling, then "commit", etc. I'm sure it would be reasonable to
change the man page generation to generate something in the same order
and organization (which should be possible since, I think, this order
and organization is actually driven by metadata found in the code).
--
l u d o .
. 8 0 17 80
More information about the Mercurial
mailing list