# HG changeset patch
# User Pierre-Yves David <pierre-yves.david@octobus.net>
# Date 2021-03-17 17:40:50
# Node ID 13d973690ecd1f3cde7c2f96a23267eedecf5ab9
# Parent  32399d0813e0eb583bec8ea65c9dd2657af41b77

debugdiscovery: document relevant config option

These config option are here for people to experiment with it. So lets document
them in the command that is used for experimentation.

Differential Revision: https://phab.mercurial-scm.org/D10231

diff --git a/mercurial/debugcommands.py b/mercurial/debugcommands.py
--- a/mercurial/debugcommands.py
+++ b/mercurial/debugcommands.py
@@ -1011,6 +1011,35 @@ def debugdiscovery(ui, repo, remoteurl=b
     be "replaced" by a subset of the local repository using the
     `--local-as-revs` flag. This is useful to efficiently debug pathological
     discovery situation.
+
+    The following developer oriented config are relevant for people playing with this command:
+
+    * devel.discovery.exchange-heads=True
+
+      If False, the discovery will not start with
+      remote head fetching and local head querying.
+
+    * devel.discovery.grow-sample=True
+
+      If False, the sample size used in set discovery will not be increased
+      through the process
+
+    * devel.discovery.grow-sample.rate=1.05
+
+      the rate at which the sample grow
+
+    * devel.discovery.randomize=True
+
+      If andom sampling during discovery are deterministic. It is meant for
+      integration tests.
+
+    * devel.discovery.sample-size=200
+
+      Control the initial size of the discovery sample
+
+    * devel.discovery.sample-size.initial=100
+
+      Control the initial size of the discovery for initial change
     """
     opts = pycompat.byteskwargs(opts)
     unfi = repo.unfiltered()