view tests/test-extension.out @ 11321:40c06bbf58be

help: show value requirement and multiple occurrence of options

this helps users to know what kind of option is:

  - no value is required(flag option)
  - value is required
  - value is required, and multiple occurrences are allowed

each kinds are shown as below:

 -f --force              force push
 -e --ssh CMD            specify ssh command to use
 -b --branch BRANCH [+]  a specific branch you would like to push

if one or more 3rd type options are shown, explanation for '[+]' mark
is also shown as footnote.

uisetup called
reposetup called for a
ui == repo.ui
Foo
uisetup called
reposetup called for a
ui == repo.ui
reposetup called for b
ui == repo.ui
updating to branch default
1 files updated, 0 files merged, 0 files removed, 0 files unresolved
uisetup called
Bar
% module/__init__.py-style
uisetup called
reposetup called for a
ui == repo.ui
Foo
1) foo imported
1) bar imported
2) foo uisetup
2) bar uisetup
3) foo extsetup
3) bar extsetup
4) foo reposetup
4) bar reposetup
% hgweb.cgi
1) foo imported
1) bar imported
2) foo uisetup
2) bar uisetup
3) foo extsetup
3) bar extsetup
4) foo reposetup
4) bar reposetup
4) foo reposetup
4) bar reposetup
empty extension - empty cmdtable

no commands defined
% hg help
debugextension extension - only debugcommands

no commands defined
% hg help --verbose
debugextension extension - only debugcommands

list of commands:

 foo:
      yet another foo command

global options:
 -R --repository REPO    repository root directory or name of overlay bundle
                         file
    --cwd DIR            change working directory
 -y --noninteractive     do not prompt, assume 'yes' for any required answers
 -q --quiet              suppress output
 -v --verbose            enable additional output
    --config CONFIG [+]  set/override config option (use 'section.name=value')
    --debug              enable debugging output
    --debugger           start debugger
    --encoding ENCODE    set the charset encoding (default: ascii)
    --encodingmode MODE  set the charset encoding mode (default: strict)
    --traceback          always print a traceback on exception
    --time               time how long the command takes
    --profile            print command execution profile
    --version            output version information and exit
 -h --help               display help and exit

[+] marked option can be specified multiple times
% hg help --debug
debugextension extension - only debugcommands

list of commands:

 debugfoobar:
      yet another debug command
 foo:
      yet another foo command

global options:
 -R --repository REPO    repository root directory or name of overlay bundle
                         file
    --cwd DIR            change working directory
 -y --noninteractive     do not prompt, assume 'yes' for any required answers
 -q --quiet              suppress output
 -v --verbose            enable additional output
    --config CONFIG [+]  set/override config option (use 'section.name=value')
    --debug              enable debugging output
    --debugger           start debugger
    --encoding ENCODE    set the charset encoding (default: ascii)
    --encodingmode MODE  set the charset encoding mode (default: strict)
    --traceback          always print a traceback on exception
    --time               time how long the command takes
    --profile            print command execution profile
    --version            output version information and exit
 -h --help               display help and exit

[+] marked option can be specified multiple times
% issue811
% show extensions
debugissue811
mq
% disabled extension commands
'email' is provided by the following extension:

    patchbomb  command to send changesets as (a series of) patch emails

use "hg help extensions" for information on enabling extensions
hg: unknown command 'qdel'
'qdelete' is provided by the following extension:

    mq  manage a stack of patches

use "hg help extensions" for information on enabling extensions
hg: unknown command 'churn'
'churn' is provided by the following extension:

    churn  command to display statistics about repository history

use "hg help extensions" for information on enabling extensions
% disabled extensions
churn extension - command to display statistics about repository history

use "hg help extensions" for information on enabling extensions
patchbomb extension - command to send changesets as (a series of) patch emails

use "hg help extensions" for information on enabling extensions
% broken disabled extension and command
broken extension - (no help text available)

use "hg help extensions" for information on enabling extensions
hg: unknown command 'foo'