[PATCH] help: fix invalid debugupgraderepo commands after reflow

Mads Kiilerich mads at kiilerich.com
Thu Apr 3 15:30:06 UTC 2025


# HG changeset patch
# User Mads Kiilerich <mads at kiilerich.com>
# Date 1743693292 -7200
#      Thu Apr 03 17:14:52 2025 +0200
# Branch stable
# Node ID 90cf4330d9c80509291a640451ef23c1965c554c
# Parent  fa71dcfb2acea8240edafad2b5af93ba12004b58
help: fix invalid debugupgraderepo commands after reflow

Mercurial recently got some new cases where a user might end up with
repositories that can't be handled by older Mercurial versions or by a
Mercurial without rust extensions.

Some help for these cases was added in 6d79894d3460 and 5e7a0348acf8. The help
text source contains `hg` commands with `\` escape at end of line. They were
however not marked up correctly as pre-formatted and would be line-wrapped and
suggest invalid commands.

Fixed by proper RST markup with `::` and indentation.

diff --git a/mercurial/helptext/config.txt b/mercurial/helptext/config.txt
--- a/mercurial/helptext/config.txt
+++ b/mercurial/helptext/config.txt
@@ -941,12 +941,12 @@ https://www.mercurial-scm.org/wiki/Missi
     available, and enabled by default if the fast implementation is available.
 
     To accomodate installations of Mercurial without the fast implementation,
-    you can downgrade your repository. To do so run the following command:
-
-    $ hg debugupgraderepo \
-          --run \
-          --config format.use-dirstate-v2=False \
-          --config storage.dirstate-v2.slow-path=allow
+    you can downgrade your repository. To do so run the following command::
+
+        $ hg debugupgraderepo \
+              --run \
+              --config format.use-dirstate-v2=False \
+              --config storage.dirstate-v2.slow-path=allow
 
     For a more comprehensive guide, see :hg:`help internals.dirstate-v2`.
 
@@ -1058,12 +1058,12 @@ https://www.mercurial-scm.org/wiki/Missi
     available, and enabled by default if the fast implementation is available.
 
     To accomodate installations of Mercurial without the fast implementation,
-    you can downgrade your repository. To do so run the following command:
-
-    $ hg debugupgraderepo \
-          --run \
-          --config format.use-persistent-nodemap=False \
-          --config storage.revlog.persistent-nodemap.slow-path=allow
+    you can downgrade your repository. To do so run the following command::
+
+        $ hg debugupgraderepo \
+              --run \
+              --config format.use-persistent-nodemap=False \
+              --config storage.revlog.persistent-nodemap.slow-path=allow
 
 ``use-share-safe``
     Enforce "safe" behaviors for all "shares" that access this repository.



More information about the Mercurial-devel mailing list