changeset 46006:91425656e2b1

share: add documentation about share-safe mode in `hg help -e share` Differential Revision: https://phab.mercurial-scm.org/D9411
author Pulkit Goyal <7895pulkit@gmail.com>
date Fri, 27 Nov 2020 18:11:47 +0530
parents 2c0ddb79a8cd
children aa4440e59c44
files hgext/share.py
diffstat 1 files changed, 20 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/hgext/share.py	Fri Nov 27 18:11:04 2020 +0530
+++ b/hgext/share.py	Fri Nov 27 18:11:47 2020 +0530
@@ -44,6 +44,26 @@
     that was cloned before.
 
     The default naming mode is "identity".
+
+.. container:: verbose
+
+    Sharing requirements and configs of source repository with shares
+    -----------------------------------------------------------------
+
+    By default creating a shared repository only enables sharing a common
+    history and does not share requirements and configs between them. This
+    may lead to problems in some cases, for example when you upgrade the
+    storage format from one repository but does not set related configs
+    in the shares.
+
+    Setting `format.exp-share-safe = True` enables sharing configs and
+    requirements. This only applies to shares which are done after enabling
+    the config option.
+
+    For enabling this in existing shares, enable the config option and reshare.
+
+    For resharing existing shares, make sure your working directory is clean
+    and there are no untracked files, delete that share and create a new share.
 '''
 
 from __future__ import absolute_import