diff --git a/mercurial/revset.py b/mercurial/revset.py
--- a/mercurial/revset.py
+++ b/mercurial/revset.py
@@ -654,9 +654,9 @@ def filelog(repo, subset, x):
     """``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 @@ def hasfile(repo, subset, x):
     """``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"))