# HG changeset patch
# User Boris Feld <boris.feld@octobus.net>
# Date 1539220433 -7200
# Node ID d894d2372ffe36943349e5e4916bc35c4990c281
# Parent  1bd3e922de1851a7faaddd95e7b5fba47f8299a8
revset: document the `revset(...)` syntax

We introduce a new "no-op" function to bear the documentation. In practice, the
parsing step is skipping it so it is not even called. This will get fixed in
the next changeset.

diff -r 1bd3e922de18 -r d894d2372ffe mercurial/revset.py
--- a/mercurial/revset.py	Tue Oct 16 12:39:21 2018 +0200
+++ b/mercurial/revset.py	Thu Oct 11 03:13:53 2018 +0200
@@ -1751,6 +1751,16 @@
         return baseset()
     return subset & baseset([l])
 
+@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 be interpreted as "id(0)"
+    without possible ambiguity with a "id(0)" bookmark or tag.
+    """
+    return getset(repo, subset, x, order)
+
 @predicate('matching(revision [, field])', safe=True)
 def matching(repo, subset, x):
     """Changesets in which a given set of fields match the set of fields in the