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

[yun lee]

Thanks for your patient reply, I have understood better.

I think it's OK to insert the help into comment, but I still have some
questions:
1) Do we need create new method to extract information from the comments?


>>> Maybe it would be better to use a specially formatted comment. That
>>> comment could then be put directly where it is needed! Like this
>>>
>>> diff --git a/mercurial/url.py b/mercurial/url.py
>>> --- a/mercurial/url.py
>>> +++ b/mercurial/url.py
>>> @@ -425,6 +425,9 @@
>>>     construct an opener suitable for urllib2
>>>     authinfo will be added to the password manager
>>>     '''
>>> +    ## ui.usehttp2: bool, False
>>> +    ##
>>> +    ## Use new experimental HTTP client?
>>>     if ui.configbool('ui', 'usehttp2', False):
>>>         handlers = [httpconnectionmod.http2handler(ui, passwordmgr(ui))]
>>>     else:

2) I have seen just "Use new experimental HTTP client?" for
'ui.usehttp2', however how to deal with more detailed information for
it? Could we just add them together like below?

diff --git a/mercurial/url.py b/mercurial/url.py
--- a/mercurial/url.py
+++ b/mercurial/url.py
@@ -425,6 +425,9 @@
    construct an opener suitable for urllib2
    authinfo will be added to the password manager
    '''
+    ## ui.usehttp2: bool, False
+    ##
+    ## Use new experimental HTTP client?
+    ##
+    ## Detailed information is here...
    if ui.configbool('ui', 'usehttp2', False):
        handlers = [httpconnectionmod.http2handler(ui, passwordmgr(ui))]
    else:




-- 
Yun Lee