comparison mercurial/help/revsets.txt @ 30731:b8a188a6f191

help: merge the various operator sections of revsets, filesets and templates

Having sections for specific operator types assumes the user already knows what
type of operators are supported.  By having a common heading, the user can
simply lookup help for "(revsets|filesets|templates).operators".

30730:107014f4848b

Special characters can be used in quoted identifiers by escaping them,
e.g., ``\n`` is interpreted as a newline. To prevent them from being
interpreted, strings can be prefixed with ``r``, e.g. ``r'...'``.

Prefix
======

There is a single prefix operator:

``not x``
  Changesets not in x. Short form is ``! x``.

Infix
=====

These are the supported infix operators:

``x::y``
  A DAG range, meaning all changesets that are descendants of x and

    ``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)".

Postfix
=======

There is a single postfix operator:

``x^``
  Equivalent to ``x^1``, the first parent of each changeset in x.

30731:b8a188a6f191

Special characters can be used in quoted identifiers by escaping them,
e.g., ``\n`` is interpreted as a newline. To prevent them from being
interpreted, strings can be prefixed with ``r``, e.g. ``r'...'``.

Operators
=========

There is a single prefix operator:

``not x``
  Changesets not in x. Short form is ``! x``.

These are the supported infix operators:

``x::y``
  A DAG range, meaning all changesets that are descendants of x and

    ``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)".

There is a single postfix operator:

``x^``
  Equivalent to ``x^1``, the first parent of each changeset in x.