--- a/mercurial/setdiscovery.py	Fri Dec 28 03:59:38 2018 +0100
+++ b/mercurial/setdiscovery.py	Fri Jan 04 17:54:18 2019 +0100
@@ -167,9 +167,10 @@
     Feed with data from the remote repository, this object keep track of the
     current set of changeset in various states:
 
-    - common:    own nodes I know we both know
-    - undecided: own nodes where I don't know if remote knows them
-    - missing:   own nodes I know remote lacks
+    - common:    revs also known remotely
+    - undecided: revs we don't have information on yet
+    - missing:   revs missing remotely
+    (all tracked revisions are known locally)
     """
 
     def __init__(self, repo, targetheads):