Skip to content
Snippets Groups Projects
Commit 60e6bf3b authored by Pierre-Yves David's avatar Pierre-Yves David :octopus:
Browse files

doc: improves the share-safe documentation

The associated behavior is now clearer and we point to the other configuration
that control the mismatching behavior.

Differential Revision: https://phab.mercurial-scm.org/D9839
parent 043781c0
No related branches found
No related tags found
No related merge requests found
......@@ -913,8 +913,27 @@
Disabled by default.
``use-share-safe``
Enable or disable the "share-safe" functionality, which enables shares
to read requirements and configuration of its source repository.
Enforce "safe" behaviors for all "shares" that access this repository.
With this feature, "shares" using this repository as a source will:
* read the source repository's configuration (`<source>/.hg/hgrc`).
* read and use the source repository's "requirements"
(except the working copy specific one).
Without this feature, "shares" using this repository as a source will:
* keep tracking the repository "requirements" in the share only, ignoring
the source "requirements", possibly diverging from them.
* ignore source repository config. This can create problems, like silently
ignoring important hooks.
Beware that existing shares will not be upgraded/downgraded, and by
default, Mercurial will refuse to interact with them until the mismatch
is resolved. See :hg:`help config share.safe-mismatch.source-safe` and
:hg:`help config share.safe-mismatch.source-not-safe` for details.
Introduced in Mercurial 5.7.
Disabled by default.
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment