persistent-nodemap: document the feature in `hg help config.format`
authorPierre-Yves David <pierre-yves.david@octobus.net>
Thu, 14 Jan 2021 00:56:27 +0100
changeset 46305 8b94f05ab069
parent 46304 04da2ef8b106
child 46306 7d096e5a5b90
persistent-nodemap: document the feature in `hg help config.format` This is necessary before we advertise the feature more. Differential Revision: https://phab.mercurial-scm.org/D9755
mercurial/helptext/config.txt
tests/test-help.t
--- a/mercurial/helptext/config.txt	Thu Jan 14 00:37:36 2021 +0100
+++ b/mercurial/helptext/config.txt	Thu Jan 14 00:56:27 2021 +0100
@@ -894,6 +894,23 @@
 
     Enabled by default.
 
+``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
+    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 using a version of Mercurial compiled
+    without the Rust part might actually suffer some slowdown.
+
+    Repository with this on-disk format require Mercurial version 5.4 or above.
+
+    Disabled by default.
+
 ``usestore``
     Enable or disable the "store" repository format which improves
     compatibility with systems that fold case or otherwise mangle
--- a/tests/test-help.t	Thu Jan 14 00:37:36 2021 +0100
+++ b/tests/test-help.t	Thu Jan 14 00:56:27 2021 +0100
@@ -1551,6 +1551,8 @@
   
       "usefncache"
   
+      "use-persistent-nodemap"
+  
       "usestore"
   
       "sparse-revlog"