Mercurial > hg-stable
changeset 46021: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