===================================================================
RCS file: /cvsrepo/anoncvs/cvs/www/anoncvs.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- www/anoncvs.html	1997/04/09 14:01:44	1.11
+++ www/anoncvs.html	1997/04/20 01:14:48	1.12
@@ -56,6 +56,9 @@
 of the read-write CVS repository are mirrored often. To use one,
 set your <strong>CVSROOT</strong> environment variable to one of
 the following values:
+<p>
+<strong>Please see the note about using ssh vs. rsh below!</strong>
+<p>
 <ul>
 <p>
 <li><strong>CVSROOT=anoncvs@anoncvs.usa.openbsd.org:/cvs</strong><br>
@@ -144,11 +147,11 @@
 % setenv CVSROOT anoncvs@anoncvs.usa.openbsd.org:/cvs
 % cd /tmp
 % cvs get src/sys/arch/sparc
-[copies the files from the repository to your machine]
+    [copies the files from the repository to your machine]
 % cvs log src/sys/arch/sparc/sparc/locore.s
-[shows the commit log for the chosen file ]
+    [shows the commit log for the chosen file ]
 % cvs diff -bc -r1.1 -r1.5 src/sys/arch/sparc/sparc/locore.s
-[shows the changes between revisions 1.1 and rev 1.5]
+    [shows the changes between revisions 1.1 and rev 1.5]
 </pre>
 </p>
 
@@ -160,10 +163,10 @@
 # cd /usr
 # cvs -q get -PA src
 </pre>
-or similarily later on he might try
+or similarily later on he might try:
 <pre>
-# cd /usr/src
-# cvs -q up -PAd
+# cd /usr
+# cvs -q up -PAd src
 </pre>
 Everytime you ran this it would syncronize your /usr/src tree. It would
 not destroy any of your local changes, rather it would attempt to merge
@@ -174,11 +177,28 @@
 </p>
 
 <p>
+or to make a diff of a locally patched module (here cd.c) to include with
+a bug report:
+<pre>
+# cd /usr
+# cvs diff -u src/sys/scsi/cd.c > /tmp/patch
+</pre>
+</p>
+
+<p>
 The CVS man page (included with the CVS sources) has much more
 information about how CVS can be used.
 </p>
 
 <p>
+<strong>Warning:</strong>
+When using cvs you should take care that your current directory is either
+the root of the tree you're referencing or in a separate place such as /tmp.
+Some commands such as "get" can create an arbitrary sub-tree in the current
+directory, and a subsequent update will recursively flesh out this sub-tree.
+</p>
+
+<p>
 The anoncvs service gives fledgling developers a chance to learn CVS
 operation and get thoroughly involved in the development process
 before getting "commit" access -- as a result of showing useful
@@ -188,10 +208,22 @@
 </p>
 
 <p>
-The CVS client uses rsh to talk to the CVS server.  If some local
-security measure like a firewall (or imperfect protocol emulators
-like slirp) prevents you from using rsh, you may be able to use
-<a href=http://www.cs.hut.fi/ssh>ssh</a> instead.  In this case,
+<strong>Anoncvs rsh vs. ssh</strong>
+<br>
+By default, the CVS client uses rsh to talk to the CVS server.  Many
+of the CVS sites no longer supprt rsh for security reasons or a local
+problem like a firewall or imperfect protocol emulator such as slirp
+may prevent you from using rsh.
+The alternative is a to use a "secure shell" connection using
+<a href=http://www.cs.hut.fi/ssh>ssh</a>.  This is a commerical product
+offered by <a href=http://www.ssh.fi>SSH Communications Security Ltd</a>,
+however they make a free unix version available that can be easily
+installed under OpenBSD.  You can download the unix version from
+<a href=http://www.cs.hut.fi/ssh>http://www.cs.hut.fi/ssh</a> or one of
+the mirrors listed there.
+</p>
+<p>
+In this case,
 one sets the environment variable <strong>CVS_RSH</strong> to point
 to ssh (typically <strong>/usr/local/bin/ssh</strong>). To reduce the
 performance hit the anoncvs server would take it is recommended (and
@@ -246,7 +278,7 @@
 <hr>
 <a href=index.html><img src=back.gif border=0 alt=OpenBSD></a> 
 <a href=mailto:www@openbsd.org>www@openbsd.org</a>
-<br><small>$OpenBSD: anoncvs.html,v 1.11 1997/04/09 14:01:44 michaels Exp $</small>
+<br><small>$OpenBSD: anoncvs.html,v 1.12 1997/04/20 01:14:48 grr Exp $</small>
 
 </body>
 </html>