# HG changeset patch
# User Pierre-Yves David <pierre-yves.david@octobus.net>
# Date 1666016776 -7200
# Node ID 4bd12c0f531e8b15db2d7ff6d720374aea081706
# Parent  f56873a7284c7b7c2ad3dcdffcc449ee75df27ae
reuse-delta-base: improves some documentation

The current code got me a bit confused initially. So a bit more documentation
around it cannot hurt.

diff -r f56873a7284c -r 4bd12c0f531e mercurial/configitems.py
--- a/mercurial/configitems.py	Fri Nov 25 15:14:40 2022 +0100
+++ b/mercurial/configitems.py	Mon Oct 17 16:26:16 2022 +0200
@@ -2075,6 +2075,7 @@
     b'revlog.reuse-external-delta',
     default=True,
 )
+# This option is True unless `format.generaldelta` is set.
 coreconfigitem(
     b'storage',
     b'revlog.reuse-external-delta-parent',
diff -r f56873a7284c -r 4bd12c0f531e mercurial/scmutil.py
--- a/mercurial/scmutil.py	Fri Nov 25 15:14:40 2022 +0100
+++ b/mercurial/scmutil.py	Mon Oct 17 16:26:16 2022 +0200
@@ -1858,7 +1858,12 @@
 
 
 def gddeltaconfig(ui):
-    """helper function to know if incoming delta should be optimised"""
+    """helper function to know if incoming deltas should be optimized
+
+    The `format.generaldelta` config is an old form of the config that also
+    implies that incoming delta-bases should be never be trusted. This function
+    exists for this purpose.
+    """
     # experimental config: format.generaldelta
     return ui.configbool(b'format', b'generaldelta')