Work around surreal use of WM_COMMAND in radio button sets. Prevents

[PuTTY.git] / doc / plink.but

diff --git a/doc/plink.but b/doc/plink.but
index a50463941872b6b175c48662bca08a808b5e4d13..4b06e11ba995d12805c5144a9363e11f6e806104 100644 (file)
--- a/doc/plink.but
+++ b/doc/plink.but
@@ -1,4 +1,4 @@
-\versionid $Id: plink.but,v 1.12 2001/12/06 20:05:39 simon Exp $
+\versionid $Id: plink.but,v 1.14 2002/02/04 13:29:04 simon Exp $
 
 \C{plink} Using the command-line connection tool Plink
 
@@ -151,6 +151,9 @@ details:
 Then you can set up other programs to run this Plink command and
 talk to it as if it were a process on the server machine.
 
+You may also find it useful to use the \c{-batch} command-line
+option; see \k{plink-usage-options-batch}.
+
 \S{plink-usage-options} Options
 
 This section describes the command line options that Plink accepts.
@@ -200,6 +203,10 @@ on the Plink command line. This is \e{not recommended} for reasons
 of security. If you possibly can, we recommend you set up public-key
 authentication instead. See \k{pubkey} for details.
 
+Note that the \c{-pw} option only works when you are using the SSH
+protocol. Due to fundamental limitations of Telnet and Rlogin, these
+protocols do not support automated password authentication.
+
 \S2{plink-usage-options-user}\c{-l username} login with specified
 username
 
@@ -207,6 +214,18 @@ As described in \k{plink-usage-batch}, you can specify the user name
 to log in as on the remote server using the \c{-l} option. For
 example, \c{plink login.example.com -l fred}.
 
+\S2{plink-usage-options-batch}\c{-batch} avoid interactive prompts
+
+If you use the \c{-batch} option, Plink will never give an
+interactive prompt while establishing the connection. If the
+server's host key is invalid, for example (see \k{gs-hostkey}), then
+the connection will simply be abandoned instead of asking you what
+to do next.
+
+This may help Plink's behaviour when it is used in automated
+scripts: using \c{-batch}, if something goes wrong at connection
+time, the batch job will fail rather than hang.
+
 \S2{plink-usage-options-cmdfile} \c{-m filename} read command from a
 file