revset: polish explanation of the difference between file() and filelog() stable
authorGreg Ward <greg@gerg.ca>
Wed, 25 Jul 2012 22:41:26 -0400
branchstable
changeset 17265 c30307eeec4b
parent 17264 ec7b9bec19c9
child 17266 4e35dea77e31
revset: polish explanation of the difference between file() and filelog()
mercurial/revset.py
--- a/mercurial/revset.py	Thu Jul 26 16:57:50 2012 -0500
+++ b/mercurial/revset.py	Wed Jul 25 22:41:26 2012 -0400
@@ -654,9 +654,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()``.
     """
 
     # i18n: "filelog" is a keyword
@@ -811,8 +811,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"))