[PATCH 1 of 2] revset: document the `revset(...)` syntax

[Yuya Nishihara]

On Tue, 16 Oct 2018 12:09:01 +0200, Boris Feld wrote:
> # HG changeset patch
> # User Boris Feld <boris.feld at octobus.net>
> # Date 1539220433 -7200
> #      Thu Oct 11 03:13:53 2018 +0200
> # Node ID 16ae7c19c2a2bb89ad4d201630cd87f6c635b7e0
> # Parent  a66594c5fad422499bfaf669d182e02fe3c0be32
> # EXP-Topic revset-doc
> # Available At https://bitbucket.org/octobus/mercurial-devel/
> #              hg pull https://bitbucket.org/octobus/mercurial-devel/ -r 16ae7c19c2a2
> revset: document the `revset(...)` syntax

Queued, thanks.

> + at predicate('revset(set)', safe=True, takeorder=True)
> +def revsetpredicate(repo, subset, x, order):
> +    """Strictly interpret the content as a revset.
> +
> +    The content of this special predicate will be strictly interpreted as a
> +    revset. For example ``revset(id(0))`` will interpret "id(0)" without
> +    possible ambiguity with a possible "id(0)" bookmark or tag.

I've removed one of these "possible"s, and done minor tweaks.