mercurial/obsutil.py
changeset 33272 df90f4d6c609
parent 33252 53b3a1968aa6
child 33274 68f3e819d41d
--- a/mercurial/obsutil.py	Tue Jul 04 18:52:28 2017 -0700
+++ b/mercurial/obsutil.py	Fri Jun 30 13:47:24 2017 +0200
@@ -338,15 +338,16 @@
     successors set. To distinguish this from a pruned changeset, the successor
     set will contain itself only, i.e. [(A,)].
 
-    Finally, successors unknown locally are considered to be pruned (obsoleted
-    without any successors).
+    Finally, final successors unknown locally are considered to be pruned
+    (pruned: obsoleted without any successors). (Final: successors not affected
+    by markers).
 
-    The optional `cache` parameter is a dictionary that may contain precomputed
-    successors sets. It is meant to reuse the computation of a previous call to
-    `successorssets` when multiple calls are made at the same time. The cache
-    dictionary is updated in place. The caller is responsible for its life
-    span. Code that makes multiple calls to `successorssets` *must* use this
-    cache mechanism or suffer terrible performance.
+    The optional `cache` parameter is a dictionary that may contains
+    precomputed successors sets. It is meant to reuse the computation of a
+    previous call to `successorssets` when multiple calls are made at the same
+    time. The cache dictionary is updated in place. The caller is responsible
+    for its life span. Code that makes multiple calls to `successorssets`
+    *should* use this cache mechanism or risk a performance hit.
     """
 
     succmarkers = repo.obsstore.successors