This is an archive of the discontinued Mercurial Phabricator instance.

Differential D11810

docs: fix typos and wording for the persistent-nodemap feature
ClosedPublic

Authored by Alphare on Nov 26 2021, 8:31 AM.

Details

Reviewers
pulkit
joerg.sonnenberger
Group Reviewers
hg-reviewers
Commits
rHG7e7eaef091c6: docs: fix typos and wording for the persistent-nodemap feature

Diff Detail

Repository
rHG Mercurial
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

Alphare created this revision.Nov 26 2021, 8:31 AM

Pending CI refresh

pulkit accepted this revision.Nov 28 2021, 5:10 PM
This revision is now accepted and ready to land.Nov 28 2021, 5:10 PM
Alphare added a comment.Dec 23 2021, 5:34 AM

This is also destined for stable

joerg.sonnenberger accepted this revision.Dec 23 2021, 9:10 AM
joerg.sonnenberger added a subscriber: joerg.sonnenberger.
joerg.sonnenberger added inline comments.
mercurial/helptext/config.txt
946

installations would be even better?

Alphare updated this revision to Diff 31570.Dec 23 2021, 10:03 AM

Revision Contents
Changeset List

PathPackages
Mmercurial/helptext/config.txt (38 lines)

Diff 31595

mercurial/helptext/config.txt

--run \ --run \
--config format.exp-rc-dirstate-v2=False \ --config format.exp-rc-dirstate-v2=False \
--config storage.dirstate-v2.slow-path=allow --config storage.dirstate-v2.slow-path=allow
For a more comprehensive guide, see :hg:`help internals.dirstate-v2`. For a more comprehensive guide, see :hg:`help internals.dirstate-v2`.
``use-persistent-nodemap`` ``use-persistent-nodemap``
Enable or disable the "persistent-nodemap" feature which improves Enable or disable the "persistent-nodemap" feature which improves
performance if the rust extensions are available. performance if the Rust extensions are available.
The "persistence-nodemap" persist the "node -> rev" on disk removing the The "persistent-nodemap" persist the "node -> rev" on disk removing the
need to dynamically build that mapping for each Mercurial invocation. This need to dynamically build that mapping for each Mercurial invocation. This
significantly reduce the startup cost of various local and server-side significantly reduces the startup cost of various local and server-side
operation for larger repository. operation for larger repositories.
The performance improving version of this feature is currently only The performance-improving version of this feature is currently only
implemented in Rust, so people not using a version of Mercurial compiled implemented in Rust (see :hg:`help rust`), so people not using a version of
with the Rust part might actually suffer some slowdown. For this reason, Mercurial compiled with the Rust parts might actually suffer some slowdown.
Such version will by default refuse to access such repositories. That For this reason, such versions will by default refuse to access repositories
behavior can be controlled by configuration. Check with "persistent-nodemap".
This behavior can be adjusted via configuration: check
:hg:`help config.storage.revlog.persistent-nodemap.slow-path` for details. :hg:`help config.storage.revlog.persistent-nodemap.slow-path` for details.
Repository with this on-disk format require Mercurial version 5.4 or above. Repositories with this on-disk format require Mercurial 5.4 or above.
By default this format variant is disabled if fast implementation is not By default this format variant is disabled if the fast implementation is not
available and enabled by default if the fast implementation is available. available, and enabled by default if the fast implementation is available.
joerg.sonnenbergerUnsubmitted
Not Done

installations would be even better?

joerg.sonnenberger: `installations` would be even better?
To accomodate install of Mercurial without the fast implementation you can To accomodate installations of Mercurial without the fast implementation,
downgrade your repository. To do so run the following command: you can downgrade your repository. To do so run the following command:
$ hg debugupgraderepo \ $ hg debugupgraderepo \
--run \ --run \
--config format.use-persistent-nodemap=False \ --config format.use-persistent-nodemap=False \
--config storage.revlog.persistent-nodemap.slow-path=allow --config storage.revlog.persistent-nodemap.slow-path=allow
``use-share-safe`` ``use-share-safe``
Enforce "safe" behaviors for all "shares" that access this repository. Enforce "safe" behaviors for all "shares" that access this repository.