Merge lp:~nmb/bzr/fix-248182 into lp:bzr

[Neil Martinsen-Burrell]

[Neil Martinsen-Burrell (nmb)]

This fixes 248182 by adding more description to the init-repo help about what shared repositories are good for.

[Vincent Ladeuil (vila)]

Thanks.

review: Approve

[John A Meinel (jameinel)]

review: Approve

=== modified file 'bzrlib/builtins.py'
--- bzrlib/builtins.py	2009-12-01 00:10:04 +0000
+++ bzrlib/builtins.py	2009-12-02 16:15:22 +0000
@@ -1755,16 +1755,22 @@
 
 
 class cmd_init_repository(Command):
-    """Create a shared repository to hold branches.
+    """Create a shared repository for branches to share storage space.
 
     New branches created under the repository directory will store their
-    revisions in the repository, not in the branch directory.
+    revisions in the repository, not in the branch directory.  For branches
+    with shared history, this reduces the amount of storage needed and 
+    speeds up the creation of new branches.
 
-    If the --no-trees option is used then the branches in the repository
-    will not have working trees by default.
+    If the --no-trees option is given then the branches in the repository
+    will not have working trees by default.  They will still exist as 
+    directories on disk, but they will not have separate copies of the 
+    files at a certain revision.  This can be useful for repositories that
+    store branches which are interacted with through checkouts or remote
+    branches, such as on a server.
 
     :Examples:
-        Create a shared repositories holding just branches::
+        Create a shared repository holding just branches::
 
             bzr init-repo --no-trees repo
             bzr init repo/trunk