I have an existing extension called "subrepo". Recently I upgraded from 1.5.4 to 1.8.x and now when I execute 'hg help subrepo' I get the built-in help topic for 'subrepos' instead of my extension's help text. If I execute 'hg subrepo', my extension executes correctly but since it requires arguments, it tries to display its help and instead shows the built-in 'subrepos' text in this case as well. The extension itself work fine, I just can't get the help text. The extension is located here: https://bitbucket.org/davidjade/hgsubrepo
We have a similar problem when an extension defines a command with the same name as the extension itself: 'hg help foo' shows the help for the foo command and not the foo extension. We need some flags to 'hg help' so that the user can select the right kind of help in case they shadow each other. We could then display Use 'hg help --extension subrepo' to see help for the subrepo extension Use 'hg help --command subrepo' to see help for the subrepo command at the end of the help topic when we detect that it overshadows an extension and/or a command with the same name. Since most extensions have moved their main help text into the command docstrings, we should only advertise 'hg help --extension' if the extension docstring is more than a single line (all extensions should have at least a single line docstring since it's used used in 'hg help extensions').
Fixed by http://selenic.com/repo/hg/rev/005a540e9aee Martin Geisler <mg@aragost.com> help: add -c/--command flag to only show command help (issue2799) (please test the fix)
--- Bug imported by bugzilla@serpentine.com 2012-05-12 09:19 EDT --- This bug was previously known as _bug_ 2799 at http://mercurial.selenic.com/bts/issue2799