[PATCH] help: 'hg help' supports subtopics (issue2804)

[yun lee]

Thanks for your fast reply, Martin.

As timeless suggested:

2011/5/13 timeless <timeless at gmail.com>:
> On Thu, May 12, 2011 at 6:38 PM, yun lee <yun.lee.bj at gmail.com> wrote:
>> If we add a lot of help topics with names like 'ui.username' and so
>> on, 'hg help' will give a long list, is it a little urgly?
>
>> Is it better to list info of subtopics just for the command of 'hg help
>> ui.subtopic'?
>
> `hg help` should list <ui> not <ui.*> (and similar for other containers)
> `hg help ui` should list the topics under ui (but not their contents)
> `hg help ui.username` should list the help for ui.username
>


2011/5/14 Martin Geisler <mg at lazybytes.net>:

> Some of the sections (e.g., [diff]) overlap with names of existing
> commands -- what can we do with those? You suggested that we put things
> into a config "namespace" so that one must use
>
>  hg help config.diff
>
> to get the help for the [diff] section. I would if we in the next
> step could write just
>
>  hg help diff.git
>
> and not
>
>  hg help config.diff.git
>
> since we've tried to teach ourselves and users to talk about config
> settings as "section.name", not "config.section.name".

Do you mean we drop the using of namespace thoroughly?

-- 
Yun Lee