changeset 17244:483aa765f6c4 stable

revset: add explanation about difference between 'filelog()' and 'file()'
author FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
date Wed, 25 Jul 2012 16:15:28 +0900
parents 106cdea0183d
children 6e84171a61c8
files mercurial/revset.py
diffstat 1 files changed, 7 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- 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"))