[PATCH STABLE] revset: polish explanation of the difference between file() and filelog()

Greg Ward greg at gerg.ca
Wed Jul 25 21:42:40 CDT 2012


# HG changeset patch
# User Greg Ward <greg at gerg.ca>
# Date 1343270486 14400
# Branch stable
# Node ID 50e1e722284dbf7b1fe2325920d2d490845da191
# Parent  bf5bb38bcc7c28f7a355fdfff323aba2018cbb17
revset: polish explanation of the difference between file() and filelog()

diff --git a/mercurial/revset.py b/mercurial/revset.py
--- a/mercurial/revset.py
+++ b/mercurial/revset.py
@@ -647,9 +647,9 @@
     """``filelog(pattern)``
     Changesets connected to the specified filelog.
 
-    If you want to get all changesets affecting matched files exactly,
-    use ``file()`` predicate, because ``filelog()`` may omit some changesets
-    for performance reasons: see :hg:`help log` for detail.
+    For performance reasons, ``filelog()`` does not show every changeset
+    that affects the requested file(s). See :hg:`help log` for details. For
+    a slower, more accurate result, use ``file()``.
     """
 
     pat = getstring(x, _("filelog requires a pattern"))
@@ -799,8 +799,8 @@
     """``file(pattern)``
     Changesets affecting files matched by pattern.
 
-    If you want to pick changesets up fast, consider to
-    use ``filelog()`` predicate, too.
+    For a faster but less accurate result, consider using ``filelog()``
+    instead.
     """
     # i18n: "file" is a keyword
     pat = getstring(x, _("file requires a pattern"))


More information about the Mercurial-devel mailing list