Mercurial > hg
diff mercurial/help/revsets.txt @ 28986:97811ff79647 stable
help: avoid using "$n" parameter in revsetalias example
Because parsing "$n" requires a crafted tokenizer, it exists only for backward
compatibility (as documented in revset._tokenizealias.) This patch updates the
examples so that users are encouraged to use symbolic names instead of "$n"s.
I'm going to implement alias expansion in templater, which won't support "$n"
parameters to make my life easier. Templater is more complicated than revset
because tokenizer and parser call each other.
author | Yuya Nishihara <yuya@tcha.org> |
---|---|
date | Sat, 26 Mar 2016 18:50:56 +0900 |
parents | 3a4d8a6ce432 |
children | 18c1b107898e |
line wrap: on
line diff
--- a/mercurial/help/revsets.txt Sun Apr 17 10:39:17 2016 -0700 +++ b/mercurial/help/revsets.txt Sat Mar 26 18:50:56 2016 +0900 @@ -66,7 +66,7 @@ <alias> = <definition> in the ``revsetalias`` section of a Mercurial configuration file. Arguments -of the form `$1`, `$2`, etc. are substituted from the alias into the +of the form `a1`, `a2`, etc. are substituted from the alias into the definition. For example, @@ -75,8 +75,8 @@ [revsetalias] h = heads() - d($1) = sort($1, date) - rs($1, $2) = reverse(sort($1, $2)) + d(s) = sort(s, date) + rs(s, k) = reverse(sort(s, k)) defines three aliases, ``h``, ``d``, and ``rs``. ``rs(0:tip, author)`` is exactly equivalent to ``reverse(sort(0:tip, author))``. @@ -85,14 +85,14 @@ one string. For example:: [revsetalias] - issue($1) = grep(r'\bissue[ :]?' ## $1 ## r'\b|\bbug\(' ## $1 ## r'\)') + issue(a1) = grep(r'\bissue[ :]?' ## a1 ## r'\b|\bbug\(' ## a1 ## r'\)') ``issue(1234)`` is equivalent to ``grep(r'\bissue[ :]?1234\b|\bbug\(1234\)')`` in this case. This matches against all of "issue 1234", "issue:1234", "issue1234" and "bug(1234)". All other prefix, infix and postfix operators have lower priority than -``##``. For example, ``$1 ## $2~2`` is equivalent to ``($1 ## $2)~2``. +``##``. For example, ``a1 ## a2~2`` is equivalent to ``(a1 ## a2)~2``. Command line equivalents for :hg:`log`::