Add the WinXPSP2 alternate-localhost problem to the FAQ.

[sgt/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
 
@@ -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
-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
@@ -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}).
 
+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
@@ -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.
 
+(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
@@ -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
-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.
 
@@ -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}).
 
-\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
@@ -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
-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.
 
-\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
@@ -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.
 
-\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
@@ -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.
 
-\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
@@ -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.
 
-\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
@@ -627,7 +634,7 @@ configuration box (see \k{config-ssh-pty}).
 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.