[PATCH 10 of 10 V3] discovery: improve partial discovery documentation

[Boris Feld]

# HG changeset patch
# User Boris Feld <boris.feld at octobus.net>
# Date 1546620858 -3600
#      Fri Jan 04 17:54:18 2019 +0100
# Node ID 79b8d956d0a7ff9de20fc34e41c42d933cabf0f2
# Parent  af7fc1d08b16a56c3c0f7ab3abd9a926e79d5749
# EXP-Topic discovery-refactor
# Available At https://bitbucket.org/octobus/mercurial-devel/
#              hg pull https://bitbucket.org/octobus/mercurial-devel/ -r 79b8d956d0a7
discovery: improve partial discovery documentation

The older documentation could be improved.

diff --git a/mercurial/setdiscovery.py b/mercurial/setdiscovery.py
--- a/mercurial/setdiscovery.py
+++ b/mercurial/setdiscovery.py
@@ -167,9 +167,10 @@ class partialdiscovery(object):
     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):