--- a/hgext/share.py Wed Sep 22 15:51:59 2010 +0200
+++ b/hgext/share.py Wed Sep 22 16:23:55 2010 +0200
@@ -14,15 +14,16 @@
Initialize a new repository and working directory that shares its
history with another repository.
- NOTE: using rollback or extensions that destroy/modify history
- (mq, rebase, etc.) can cause considerable confusion with shared
- clones. In particular, if two shared clones are both updated to
- the same changeset, and one of them destroys that changeset with
- rollback, the other clone will suddenly stop working: all
- operations will fail with "abort: working directory has unknown
- parent". The only known workaround is to use debugsetparents on
- the broken clone to reset it to a changeset that still exists
- (e.g. tip).
+ .. note::
+ using rollback or extensions that destroy/modify history (mq,
+ rebase, etc.) can cause considerable confusion with shared
+ clones. In particular, if two shared clones are both updated to
+ the same changeset, and one of them destroys that changeset
+ with rollback, the other clone will suddenly stop working: all
+ operations will fail with "abort: working directory has unknown
+ parent". The only known workaround is to use debugsetparents on
+ the broken clone to reset it to a changeset that still exists
+ (e.g. tip).
"""
return hg.share(ui, source, dest, not noupdate)