Malcolm Smith's patch to support CHAP (digest-based) authentication

[u/mdw/putty] / doc / using.but

diff --git a/doc/using.but b/doc/using.but
index 90a87d1..27a3d47 100644 (file)
--- a/doc/using.but
+++ b/doc/using.but
@@ -1,4 +1,4 @@
-\versionid $Id: using.but,v 1.22 2004/04/08 12:38:53 simon Exp $
+\versionid $Id: using.but,v 1.28 2004/08/19 12:58:14 jacob Exp $

 
 \C{using} Using PuTTY
 
 
 \C{using} Using PuTTY
 


@@ -93,9 +93,9 @@ value using the configuration box; see \k{config-scrollback}.
 \S{using-sysmenu} The \i{System menu}
 
 If you click the left mouse button on the icon in the top left
 \S{using-sysmenu} The \i{System menu}
 
 If you click the left mouse button on the icon in the top left

-corner of PuTTY's window, or click the right mouse button on the
-title bar, you will see the standard Windows system menu containing
-items like Minimise, Move, Size and Close.
+corner of PuTTY's terminal window, or click the right mouse button
+on the title bar, you will see the standard Windows system menu
+containing items like Minimise, Move, Size and Close.

 
 PuTTY's system menu contains extra program features in addition to
 the Windows standard options. These extra menu commands are
 
 PuTTY's system menu contains extra program features in addition to
 the Windows standard options. These extra menu commands are


@@ -273,6 +273,8 @@ then PuTTY cannot currently support it. If this is a problem for
 you, you should mail the PuTTY authors \#{FIXME} and give details
 (see \k{feedback}).
 
 you, you should mail the PuTTY authors \#{FIXME} and give details
 (see \k{feedback}).
 

+For more options relating to X11 forwarding, see \k{config-ssh-x11}.
+

 \H{using-port-forwarding} Using \i{port forwarding} in SSH
 
 The SSH protocol has the ability to forward arbitrary network
 \H{using-port-forwarding} Using \i{port forwarding} in SSH
 
 The SSH protocol has the ability to forward arbitrary network


@@ -364,6 +366,10 @@ available for local-to-remote forwarded ports; SSH1 is unable to
 support it for remote-to-local ports, while SSH2 can support it in
 theory but servers will not necessarily cooperate.
 
 support it for remote-to-local ports, while SSH2 can support it in
 theory but servers will not necessarily cooperate.
 

+(Note that if you're using Windows XP Service Pack 2, you may need
+to obtain a fix from Microsoft in order to use addresses like
+\cw{127.0.0.5} - see \k{faq-alternate-localhost}.)
+

 \H{using-rawprot} Making \i{raw TCP connections}
 
 A lot of \I{debugging Internet protocols}Internet protocols are
 \H{using-rawprot} Making \i{raw TCP connections}
 
 A lot of \I{debugging Internet protocols}Internet protocols are


@@ -446,8 +452,7 @@ tool.
 \I{saved sessions, loading from command line}The \c{-load} option
 causes PuTTY to load configuration details out of a saved session.
 If these details include a host name, then this option is all you
 \I{saved sessions, loading from command line}The \c{-load} option
 causes PuTTY to load configuration details out of a saved session.
 If these details include a host name, then this option is all you

-need to make PuTTY start a session (although Plink still requires an
-explicitly specified host name).
+need to make PuTTY start a session.

 
 You need double quotes around the session name if it contains spaces.
 
 
 You need double quotes around the session name if it contains spaces.
 


@@ -503,8 +508,8 @@ These options are equivalent to the username selection box in the
 Connection panel of the PuTTY configuration box (see
 \k{config-username}).
 
 Connection panel of the PuTTY configuration box (see
 \k{config-username}).
 

-\S2{using-cmdline-portfwd} \i\c{-L}, \i\c{-R} and \i\c{-D}: set up
-\i{port forwardings}
+\S2{using-cmdline-portfwd} \I{-L-upper}\c{-L}, \I{-R-upper}\c{-R}
+and \I{-D-upper}\c{-D}: set up \i{port forwardings}

 
 As well as setting up port forwardings in the PuTTY configuration
 (see \k{config-ssh-portfwd}), you can also set up forwardings on the
 
 As well as setting up port forwardings in the PuTTY configuration
 (see \k{config-ssh-portfwd}), you can also set up forwardings on the


