Prelim. CVS/plink howto

[originally from svn r930]

diff --git a/doc/plink.but b/doc/plink.but
index 56237d2d9f77ec7866156da5291278f81c31404e..9474955ee07f6306e85a63a85d4b9fbc94ad60d1 100644 (file)
--- a/doc/plink.but
+++ b/doc/plink.but
@@ -1,4 +1,4 @@
-\versionid: $Id: plink.but,v 1.2 2001/02/04 15:47:01 owen Exp $
+\versionid $Id: plink.but,v 1.3 2001/02/07 11:20:15 owen Exp $
 
 \C{plink} Using the command-line connection tool Plink
 
@@ -13,8 +13,8 @@
 
 \# Give instructions on how to set up Plink with CVS
 
-Plink (PuTTY Link), is a command-line connection tool similar to UNIX
-\c{ssh}.  It is probably not what you want if you want to run an
+\i{Plink} (PuTTY Link), is a command-line connection tool similar to
+UNIX \c{ssh}.  It is probably not what you want if you want to run an
 interactive session in a console window.
 
 \H{plink-starting} Starting Plink
@@ -63,9 +63,25 @@ These are the command line options that Plink accepts.
 
 \H{plink-pubkey} Public key authentication
 
-\H{plink-batch} Using Plink in batch files and scripts
+\H{plink-batch} Using Plink in \i{batch files} and \i{scripts}
 
-\H{plink-cvs} Using Plink with CVS
+\H{plink-cvs} Using Plink with \i{CVS}
+
+To use Plink with CVS, you need to do something like the following:
+
+\c set CVS_RSH=\path\to\plink.exe
+\c cvs -d :ext:user@hostname:/path/to/repository co module
+
+This should work, provided the command \c{plink hostname -l user} works
+without requiring a password.
+
+You can arrange for that to be the case by:
+
+\b running Pageant (see \k{pageant}) and putting a valid RSA key in it
+
+\b using a saved session name in place of \c{hostname}, and having that saved
+   session specify a valid RSA key. (If you do this, you can also leave out
+   \c{user@}, provided you specify it in the saved session.)
 
 \H{plink-whatelse} Using Plink with... ?