diff mercurial/context.py @ 22389:94f77624dbb5

comments: describe ancestor consistently - avoid 'least common ancestor' "best" is as defined by mercurial.ancestor.ancestors: furthest from a root (as measured by longest path).
author Mads Kiilerich <madski@unity3d.com>
date Tue, 19 Aug 2014 01:13:10 +0200
parents d226fe36e362
children 6f63c47cbb86
line wrap: on
line diff
--- a/mercurial/context.py	Tue Aug 19 01:12:56 2014 +0200
+++ b/mercurial/context.py	Tue Aug 19 01:13:10 2014 +0200
@@ -542,9 +542,11 @@
                        changectx=self, filelog=filelog)
 
     def ancestor(self, c2, warn=False):
-        """
-        return the "best" ancestor context of self and c2
-        """
+        """return the "best" ancestor context of self and c2
+
+        If there are multiple candidates, it will show a message and check
+        merge.preferancestor configuration before falling back to the
+        revlog ancestor."""
         # deal with workingctxs
         n2 = c2._node
         if n2 is None:
@@ -1146,7 +1148,7 @@
             return ''
 
     def ancestor(self, c2):
-        """return the ancestor context of self and c2"""
+        """return the "best" ancestor context of self and c2"""
         return self._parents[0].ancestor(c2) # punt on two parents for now
 
     def walk(self, match):