[Updated] [+- ] D11810: docs: fix typos and wording for the persistent-nodemap feature

Alphare (Raphaël Gomès) phabricator at mercurial-scm.org
Thu Dec 23 15:03:14 UTC 2021


Alphare updated this revision to Diff 31570.

REPOSITORY
  rHG Mercurial

CHANGES SINCE LAST UPDATE
  https://phab.mercurial-scm.org/D11810?vs=31134&id=31570

BRANCH
  stable

CHANGES SINCE LAST ACTION
  https://phab.mercurial-scm.org/D11810/new/

REVISION DETAIL
  https://phab.mercurial-scm.org/D11810

AFFECTED FILES
  mercurial/helptext/config.txt

CHANGE DETAILS

diff --git a/mercurial/helptext/config.txt b/mercurial/helptext/config.txt
--- a/mercurial/helptext/config.txt
+++ b/mercurial/helptext/config.txt
@@ -923,27 +923,29 @@
 
 ``use-persistent-nodemap``
     Enable or disable the "persistent-nodemap" feature which improves
-    performance if the rust extensions are available.
-
-    The "persistence-nodemap" persist the "node -> rev" on disk removing the
+    performance if the Rust extensions are available.
+
+    The "persistent-nodemap" persist the "node -> rev" on disk removing the
     need to dynamically build that mapping for each Mercurial invocation. This
-    significantly reduce the startup cost of various local and server-side
-    operation for larger repository.
-
-    The performance improving version of this feature is currently only
-    implemented in Rust, so people not using a version of Mercurial compiled
-    with the Rust part  might actually suffer some slowdown. For this reason,
-    Such version will by default refuse to access such repositories. That
-    behavior can be controlled by configuration. Check
+    significantly reduces the startup cost of various local and server-side
+    operation for larger repositories.
+
+    The performance-improving version of this feature is currently only
+    implemented in Rust (see :hg:`help rust`), so people not using a version of
+    Mercurial compiled with the Rust parts might actually suffer some slowdown.
+    For this reason, such versions will by default refuse to access repositories
+    with "persistent-nodemap".
+
+    This behavior can be adjusted via configuration: check
     :hg:`help config.storage.revlog.persistent-nodemap.slow-path` for details.
 
-    Repository with this on-disk format require Mercurial version 5.4 or above.
-
-    By default this format variant is disabled if fast implementation is not
-    available and enabled by default if the fast implementation is available.
-
-    To accomodate install of Mercurial without the fast implementation you can
-    downgrade your repository. To do so run the following command:
+    Repositories with this on-disk format require Mercurial 5.4 or above.
+
+    By default this format variant is disabled if the fast implementation is not
+    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 \



To: Alphare, #hg-reviewers, pulkit, joerg.sonnenberger
Cc: joerg.sonnenberger, mercurial-patches
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mercurial-scm.org/pipermail/mercurial-patches/attachments/20211223/6ae6fc8b/attachment-0001.html>


More information about the Mercurial-patches mailing list