From: jacob <jacob@cda61777-01e9-0310-a592-d414129be87e>
Date: Sat, 13 Mar 2010 14:47:14 +0000 (+0000)
Subject: Tweak description of dynamic port forwarding, and point people running into
X-Git-Url: https://git.distorted.org.uk/~mdw/sgt/putty/commitdiff_plain/68d5ba4699d75767d1b52d3041e2a7b6dd6d1b90

Tweak description of dynamic port forwarding, and point people running into
'Out of space for port forwardings' at it.


git-svn-id: svn://svn.tartarus.org/sgt/putty@8897 cda61777-01e9-0310-a592-d414129be87e
---

diff --git a/doc/errors.but b/doc/errors.but
index 40aded27..06c247c0 100644
--- 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 0b869c6a..96541d59 100644
--- 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 6d5d44ba..41616e90 100644
--- 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]/