diff -r ec7b9bec19c9 -r c30307eeec4b 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"))