[Commented On] D9839: doc: improves the share-safe documentation
baymax (Baymax, Your Personal Patch-care Companion)
phabricator at mercurial-scm.org
Thu Jan 21 13:26:15 UTC 2021
baymax added a comment.
baymax updated this revision to Diff 25195.
✅ refresh by Heptapod after a successful CI run (🐙 💚)
REPOSITORY
rHG Mercurial
CHANGES SINCE LAST UPDATE
https://phab.mercurial-scm.org/D9839?vs=25173&id=25195
BRANCH
stable
CHANGES SINCE LAST ACTION
https://phab.mercurial-scm.org/D9839/new/
REVISION DETAIL
https://phab.mercurial-scm.org/D9839
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
@@ -913,8 +913,28 @@
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 "share" that access this repository.
+
+ With this feature "share" using this repository as source will:
+
+ * read the source repositories configuration (`<source>/.hg/hgrc`)
+ * read and use the source repositories "requirements"
+ (except the working copy specific one.)
+
+ Without this feature, "share" using this repository as source will:
+
+ * keep tracking the repository "requirements" in the share only, ignoring
+ the source one, possibly diverging from them.
+ * ignore source repository config. This can create problem, like silently
+ ignoring important hooks
+
+ Beware that upgrading/downgrading a repository to use this feature will not
+ affect any of its share. Beware that the existing share will not be upgraded
+ and, by default, Mercurial will refuse to interact with them until the
+ mismatch is resolve. 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.
To: marmoute, #hg-reviewers
Cc: pulkit, mercurial-patches
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mercurial-scm.org/pipermail/mercurial-patches/attachments/20210121/60e58ea4/attachment-0002.html>
More information about the Mercurial-patches
mailing list