pulkit created this revision. Herald added a reviewer: hg-reviewers. Herald added a subscriber: mercurial-patches.
REVISION SUMMARY My recent series added these 4 configs which control how to behave when there is difference in share-safe state of source and shares. However my patches were missing documentation. This patch adds it. The documentation is added in verbose part as the feature and config are experimental. REPOSITORY rHG Mercurial BRANCH default REVISION DETAIL https://phab.mercurial-scm.org/D9769 AFFECTED FILES hgext/share.py CHANGE DETAILS diff --git a/hgext/share.py b/hgext/share.py --- a/hgext/share.py +++ b/hgext/share.py @@ -63,6 +63,30 @@ 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. + + Shares can be automatically upgraded and downgraded to use share-safe + mechanism. Following config options control the behavior: + + ``experimental.sharesafe-warn-outdated-shares`` (default: True) + Shows a warning if the current share is outdated and can be upgraded to + use share-safe functionality. + + ``experimental.sharesafe-auto-upgrade-shares`` (default: False) + Automatically upgrades shares if the share source supports share-safe + functionality. + If the upgrade fails, a warning is shown and the command which is + running is continued. + + ``experimental.sharesafe-auto-upgrade-fail-error`` (default: False) + If auto upgrade of share fails, error out the process and don't continue + the command which is running. + + ``experimental.sharesafe-auto-downgrade-shares`` (default: False) + Automatically downgrade shares if it was using share-safe functionality + but the share source stopped using it. + If the downgrade process fails, we error out because current share + does not have complete set of requirements and shared source no longer + supports share-safe mechanism. ''' from __future__ import absolute_import To: pulkit, #hg-reviewers Cc: mercurial-patches, mercurial-devel _______________________________________________ Mercurial-devel mailing list Mercurial-devel@mercurial-scm.org https://www.mercurial-scm.org/mailman/listinfo/mercurial-devel
