Tweak description of dynamic port forwarding, and point people running into

'Out of space for port forwardings' at it.

[originally from svn r8897]
[this svn revision also touched putty-wishlist]

diff --git a/doc/errors.but b/doc/errors.but
index 40aded27e1315e501c718d0cc08b4e3207282307..06c247c01e4c465ac35c2f4659b0af9aa5fa5546 100644 (file)
--- a/doc/errors.but
+++ b/doc/errors.but
@@ -69,6 +69,9 @@ We need to fix this (fixed-size buffers are almost always a mistake)
 but we haven't got round to it. If you actually have trouble with
 this, let us know and we'll move it up our priority list.
 
+If you're running into this limit, you may want to consider using
+dynamic port forwarding instead; see \k{using-port-forwarding}.
+
 \H{errors-cipher-warning} \q{The first cipher supported by the server is
 ... below the configured warning threshold}
 

diff --git a/doc/index.but b/doc/index.but
index 0b869c6a6d62d2b2b2fb7f28deb308247f4030cd..96541d5909b39c95e8f34b68d30bc218bac47e2f 100644 (file)
--- a/doc/index.but
+++ b/doc/index.but
@@ -843,3 +843,5 @@ saved sessions from
 \IM{logical host name} logical host name
 \IM{logical host name} host name, logical
 \IM{logical host name} host key, caching policy
+
+\IM{web browsers} web browser

diff --git a/doc/using.but b/doc/using.but
index 6d5d44ba439ff17d64282116f25576a3d5cc1ce4..41616e90cf537df0d01d9ec51d687bcf15fd57f4 100644 (file)
--- a/doc/using.but
+++ b/doc/using.but
@@ -427,15 +427,17 @@ number on the \e{server} (note that most servers will not allow you
 to use \I{privileged port}port numbers under 1024 for this purpose).
 
 An alternative way to forward local connections to remote hosts is
-to use \I{dynamic port forwarding}dynamic SOCKS proxying. For
-this, you will need to select the \q{Dynamic} radio button instead
-of \q{Local}, and then you should not enter anything into the
-\q{Destination} box (it will be ignored). This will cause PuTTY to
-listen on the port you have specified, and provide a SOCKS proxy
-service to any programs which connect to that port. So, in
-particular, you can forward other PuTTY connections through it by
-setting up the Proxy control panel (see \k{config-proxy} for
-details).
+to use \I{dynamic port forwarding}dynamic SOCKS proxying. In this
+mode, PuTTY acts as a SOCKS server, which SOCKS-aware programs can
+connect to and open forwarded connections to the destination of their
+choice, so this can be an alternative to long lists of static
+forwardings. To use this mode, you will need to select the \q{Dynamic}
+radio button instead of \q{Local}, and then you should not enter
+anything into the \q{Destination} box (it will be ignored). PuTTY will
+then listen for SOCKS connections on the port you have specified.
+Most \i{web browsers} can be configured to connect to this SOCKS proxy
+service; also, you can forward other PuTTY connections through it by
+setting up the Proxy control panel (see \k{config-proxy} for details).
 
 The source port for a forwarded connection usually does not accept
 connections from any machine except the \I{localhost}SSH client or
@@ -565,7 +567,7 @@ default protocol (see \k{using-cmdline-protocol}).
 
 For telnet sessions, the following alternative syntax is supported
 (this makes PuTTY suitable for use as a URL handler for \i{telnet
-URLs} in web browsers):
+URLs} in \i{web browsers}):
 
 \c putty.exe telnet://host[:port]/