$ HGFOO=BAR; export HGFOO

  $ cat >> $HGRCPATH <<EOF

  > [alias]

  > # should clobber ci but not commit (issue2993)

  > ci = version

  > myinit = init

  > mycommit = commit

  > optionalrepo = showconfig alias.myinit

  > cleanstatus = status -c

  > unknown = bargle

  > ambiguous = s

  > recursive = recursive

  > disabled = email

  > nodefinition =

  > noclosingquotation = '

  > no--cwd = status --cwd elsewhere

  > no-R = status -R elsewhere

  > no--repo = status --repo elsewhere

  > no--repository = status --repository elsewhere

  > no--config = status --config a.config=1

  > mylog = log

  > lognull = log -r null

  > shortlog = log --template '{rev} {node|short} | {date|isodate}\n'

  > positional = log --template '{\$2} {\$1} | {date|isodate}\n'

  > dln = lognull --debug

  > nousage = rollback

  > put = export -r 0 -o "\$FOO/%R.diff"

  > blank = !printf '\n'

  > self = !printf '\$0\n'

  > echoall = !printf '\$@\n'

  > echo1 = !printf '\$1\n'

  > echo2 = !printf '\$2\n'

  > echo13 = !printf '\$1 \$3\n'

  > echotokens = !printf "%s\n" "\$@"

  > count = !hg log -r "\$@" --template=. | wc -c | sed -e 's/ //g'

  > mcount = !hg log \$@ --template=. | wc -c | sed -e 's/ //g'

  > rt = root

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

  > idalias = id

  > idaliaslong = id

  > idaliasshell = !echo test

  > parentsshell1 = !echo one

  > parentsshell2 = !echo two

  > escaped1 = !printf 'test\$\$test\n'

  > escaped2 = !sh -c 'echo "HGFOO is \$\$HGFOO"'

  > escaped3 = !sh -c 'echo "\$1 is \$\$\$1"'

  > escaped4 = !printf '\$\$0 \$\$@\n'

  > exit1 = !sh -c 'exit 1'

  > 

  > [defaults]

  > mylog = -q

  > lognull = -q

  > log = -v

  > EOF

basic

  $ hg myinit alias

unknown

  $ hg unknown

  abort: alias 'unknown' resolves to unknown command 'bargle'

  [255]

  $ hg help unknown

  alias 'unknown' resolves to unknown command 'bargle'

ambiguous

  $ hg ambiguous

  abort: alias 'ambiguous' resolves to ambiguous command 's'

  [255]

  $ hg help ambiguous

  alias 'ambiguous' resolves to ambiguous command 's'

recursive

  $ hg recursive

  abort: alias 'recursive' resolves to unknown command 'recursive'

  [255]

  $ hg help recursive

  alias 'recursive' resolves to unknown command 'recursive'

disabled

  $ hg disabled

  abort: alias 'disabled' resolves to unknown command 'email'

  ('email' is provided by 'patchbomb' extension)

  [255]

  $ hg help disabled

  alias 'disabled' resolves to unknown command 'email'

  'email' is provided by the following extension:

      patchbomb     command to send changesets as (a series of) patch emails

no definition

  $ hg nodef

  abort: no definition for alias 'nodefinition'

  [255]

  $ hg help nodef

  no definition for alias 'nodefinition'

no closing quotation

  $ hg noclosing

  abort: error in definition for alias 'noclosingquotation': No closing quotation

  [255]

  $ hg help noclosing

  error in definition for alias 'noclosingquotation': No closing quotation

invalid options

  $ hg no--cwd

  abort: error in definition for alias 'no--cwd': --cwd may only be given on the command line

  [255]

  $ hg help no--cwd

  error in definition for alias 'no--cwd': --cwd may only be given on the

  command line

  $ hg no-R

  abort: error in definition for alias 'no-R': -R may only be given on the command line

  [255]

  $ hg help no-R

  error in definition for alias 'no-R': -R may only be given on the command line

  $ hg no--repo

  abort: error in definition for alias 'no--repo': --repo may only be given on the command line

  [255]

  $ hg help no--repo

  error in definition for alias 'no--repo': --repo may only be given on the

  command line

  $ hg no--repository

  abort: error in definition for alias 'no--repository': --repository may only be given on the command line

  [255]

  $ hg help no--repository

  error in definition for alias 'no--repository': --repository may only be given

  on the command line

  $ hg no--config

  abort: error in definition for alias 'no--config': --config may only be given on the command line

  [255]

optional repository

#if no-outer-repo

  $ hg optionalrepo

  init

#endif

  $ cd alias

  $ cat > .hg/hgrc <<EOF

  > [alias]

  > myinit = init -q

  > EOF

  $ hg optionalrepo

  init -q

no usage

  $ hg nousage

  no rollback information available

  [1]

  $ echo foo > foo

  $ hg commit -Amfoo

  adding foo

