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

  $ hg init repo

     2

  $ cd repo

     3

  $ hg init subrepo

     4

  $ echo a > subrepo/a

     5

  $ hg -R subrepo ci -Am adda

     6

  adding a

     7

  $ echo 'subrepo = subrepo' > .hgsub

     8

  $ hg ci -Am addsubrepo

     9

  adding .hgsub

    10

  committing subrepository subrepo

    11

  $ echo b > subrepo/b

    12

  $ hg -R subrepo ci -Am addb

    13

  adding b

    14

  $ hg ci -m updatedsub

    15

  committing subrepository subrepo

    16

    17

delete .hgsub and revert it

    18

    19

  $ rm .hgsub

    20

  $ hg revert .hgsub

    21

  warning: subrepo spec file .hgsub not found

    22

    23

delete .hgsubstate and revert it

    24

    25

  $ rm .hgsubstate

    26

  $ hg revert .hgsubstate

    27

    28

delete .hgsub and update

    29

    30

  $ rm .hgsub

    31

  $ hg up 0

    32

  warning: subrepo spec file .hgsub not found

    33

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

    34

  $ hg st

    35

  ! .hgsub

    36

  $ ls subrepo

    37

  a

    38

    39

delete .hgsubstate and update

    40

    41

  $ hg up -C

    42

  warning: subrepo spec file .hgsub not found

    43

  2 files updated, 0 files merged, 0 files removed, 0 files unresolved

    44

  $ rm .hgsubstate

    45

  $ hg up 0  

    46

  remote changed .hgsubstate which local deleted

    47

  use (c)hanged version or leave (d)eleted? c

    48

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

    49

  $ hg st

    50

  $ ls subrepo

    51

  a