@@ -549,12 +554,14 @@ command} box in the SSH panel of the PuTTY configuration box (see
 \k{config-command}). However, the \c{-m} option expects to be given
 a local file name, and it will read a command from that file. On
 most Unix systems, you can even put multiple lines in this file and
 \k{config-command}). However, the \c{-m} option expects to be given
 a local file name, and it will read a command from that file. On
 most Unix systems, you can even put multiple lines in this file and

-execute more than one command in sequence, or a whole shell script.
+execute more than one command in sequence, or a whole shell script;
+but this will not work on all servers (and is known not to work
+with certain \q{embedded} servers such as routers).

 
 This option is not available in the file transfer tools PSCP and
 PSFTP.
 
 
 This option is not available in the file transfer tools PSCP and
 PSFTP.
 

-\S2{using-cmdline-p} \i\c{-P}: specify a \i{port number}
+\S2{using-cmdline-p} \I{-P-upper}\c{-P}: specify a \i{port number}

 
 The \c{-P} option is used to specify the port number to connect to. If
 you have a Telnet server running on port 9696 of a machine instead of
 
 The \c{-P} option is used to specify the port number to connect to. If
 you have a Telnet server running on port 9696 of a machine instead of


@@ -581,7 +588,7 @@ 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.
 
 protocol. Due to fundamental limitations of Telnet and Rlogin, these
 protocols do not support automated password authentication.
 

-\S2{using-cmdline-agent} \i\c{-A} and \i\c{-a}: control \i{agent
+\S2{using-cmdline-agent} \I{-A-upper}\c{-A} and \i\c{-a}: control \i{agent

 forwarding}
 
 The \c{-A} option turns on SSH agent forwarding, and \c{-a} turns it
 forwarding}
 
 The \c{-A} option turns on SSH agent forwarding, and \c{-a} turns it


@@ -598,7 +605,7 @@ Auth panel of the PuTTY configuration box (see \k{config-ssh-agentfwd}).
 These options are not available in the file transfer tools PSCP and
 PSFTP.
 
 These options are not available in the file transfer tools PSCP and
 PSFTP.
 

-\S2{using-cmdline-x11} \i\c{-X} and \i\c{-x}: control \i{X11
+\S2{using-cmdline-x11} \I{-X-upper}\c{-X} and \i\c{-x}: control \i{X11

 forwarding}
 
 The \c{-X} option turns on X11 forwarding in SSH, and \c{-x} turns
 forwarding}
 
 The \c{-X} option turns on X11 forwarding in SSH, and \c{-x} turns


@@ -613,7 +620,7 @@ Tunnels panel of the PuTTY configuration box (see
 These options are not available in the file transfer tools PSCP and
 PSFTP.
 
 These options are not available in the file transfer tools PSCP and
 PSFTP.
 

-\S2{using-cmdline-pty} \i\c{-t} and \i\c{-T}: control
+\S2{using-cmdline-pty} \i\c{-t} and \I{-T-upper}\c{-T}: control

 \i{pseudo-terminal allocation}
 
 The \c{-t} option ensures PuTTY attempts to allocate a
 \i{pseudo-terminal allocation}
 
 The \c{-t} option ensures PuTTY attempts to allocate a


@@ -627,7 +634,7 @@ configuration box (see \k{config-ssh-pty}).
 These options are not available in the file transfer tools PSCP and
 PSFTP.
 
 These options are not available in the file transfer tools PSCP and
 PSFTP.
 

-\S2{using-cmdline-compress} \i\c{-C}: enable \i{compression}
+\S2{using-cmdline-compress} \I{-C-upper}\c{-C}: enable \i{compression}

 
 The \c{-C} option enables compression of the data sent across the
 network. This option is only meaningful if you are using SSH.
 
 The \c{-C} option enables compression of the data sent across the
 network. This option is only meaningful if you are using SSH.