infer repository

  $ cd ..

#if no-outer-repo

  $ hg shortlog alias/foo

  0 e63c23eaa88a | 1970-01-01 00:00 +0000

#endif

  $ cd alias

with opts

  $ hg cleanst

  C foo

with opts and whitespace

  $ hg shortlog

  0 e63c23eaa88a | 1970-01-01 00:00 +0000

positional arguments

  $ hg positional

  abort: too few arguments for command alias

  [255]

  $ hg positional a

  abort: too few arguments for command alias

  [255]

  $ hg positional 'node|short' rev

  0 e63c23eaa88a | 1970-01-01 00:00 +0000

interaction with defaults

  $ hg mylog

  0:e63c23eaa88a

  $ hg lognull

  -1:000000000000

properly recursive

  $ hg dln

  changeset:   -1:0000000000000000000000000000000000000000

  phase:       public

  parent:      -1:0000000000000000000000000000000000000000

  parent:      -1:0000000000000000000000000000000000000000

  manifest:    -1:0000000000000000000000000000000000000000

  user:        

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

  extra:       branch=default

path expanding

  $ FOO=`pwd` hg put

  $ cat 0.diff

  # HG changeset patch

  # User test

  # Date 0 0

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

  # Node ID e63c23eaa88ae77967edcf4ea194d31167c478b0

  # Parent  0000000000000000000000000000000000000000

  foo

  diff -r 000000000000 -r e63c23eaa88a foo

  --- /dev/null	Thu Jan 01 00:00:00 1970 +0000

  +++ b/foo	Thu Jan 01 00:00:00 1970 +0000

  @@ -0,0 +1,1 @@

  +foo

simple shell aliases

  $ hg blank

  $ hg blank foo

  $ hg self

  self

  $ hg echoall

  $ hg echoall foo

  foo

  $ hg echoall 'test $2' foo

  test $2 foo

  $ hg echoall 'test $@' foo '$@'

  test $@ foo $@

  $ hg echoall 'test "$@"' foo '"$@"'

  test "$@" foo "$@"

  $ hg echo1 foo bar baz

  foo

  $ hg echo2 foo bar baz

  bar

  $ hg echo13 foo bar baz test

  foo baz

  $ hg echo2 foo

  $ hg echotokens

  $ hg echotokens foo 'bar $1 baz'

  foo

  bar $1 baz

  $ hg echotokens 'test $2' foo

  test $2

  foo

  $ hg echotokens 'test $@' foo '$@'

  test $@

  foo

  $@

  $ hg echotokens 'test "$@"' foo '"$@"'

  test "$@"

  foo

  "$@"

  $ echo bar > bar

  $ hg commit -qA -m bar

  $ hg count .

  1

  $ hg count 'branch(default)'

  2

  $ hg mcount -r '"branch(default)"'

  2

  $ hg tglog

  @  1:042423737847: 'bar'

  |

  o  0:e63c23eaa88a: 'foo'

shadowing

  $ hg i

  hg: command 'i' is ambiguous:

      idalias idaliaslong idaliasshell identify import incoming init

  [255]

  $ hg id

  042423737847 tip

  $ hg ida

  hg: command 'ida' is ambiguous:

      idalias idaliaslong idaliasshell

  [255]

  $ hg idalias

  042423737847 tip

  $ hg idaliasl

  042423737847 tip

  $ hg idaliass

  test

  $ hg parentsshell

  hg: command 'parentsshell' is ambiguous:

      parentsshell1 parentsshell2

  [255]

  $ hg parentsshell1

  one

  $ hg parentsshell2

  two

shell aliases with global options

  $ hg init sub

  $ cd sub

  $ hg count 'branch(default)'

  abort: unknown revision 'default'!

  0

  $ hg -v count 'branch(default)'

  abort: unknown revision 'default'!

  0

  $ hg -R .. count 'branch(default)'

  abort: unknown revision 'default'!

  0

  $ hg --cwd .. count 'branch(default)'

  2

  $ hg echoall --cwd ..

repo specific shell aliases

  $ cat >> .hg/hgrc <<EOF

  > [alias]

  > subalias = !echo sub

  > EOF

  $ cat >> ../.hg/hgrc <<EOF

  > [alias]

  > mainalias = !echo main

  > EOF

shell alias defined in current repo

  $ hg subalias

  sub

  $ hg --cwd .. subalias > /dev/null

  hg: unknown command 'subalias'

  (did you mean idalias?)

  [255]

  $ hg -R .. subalias > /dev/null

  hg: unknown command 'subalias'

  (did you mean idalias?)

  [255]

shell alias defined in other repo

  $ hg mainalias > /dev/null

  hg: unknown command 'mainalias'

  (did you mean idalias?)

  [255]

  $ hg -R .. mainalias

  main

  $ hg --cwd .. mainalias

  main

typos get useful suggestions

  $ hg --cwd .. manalias