[PATCH 0 of 2] Verbose help

[Peter Arrenbrecht]

On Sun, Oct 4, 2009 at 11:03 PM, Martin Geisler <mg at lazybytes.net> wrote:
> Greg Ward <greg-hg at gerg.ca> writes:
>
>> On Sun, Oct 4, 2009 at 4:38 PM, Martin Geisler <mg at lazybytes.net> wrote:
>>> These patches add support for verbose help as proposed here:
>>>
>>>  http://markmail.org/message/hz7znbi7pzppzco4
>>>
>>> Please see the commit message in the first patch and let me know if
>>> this is what we want.
>>
>> Cool!
>>
>> I notice that your examples and tests speak of debug-level help, but
>> your patch to commands.py only supports "verbose" help.  Shouldn't
>> there be some "if ui.debug then keep = ['verbose', 'debug']" logic?
>
> You're right, the test speaks of it... But it felt a bit weird that one
> would specify
>
>  hg --debug help log
>
> to get detailed help.
>
> Even the idea of verbose help is a bit odd -- perhaps we should turn it
> upside down? So we enable all the detailed help and examples by default,
> but if one does
>
>  hg --expert help log
>
> then we hide the help meant for beginners. Experts can then set
> ui.expert = True in their hgrc file. Just a thought...?

Or every default help display has a footer line explaining about
--verbose. Or only if there actually was a skipped verbose container.
-parren