Rev 4858: Update docs for init-repo (by nmb) in http://bazaar.launchpad.net/~jameinel/bzr/2.1.0b4-doc-updates

[John Arbash Meinel]

At http://bazaar.launchpad.net/~jameinel/bzr/2.1.0b4-doc-updates

------------------------------------------------------------
revno: 4858 [merge]
revision-id: john at arbash-meinel.com-20091202231410-hypklxtcjhetcd08
parent: john at arbash-meinel.com-20091202231315-kmszt02ozehsmd72
parent: nmb at wartburg.edu-20091202153716-2do7p7yfjx5iaa7a
committer: John Arbash Meinel <john at arbash-meinel.com>
branch nick: 2.1.0b4-doc-updates
timestamp: Wed 2009-12-02 17:14:10 -0600
message:
  Update docs for init-repo (by nmb)
modified:
  bzrlib/builtins.py             builtins.py-20050830033751-fc01482b9ca23183
-------------- next part --------------
=== modified file 'bzrlib/builtins.py'
--- a/bzrlib/builtins.py	2009-12-02 15:56:18 +0000
+++ b/bzrlib/builtins.py	2009-12-02 23:14:10 +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