[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