This is an archive of the discontinued Mercurial Phabricator instance.

Differential D8651

share: provide a more useful text for hg help
ClosedPublic

Authored by joerg.sonnenberger on Jun 23 2020, 10:07 AM.

Details

Reviewers
pulkit
Group Reviewers
hg-reviewers
Commits
rHG2fd8a8c11273: share: provide a more useful text for hg help

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 accepted this revision.Jun 25 2020, 10:51 AM
This revision is now accepted and ready to land.Jun 25 2020, 10:51 AM
joerg.sonnenberger added a commit: rHG2fd8a8c11273: share: provide a more useful text for hg help.Jun 25 2020, 11:43 AM
Closed by commit rHG2fd8a8c11273: share: provide a more useful text for hg help (authored by joerg.sonnenberger). · Explain Why
This revision was automatically updated to reflect the committed changes.

Revision Contents
Changeset List

PathPackages
Mhgext/share.py (9 lines)

Diff 21714

hgext/share.py

# Copyright 2006, 2007 Matt Mackall <mpm@selenic.com> # Copyright 2006, 2007 Matt Mackall <mpm@selenic.com>
# #
# This software may be used and distributed according to the terms of the # This software may be used and distributed according to the terms of the
# GNU General Public License version 2 or any later version. # GNU General Public License version 2 or any later version.
'''share a common history between several working directories '''share a common history between several working directories
The share extension introduces a new command :hg:`share` to create a new
working directory. This is similar to :hg:`clone`, but doesn't involve
copying or linking the storage of the repository. This allows working on
different branches or changes in parallel without the associated cost in
terms of disk space.
Note: destructive operations or extensions like :hg:`rollback` should be
used with care as they can result in confusing problems.
Automatic Pooled Storage for Clones Automatic Pooled Storage for Clones
----------------------------------- -----------------------------------
When this extension is active, :hg:`clone` can be configured to When this extension is active, :hg:`clone` can be configured to
automatically share/pool storage across multiple clones. This automatically share/pool storage across multiple clones. This
mode effectively converts :hg:`clone` to :hg:`clone` + :hg:`share`. mode effectively converts :hg:`clone` to :hg:`clone` + :hg:`share`.
The benefit of using this mode is the automatic management of The benefit of using this mode is the automatic management of
store paths and intelligent pooling of related repositories. store paths and intelligent pooling of related repositories.