[Savannah-cvs] administration/content/gnu-content/bzr index.txt

[Karl Berry]

CVSROOT:        /web/administration
Module name:    administration
Changes by:     Karl Berry <karl>       10/06/03 18:10:42

Modified files:
        content/gnu-content/bzr: index.txt 

Log message:
        attempt to improve wording, per 107118 and 107395

CVSWeb URLs:
http://web.cvs.savannah.gnu.org/viewcvs/administration/content/gnu-content/bzr/index.txt?cvsroot=administration&r1=1.8&r2=1.9

Patches:
Index: index.txt
===================================================================
RCS file: /web/administration/administration/content/gnu-content/bzr/index.txt,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -b -r1.8 -r1.9
--- index.txt   13 Jul 2008 20:39:11 -0000      1.8
+++ index.txt   3 Jun 2010 18:10:42 -0000       1.9
@@ -2,12 +2,30 @@
 
 <h4>Anonymous read-only access</h4>
 
+<p>The Bazaar repositories for projects use separate directories for
+each branch. You can see the branch names in the repository by pointing
+a web browser to:</p>
+
+<pre>http://bzr.<?php echo $project->getTypeBaseHost(). "/r/" . 
$project->getUnixName(); ?></pre>
+
+<ul>
+<li><p>For a repository with separate branch directories (<tt>trunk</tt>,
+<tt>devel</tt>, &hellip;), use:
+
+<pre>bzr branch http://bzr.<?php echo $project->getTypeBaseHost(). "/r/" . 
$project->getUnixName(); ?>/<i>branch</i></pre>
+
+where <i>branch</i> is the name of the branch you want.
+<p></p></li>
+
+<li>For a repository with only a top-level <tt>.bzr</tt> directory, use:
+
 <pre>bzr branch http://bzr.<?php echo $project->getTypeBaseHost(). "/r/" . 
$project->getUnixName(); ?></pre>
+</li>
 
-<p>Note: these paths are the default paths. Maybe the project is using a 
different layout.</p>
+</ul>
 
 
-<h4>Developper write access (ssh)</h4>
+<h4>Developer write access (ssh)</h4>
 
 <?php
 $username = user_getname();
@@ -17,6 +35,18 @@
 }
 ?>     
 
-<pre>bzr branch sftp://<?php echo $username ?>@bzr.<?php echo 
$project->getTypeBaseHost(). "/srv/bzr/" . $project->getUnixName(); ?></pre>
+<pre>bzr branch sftp://<?php echo $username ?>@bzr.<?php echo 
$project->getTypeBaseHost(). "/srv/bzr/" . $project->getUnixName(); 
?>/<i>branch</i></pre>
+
+<p>You may find it faster to just grab the entire repository and all its
+branches via scp or rsync, for example:</p>
 
-You can also use <code>scp</code> and <code>rsync</code> if need be.
+<pre>
+scp -r <?php echo $username ?>@bzr.<?php echo
+$project->getTypeBaseHost(). ":/srv/bzr/" . $project->getUnixName(); ?> 
emacs-bzr-repository emacs-bzr-repository
+</pre>
+
+<p>Afterwards, the directory <tt>emacs-bzr-repository</tt> will have all
+the data in its <tt>.bzr</tt> subdirectory, and each branch will also be
+a subdirectory (empty except for its own <tt>.bzr</tt> subdirectory).
+To fill out a branch's working tree, run <tt>cd branch && bzr
+checkout</tt>.</p>