revset: add explanation about difference between 'filelog()' and 'file()' stable
authorFUJIWARA Katsunori <foozy@lares.dti.ne.jp>
Wed, 25 Jul 2012 16:15:28 +0900
branchstable
changeset 17244 483aa765f6c4
parent 17243 106cdea0183d
child 17245 6e84171a61c8
revset: add explanation about difference between 'filelog()' and 'file()'
mercurial/revset.py
--- 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"))