$ HGENCODING=utf-8

  $ export HGENCODING

  $ try() {

  >   hg debugrevspec --debug "$@"

  > }

  $ log() {

  >   hg log --template '{rev}\n' -r "$1"

  > }

  $ hg init repo

  $ cd repo

  $ echo a > a

  $ hg branch a

  marked working directory as branch a

  (branches are permanent and global, did you want a bookmark?)

  $ hg ci -Aqm0

  $ echo b > b

  $ hg branch b

  marked working directory as branch b

  (branches are permanent and global, did you want a bookmark?)

  $ hg ci -Aqm1

  $ rm a

  $ hg branch a-b-c-

  marked working directory as branch a-b-c-

  (branches are permanent and global, did you want a bookmark?)

  $ hg ci -Aqm2 -u Bob

  $ hg log -r "extra('branch', 'a-b-c-')" --template '{rev}\n'

  2

  $ hg log -r "extra('branch')" --template '{rev}\n'

  0

  1

  2

  $ hg log -r "extra('branch', 're:a')" --template '{rev} {branch}\n'

  0 a

  2 a-b-c-

  $ hg co 1

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

  $ hg branch +a+b+c+

  marked working directory as branch +a+b+c+

  (branches are permanent and global, did you want a bookmark?)

  $ hg ci -Aqm3

  $ hg co 2  # interleave

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

  $ echo bb > b

  $ hg branch -- -a-b-c-

  marked working directory as branch -a-b-c-

  (branches are permanent and global, did you want a bookmark?)

  $ hg ci -Aqm4 -d "May 12 2005"

  $ hg co 3

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

  (branches are permanent and global, did you want a bookmark?)

  $ hg ci -Aqm"5 bug"

  $ hg merge 4

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

  (branch merge, don't forget to commit)

  $ hg branch _a_b_c_

  marked working directory as branch _a_b_c_

  (branches are permanent and global, did you want a bookmark?)

  $ hg ci -Aqm"6 issue619"

  $ hg branch .a.b.c.

  marked working directory as branch .a.b.c.

  (branches are permanent and global, did you want a bookmark?)

  $ hg ci -Aqm7

  $ hg branch all

  marked working directory as branch all

  (branches are permanent and global, did you want a bookmark?)

  $ hg ci --close-branch -Aqm8

  abort: can only close branch heads

  [255]

  $ hg co 4

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

  $ hg branch é

  marked working directory as branch \xc3\xa9 (esc)

  (branches are permanent and global, did you want a bookmark?)

  $ hg ci -Aqm9

  $ hg tag -r6 1.0

  $ hg clone --quiet -U -r 7 . ../remote1

  $ hg clone --quiet -U -r 8 . ../remote2

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

  $ echo "default = ../remote1" >> .hg/hgrc

names that should work without quoting

  $ try a

  ('symbol', 'a')

  0

  $ try b-a

  (minus

    ('symbol', 'b')

    ('symbol', 'a'))

  1

  $ try _a_b_c_

  ('symbol', '_a_b_c_')

  6

  $ try _a_b_c_-a

  (minus

    ('symbol', '_a_b_c_')

    ('symbol', 'a'))

  6

  $ try .a.b.c.

  ('symbol', '.a.b.c.')

  7

  $ try .a.b.c.-a

  (minus

    ('symbol', '.a.b.c.')

    ('symbol', 'a'))

  7

  $ try -- '-a-b-c-' # complains

  hg: parse error at 7: not a prefix: end

  [255]

  $ log -a-b-c- # succeeds with fallback

  4

  $ try -- -a-b-c--a # complains

  (minus

    (minus

      (minus

        (negate

          ('symbol', 'a'))

        ('symbol', 'b'))

      ('symbol', 'c'))

    (negate

      ('symbol', 'a')))

  abort: unknown revision '-a'!

  [255]

  $ try é

  ('symbol', '\xc3\xa9')

  9

quoting needed

  $ try '"-a-b-c-"-a'

  (minus

    ('string', '-a-b-c-')

    ('symbol', 'a'))

  4

  $ log '1 or 2'

  1

  2

  $ log '1|2'

  1

  2

  $ log '1 and 2'

  $ log '1&2'

  $ try '1&2|3' # precedence - and is higher

  (or

    (and

      ('symbol', '1')

      ('symbol', '2'))

    ('symbol', '3'))

  3

  $ try '1|2&3'

  (or

    ('symbol', '1')

    (and

      ('symbol', '2')

      ('symbol', '3')))

  1

  $ try '1&2&3' # associativity

  (and

    (and

      ('symbol', '1')

      ('symbol', '2'))

    ('symbol', '3'))

  $ try '1|(2|3)'

  (or

    ('symbol', '1')

    (group

      (or

        ('symbol', '2')

        ('symbol', '3'))))

  1

  2

  3

  $ log '1.0' # tag

  6

  $ log 'a' # branch

  0

  $ log '2785f51ee'

  0

  $ log 'date(2005)'

  4

  $ log 'date(this is a test)'

  hg: parse error at 10: unexpected token: symbol

  [255]

  $ log 'date()'

  hg: parse error: date requires a string

  [255]

  $ log 'date'

  hg: parse error: can't use date here

  [255]

  $ log 'date('

  hg: parse error at 5: not a prefix: end

  [255]

  $ log 'date(tip)'

  abort: invalid date: 'tip'

  [255]

  $ log '"date"'

  abort: unknown revision 'date'!

  [255]

  $ log 'date(2005) and 1::'

  4

  $ log 'ancestor(1)'

  hg: parse error: ancestor requires two arguments

  [255]

  $ log 'ancestor(4,5)'

  1

  $ log 'ancestor(4,5) and 4'

  $ log 'ancestors(5)'

  0

  1

  3

  5

  $ log 'author(bob)'

  2

  $ log 'author("re:bob|test")'

  0

  1

  2

  3

  4

  5

  6

  7

  8

  9

  $ log 'branch(é)'

  8

  9

  $ log 'branch(a)'

  0

  $ hg log -r 'branch("re:a")' --template '{rev} {branch}\n'

  0 a

  2 a-b-c-

  3 +a+b+c+

  4 -a-b-c-

  6 _a_b_c_

  7 .a.b.c.

  $ log 'children(ancestor(4,5))'

  2

  3

  $ log 'closed()'

  $ log 'contains(a)'

  0

  1

  3

  5

  $ log 'desc(B)'

  5

  $ log 'descendants(2 or 3)'

  2

  3

  4

  5

  6

  7

  8

  9

  $ log 'file("b*")'

  1

  4

  $ log 'follow()'

  0

  1

  2

  4

  8

  9

  $ log 'grep("issue\d+")'

  6

  $ try 'grep("(")' # invalid regular expression

  (func

    ('symbol', 'grep')

    ('string', '('))

  hg: parse error: invalid match pattern: unbalanced parenthesis

  [255]

  $ try 'grep("\bissue\d+")'

  (func

    ('symbol', 'grep')

    ('string', '\x08issue\\d+'))

  $ try 'grep(r"\bissue\d+")'

  (func

    ('symbol', 'grep')

    ('string', '\\bissue\\d+'))

  6

  $ try 'grep(r"\")'

  hg: parse error at 7: unterminated string

  [255]

  $ log 'head()'

  0

  1

  2

  3

  4

  5

  6

  7

  9

  $ log 'heads(6::)'

  7

  $ log 'keyword(issue)'

  6

  $ log 'limit(head(), 1)'

  0

  $ log 'matching(6)'

  6

  $ log 'matching(6:7, "phase parents user date branch summary files description substate")'

  6

  7

  $ log 'max(contains(a))'

  5

  $ log 'min(contains(a))'

  0

  $ log 'merge()'

  6

  $ log 'modifies(b)'

  4

  $ log 'modifies("path:b")'

  4

  $ log 'modifies("*")'

  4

  6

  $ log 'modifies("set:modified()")'

  4

  $ log 'id(5)'

  2

  $ log 'outgoing()'

  8

  9

  $ log 'outgoing("../remote1")'

  8

  9

  $ log 'outgoing("../remote2")'

  3

  5

  6

  7

  9

  $ log 'p1(merge())'

  5

  $ log 'p2(merge())'

  4

  $ log 'parents(merge())'

  4

  5

  $ log 'removes(a)'

  2

  6

  $ log 'roots(all())'

  0

  $ log 'reverse(2 or 3 or 4 or 5)'

  5

  4

  3

  2

  $ log 'rev(5)'

  5

  $ log 'sort(limit(reverse(all()), 3))'

  7

  8

  9

  $ log 'sort(2 or 3 or 4 or 5, date)'

  2

  3

  5

  4

  $ log 'tagged()'

  6

  $ log 'tag()'

  6

  $ log 'tag(1.0)'

  6

  $ log 'tag(tip)'

  9

we can use patterns when searching for tags

  $ log 'tag("1..*")'

  abort: tag '1..*' does not exist

  [255]

  $ log 'tag("re:1..*")'

  6

  $ log 'tag("re:[0-9].[0-9]")'

  6

  $ log 'tag("literal:1.0")'

  6

  $ log 'tag("re:0..*")'

  abort: no tags exist that match '0..*'

  [255]