comparison tests/test-help.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.

11320:e4274f9f97c8

      summarize working directory state
 update, up, checkout, co:
      update working directory (or switch revisions)

global options:
 -R --repository      repository root directory or name of overlay bundle file
    --cwd             change working directory
 -y --noninteractive  do not prompt, assume 'yes' for any required answers
 -q --quiet           suppress output
 -v --verbose         enable additional output
    --config          set/override config option (use 'section.name=value')
    --debug           enable debugging output
    --debugger        start debugger
    --encoding        set the charset encoding (default: ascii)
    --encodingmode    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

use "hg help" for the full list of commands
hg add [OPTION]... [FILE]...

add the specified files on the next commit

use "hg -v help add" to show verbose help

options:

 -I --include  include names matching the given patterns
 -X --exclude  exclude names matching the given patterns
 -n --dry-run  do not perform actions, just print output

use "hg -v help add" to show global options
%% verbose help for add
hg add [OPTION]... [FILE]...

      $ hg status
      A foo.c

options:

 -I --include         include names matching the given patterns
 -X --exclude         exclude names matching the given patterns
 -n --dry-run         do not perform actions, just print output

global options:
 -R --repository      repository root directory or name of overlay bundle file
    --cwd             change working directory
 -y --noninteractive  do not prompt, assume 'yes' for any required answers
 -q --quiet           suppress output
 -v --verbose         enable additional output
    --config          set/override config option (use 'section.name=value')
    --debug           enable debugging output
    --debugger        start debugger
    --encoding        set the charset encoding (default: ascii)
    --encodingmode    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
%% test help option with version option
Mercurial Distributed SCM (version xxx)

Copyright (C) 2005-2010 Matt Mackall <[e-mail]> and others
This is free software; see the source for copying conditions. There is NO

use "hg -v help add" to show verbose help

options:

 -I --include  include names matching the given patterns
 -X --exclude  exclude names matching the given patterns
 -n --dry-run  do not perform actions, just print output

use "hg -v help add" to show global options
hg add: option --skjdfks not recognized
hg add [OPTION]... [FILE]...

use "hg -v help add" to show verbose help

options:

 -I --include  include names matching the given patterns
 -X --exclude  exclude names matching the given patterns
 -n --dry-run  do not perform actions, just print output

use "hg -v help add" to show global options
%% test ambiguous command help
list of commands:

    Returns 0 on success.

options:

 -r --rev                  revision
 -c --change               change made by revision
 -a --text                 treat all files as text
 -g --git                  use git extended diff format
    --nodates              omit dates from diff headers
 -p --show-function        show which function each change is in
    --reverse              produce a diff that undoes the changes
 -w --ignore-all-space     ignore white space when comparing lines
 -b --ignore-space-change  ignore changes in the amount of white space
 -B --ignore-blank-lines   ignore changes whose lines are all blank
 -U --unified              number of lines of context to show
    --stat                 output diffstat-style summary of changes
 -I --include              include names matching the given patterns
 -X --exclude              exclude names matching the given patterns

use "hg -v help diff" to show global options
hg status [OPTION]... [FILE]...

aliases: st

    Returns 0 on success.

options:

 -A --all        show status of all files
 -m --modified   show only modified files
 -a --added      show only added files
 -r --removed    show only removed files
 -d --deleted    show only deleted (but tracked) files
 -c --clean      show only files without changes
 -u --unknown    show only unknown (not tracked) files
 -i --ignored    show only ignored files
 -n --no-status  hide status prefix
 -C --copies     show source of copied files
 -0 --print0     end filenames with NUL, for use with xargs
    --rev        show difference from revision
    --change     list the changed files of a revision
 -I --include    include names matching the given patterns
 -X --exclude    exclude names matching the given patterns

use "hg -v help status" to show global options
hg status [OPTION]... [FILE]...

show changed files in the working directory

11321:40c06bbf58be

      summarize working directory state
 update, up, checkout, co:
      update working directory (or switch revisions)

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

use "hg help" for the full list of commands
hg add [OPTION]... [FILE]...

add the specified files on the next commit

use "hg -v help add" to show verbose help

options:

 -I --include PATTERN [+]  include names matching the given patterns
 -X --exclude PATTERN [+]  exclude names matching the given patterns
 -n --dry-run              do not perform actions, just print output

[+] marked option can be specified multiple times

use "hg -v help add" to show global options
%% verbose help for add
hg add [OPTION]... [FILE]...

      $ hg status
      A foo.c

options:

 -I --include PATTERN [+]  include names matching the given patterns
 -X --exclude PATTERN [+]  exclude names matching the given patterns
 -n --dry-run              do not perform actions, just print output

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
%% test help option with version option
Mercurial Distributed SCM (version xxx)

Copyright (C) 2005-2010 Matt Mackall <[e-mail]> and others
This is free software; see the source for copying conditions. There is NO

use "hg -v help add" to show verbose help

options:

 -I --include PATTERN [+]  include names matching the given patterns
 -X --exclude PATTERN [+]  exclude names matching the given patterns
 -n --dry-run              do not perform actions, just print output

[+] marked option can be specified multiple times

use "hg -v help add" to show global options
hg add: option --skjdfks not recognized
hg add [OPTION]... [FILE]...

use "hg -v help add" to show verbose help

options:

 -I --include PATTERN [+]  include names matching the given patterns
 -X --exclude PATTERN [+]  exclude names matching the given patterns
 -n --dry-run              do not perform actions, just print output

[+] marked option can be specified multiple times

use "hg -v help add" to show global options
%% test ambiguous command help
list of commands:

    Returns 0 on success.

options:

 -r --rev REV [+]          revision
 -c --change REV           change made by revision
 -a --text                 treat all files as text
 -g --git                  use git extended diff format
    --nodates              omit dates from diff headers
 -p --show-function        show which function each change is in
    --reverse              produce a diff that undoes the changes
 -w --ignore-all-space     ignore white space when comparing lines
 -b --ignore-space-change  ignore changes in the amount of white space
 -B --ignore-blank-lines   ignore changes whose lines are all blank
 -U --unified NUM          number of lines of context to show
    --stat                 output diffstat-style summary of changes
 -I --include PATTERN [+]  include names matching the given patterns
 -X --exclude PATTERN [+]  exclude names matching the given patterns

[+] marked option can be specified multiple times

use "hg -v help diff" to show global options
hg status [OPTION]... [FILE]...

aliases: st

    Returns 0 on success.

options:

 -A --all                  show status of all files
 -m --modified             show only modified files
 -a --added                show only added files
 -r --removed              show only removed files
 -d --deleted              show only deleted (but tracked) files
 -c --clean                show only files without changes
 -u --unknown              show only unknown (not tracked) files
 -i --ignored              show only ignored files
 -n --no-status            hide status prefix
 -C --copies               show source of copied files
 -0 --print0               end filenames with NUL, for use with xargs
    --rev REV [+]          show difference from revision
    --change REV           list the changed files of a revision
 -I --include PATTERN [+]  include names matching the given patterns
 -X --exclude PATTERN [+]  exclude names matching the given patterns

[+] marked option can be specified multiple times

use "hg -v help status" to show global options
hg status [OPTION]... [FILE]...

show changed files in the working directory