This is an archive of the discontinued Mercurial Phabricator instance.

Differential D9411

share: add documentation about share-safe mode in `hg help -e share`
ClosedPublic

Authored by pulkit on Nov 27 2020, 10:41 AM.

Details

Reviewers
mharbison72
Group Reviewers
hg-reviewers
Commits
rHG91425656e2b1: share: add documentation about share-safe mode in `hg help -e share`

Diff Detail

Repository
rHG Mercurial
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

pulkit created this revision.Nov 27 2020, 10:41 AM
mharbison72 accepted this revision.Dec 2 2020, 12:35 PM
This revision is now accepted and ready to land.Dec 2 2020, 12:35 PM
martinvonz added a subscriber: martinvonz.Dec 3 2020, 12:42 AM

test-gendoc-ru.t and friends start failing like this for me with this patch:

--- /usr/local/google/home/martinvonz/hg/tests/test-gendoc-ru.t
+++ /usr/local/google/home/martinvonz/hg/tests/test-gendoc-ru.t.err
@@ -2,3 +2,9 @@

   $ $TESTDIR/check-gendoc ru
   checking for parse errors
+  gendoc.txt:12817: (SEVERE/4) Unexpected section title.
+
+  Sharing requirements and configs of source repository with shares
+  -----------------------------------------------------------------
+  Exiting due to level-4 (SEVERE) system message.
+  [1]

Revision Contents
Changeset List

PathPackages
Mhgext/share.py (20 lines)

Diff 23952

hgext/share.py

repository is an aggregate of all encountered remote repositories. repository is an aggregate of all encountered remote repositories.
"remote" means the name is derived from the source repository's "remote" means the name is derived from the source repository's
path or URL. In this mode, storage is only shared if the path or URL path or URL. In this mode, storage is only shared if the path or URL
requested in the :hg:`clone` command matches exactly to a repository requested in the :hg:`clone` command matches exactly to a repository
that was cloned before. that was cloned before.
The default naming mode is "identity". 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 from __future__ import absolute_import
import errno import errno
from mercurial.i18n import _ from mercurial.i18n import _
from mercurial import ( from mercurial import (
bookmarks, bookmarks,