Mercurial > hg

comparison mercurial/help/revsets.txt @ 29989:5271ae666152

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
help: add sections for revsets
author timeless <timeless@mozdev.org>
date Wed, 21 Sep 2016 17:05:27 -0400
parents 96358865edb3
children b8a188a6f191
comparison
equal deleted inserted replaced
29988:96358865edb3 29989:5271ae666152
10 10
11 Special characters can be used in quoted identifiers by escaping them, 11 Special characters can be used in quoted identifiers by escaping them,
12 e.g., ``\n`` is interpreted as a newline. To prevent them from being 12 e.g., ``\n`` is interpreted as a newline. To prevent them from being
13 interpreted, strings can be prefixed with ``r``, e.g. ``r'...'``. 13 interpreted, strings can be prefixed with ``r``, e.g. ``r'...'``.
14 14
15 Prefix
16 ======
17
15 There is a single prefix operator: 18 There is a single prefix operator:
16 19
17 ``not x`` 20 ``not x``
18 Changesets not in x. Short form is ``! x``. 21 Changesets not in x. Short form is ``! x``.
22
23 Infix
24 =====
19 25
20 These are the supported infix operators: 26 These are the supported infix operators:
21 27
22 ``x::y`` 28 ``x::y``
23 A DAG range, meaning all changesets that are descendants of x and 29 A DAG range, meaning all changesets that are descendants of x and
69 ``issue(1234)`` is equivalent to 75 ``issue(1234)`` is equivalent to
70 ``grep(r'\bissue[ :]?1234\b|\bbug\(1234\)')`` 76 ``grep(r'\bissue[ :]?1234\b|\bbug\(1234\)')``
71 in this case. This matches against all of "issue 1234", "issue:1234", 77 in this case. This matches against all of "issue 1234", "issue:1234",
72 "issue1234" and "bug(1234)". 78 "issue1234" and "bug(1234)".
73 79
80 Postfix
81 =======
82
74 There is a single postfix operator: 83 There is a single postfix operator:
75 84
76 ``x^`` 85 ``x^``
77 Equivalent to ``x^1``, the first parent of each changeset in x. 86 Equivalent to ``x^1``, the first parent of each changeset in x.
78 87
88 Predicates
89 ==========
79 90
80 The following predicates are supported: 91 The following predicates are supported:
81 92
82 .. predicatesmarker 93 .. predicatesmarker
94
95 Aliases
96 =======
83 97
84 New predicates (known as "aliases") can be defined, using any combination of 98 New predicates (known as "aliases") can be defined, using any combination of
85 existing predicates or other aliases. An alias definition looks like:: 99 existing predicates or other aliases. An alias definition looks like::
86 100
87 <alias> = <definition> 101 <alias> = <definition>
100 rs(s, k) = reverse(sort(s, k)) 114 rs(s, k) = reverse(sort(s, k))
101 115
102 defines three aliases, ``h``, ``d``, and ``rs``. ``rs(0:tip, author)`` is 116 defines three aliases, ``h``, ``d``, and ``rs``. ``rs(0:tip, author)`` is
103 exactly equivalent to ``reverse(sort(0:tip, author))``. 117 exactly equivalent to ``reverse(sort(0:tip, author))``.
104 118
119 Equivalents
120 ===========
105 121
106 Command line equivalents for :hg:`log`:: 122 Command line equivalents for :hg:`log`::
107 123
108 -f -> ::. 124 -f -> ::.
109 -d x -> date(x) 125 -d x -> date(x)
111 -m -> merge() 127 -m -> merge()
112 -u x -> user(x) 128 -u x -> user(x)
113 -b x -> branch(x) 129 -b x -> branch(x)
114 -P x -> !::x 130 -P x -> !::x
115 -l x -> limit(expr, x) 131 -l x -> limit(expr, x)
132
133 Examples
134 ========
116 135
117 Some sample queries: 136 Some sample queries:
118 137
119 - Changesets on the default branch:: 138 - Changesets on the default branch::
120 139