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

  $ cat >> $HGRCPATH <<EOF

     2

  > [extensions]

     3

  > graphlog=

     4

  > 

     5

  > [alias]

     6

  > tlog = log --template "{rev}:{node|short}: '{desc}' {branches}\n"

     7

  > tglog = tlog -G

     8

  > tout = out --template "{rev}:{node|short}: '{desc}' {branches}\n"

     9

  > EOF

    10

    11

  $ hg init a

    12

  $ cd a

    13

    14

  $ echo a > a

    15

  $ hg ci -Aqm0

    16

    17

  $ echo foo >> a

    18

  $ hg ci -Aqm1

    19

    20

  $ hg up -q 0

    21

    22

  $ hg branch stable

    23

  marked working directory as branch stable

    24

  $ echo bar >> a

    25

  $ hg ci -qm2

    26

    27

  $ hg tglog

    28

  @  2:7bee6c3bea3a: '2' stable

    29

  |

    30

  | o  1:3560197d8331: '1'

    31

  |/

    32

  o  0:f7b1eb17ad24: '0'

    33

    34

    35

  $ cd ..

    36

    37

  $ hg clone -q a#stable b

    38

    39

  $ cd b

    40

  $ cat .hg/hgrc

    41

  [paths]

    42

  default = $TESTTMP/a#stable

    43

    44

  $ echo red >> a

    45

  $ hg ci -qm3

    46

    47

  $ hg up -q default

    48

    49

  $ echo blue >> a

    50

  $ hg ci -qm4

    51

    52

  $ hg tglog

    53

  @  3:f0461977a3db: '4'

    54

  |

    55

  | o  2:1d4099801a4e: '3' stable

    56

  | |

    57

  | o  1:7bee6c3bea3a: '2' stable

    58

  |/

    59

  o  0:f7b1eb17ad24: '0'

    60

    61

    62

  $ hg tout

    63

  comparing with $TESTTMP/a

    64

  searching for changes

    65

  2:1d4099801a4e: '3' stable

    66

    67

  $ hg tlog -r 'outgoing()'

    68

  2:1d4099801a4e: '3' stable

    69

    70

  $ hg tout ../a#default

    71

  comparing with ../a

    72

  searching for changes

    73

  3:f0461977a3db: '4' 

    74

    75

  $ hg tlog -r 'outgoing("../a#default")'

    76

  3:f0461977a3db: '4' 

    77

    78

  $ echo "green = ../a#default" >> .hg/hgrc

    79

    80

  $ cat .hg/hgrc

    81

  [paths]

    82

  default = $TESTTMP/a#stable

    83

  green = ../a#default

    84

    85

  $ hg tout green

    86

  comparing with $TESTTMP/a

    87

  searching for changes

    88

  3:f0461977a3db: '4' 

    89

    90

  $ hg tlog -r 'outgoing("green")'

    91

  3:f0461977a3db: '4' 

    92