help: do not show full help text for command on option errors Example $ hg clone --jump foo bar hg clone: option --jump not recognized hg clone [OPTION]... SOURCE [DEST] make a copy of an existing repository options: -U --noupdate the clone will include an empty working copy (only a repository) -u --updaterev REV revision, tag or branch to check out -r --rev REV [+] include the specified changeset -b --branch BRANCH [+] clone only the specified branch --pull use pull protocol to copy metadata --uncompressed use uncompressed transfer (fast over LAN) -e --ssh CMD specify ssh command to use --remotecmd CMD specify hg command to run on the remote side --insecure do not verify server certificate (ignoring web.cacerts config) [+] marked option can be specified multiple times use "hg help clone" to show the full help text Motivation for this change If the user already has specified the command, he probably already knows the command to some extent. Apparently, he has a problem with the options, so we show him just the synopsis with the short help and the details about the options, with a hint on the last line how to get the full help text. Why is Mercurial better with this change? Experts who just forgot about the details of an option don't get that much text thrown at them, while the newbies still get a hint on the last line how to get the full help text.

     1

http://mercurial.selenic.com/bts/issue1877

     2

     3

  $ hg init a

     4

  $ cd a

     5

  $ echo a > a

     6

  $ hg add a

     7

  $ hg ci -m 'a'

     8

  $ echo b > a

     9

  $ hg ci -m'b'

    10

  $ hg up 0

    11

  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

    12

  $ hg book main

    13

  $ hg book

    14

   * main                      0:cb9a9f314b8b

    15

  $ echo c > c

    16

  $ hg add c

    17

  $ hg ci -m'c'

    18

  created new head

    19

  $ hg book

    20

   * main                      2:d36c0562f908

    21

  $ hg heads

    22

  changeset:   2:d36c0562f908

    23

  bookmark:    main

    24

  tag:         tip

    25

  parent:      0:cb9a9f314b8b

    26

  user:        test

    27

  date:        Thu Jan 01 00:00:00 1970 +0000

    28

  summary:     c

    29

    30

  changeset:   1:1e6c11564562

    31

  user:        test

    32

  date:        Thu Jan 01 00:00:00 1970 +0000

    33

  summary:     b

    34

    35

  $ hg up 1e6c11564562

    36

  1 files updated, 0 files merged, 1 files removed, 0 files unresolved

    37

  $ hg merge main

    38

  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

    39

  (branch merge, don't forget to commit)

    40

  $ hg book

    41

     main                      2:d36c0562f908

    42

  $ hg ci -m'merge'

    43

  $ hg book

    44

     main                      2:d36c0562f908

    45