# HG changeset patch
# User Joerg Sonnenberger <joerg@bec.de>
# Date 2020-06-23 14:07:18
# Node ID 2fd8a8c1127378bce6e6a4205fe7e3c62134cb99
# Parent  95c672c071164f3d66ded8a717183d30f38942a6

share: provide a more useful text for hg help

Differential Revision: https://phab.mercurial-scm.org/D8651

diff --git a/hgext/share.py b/hgext/share.py
--- a/hgext/share.py
+++ b/hgext/share.py
@@ -5,6 +5,15 @@
 
 '''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
 -----------------------------------