diff mercurial/revset.py @ 17244:483aa765f6c4 stable

revset: add explanation about difference between 'filelog()' and 'file()'

--- a/mercurial/revset.py	Wed Jul 25 14:49:53 2012 -0500
+++ b/mercurial/revset.py	Wed Jul 25 16:15:28 2012 +0900
@@ -646,6 +646,10 @@
 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.
     """
 
     pat = getstring(x, _("filelog requires a pattern"))
@@ -794,6 +798,9 @@
 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.
     """
     # i18n: "file" is a keyword
     pat = getstring(x, _("file requires a pattern"))