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 a

     2

  $ hg clone a b

     3

  updating to branch default

     4

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

     5

  $ cd a

     6

  $ echo '[paths]' >> .hg/hgrc

     7

  $ echo 'dupe = ../b' >> .hg/hgrc

     8

  $ echo 'expand = $SOMETHING/bar' >> .hg/hgrc

     9

  $ hg in dupe

    10

  comparing with $TESTTMP/b

    11

  no changes found

    12

  [1]

    13

  $ cd ..

    14

  $ hg -R a in dupe

    15

  comparing with $TESTTMP/b

    16

  no changes found

    17

  [1]

    18

  $ cd a

    19

  $ hg paths

    20

  dupe = $TESTTMP/b

    21

  expand = $TESTTMP/a/$SOMETHING/bar

    22

  $ SOMETHING=foo hg paths

    23

  dupe = $TESTTMP/b

    24

  expand = $TESTTMP/a/foo/bar

    25

  $ SOMETHING=/foo hg paths

    26

  dupe = $TESTTMP/b

    27

  expand = /foo/bar

    28

  $ cd ..

    29

    30

'file:' disables [paths] entries for clone destination

    31

    32

  $ cat >> $HGRCPATH <<EOF

    33

  > [paths]

    34

  > gpath1 = http://hg.example.com

    35

  > EOF

    36

    37

  $ hg clone a gpath1

    38

  abort: cannot create new http repository

    39

  [255]

    40

    41

  $ hg clone a file:gpath1

    42

  updating to branch default

    43

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

    44

  $ cd gpath1

    45

  $ hg -q id

    46

  000000000000

    47