Added the via option.

svn path=/trunk/; revision=1179

1 files changed, 21 insertions, 3 deletions

diff --git a/fetchmail.man b/fetchmail.man
index e2b4ce62..792093fb 100644
--- a/fetchmail.man
+++ b/fetchmail.man
@@ -657,6 +657,7 @@ safely, or easily disable entries for hosts that are temporarily down.)
 .PP
 Legal server options are:
 
+    via
     protocol (or proto)
     port
     authenticate (or auth)
@@ -704,9 +705,26 @@ The 'folder' and 'smtphost' options can take a space- or
 comma-separated list of names following them.
 .PP
 All options correspond to the obvious command-line arguments, except
-the following: `interval', `aka', `is', `to', `dns'/`no dns', `password',
-\&`preconnect', `localdomains', `stripcr'/`no stripcr' ,
-\&`forcecr'/`no forcecr', `pass8bits'/`no pass8bits' and `no received'.
+the following: `via', `interval', `aka', `is', `to', `dns'/`no dns',
+\&`password', \&`preconnect', `localdomains', `stripcr'/`no stripcr' ,
+\&`forcecr'/`no forcecr', `pass8bits'/`no pass8bits' and `no
+received'.
+.PP
+The `via' option is for use with ssh, or if you want to have more
+than one configuration pointing at the same site.  If it is present,
+the string argument will be taken as the actual DNS name of the 
+mailserver host to query.  So, for example, you can say:
+
+.nf
+poll mailhost.net via localhost port 1234 with pop3:
+        preconnect "ssh -f -L 1234:mailhost.net:110 mailhost.net sleep 20 </dev/null >/dev/null";
+.fi
+
+This will override the argument of poll, which can simply be a
+distinct label for the configuration.  The poll name will still be the
+one you would give on the command line to explicitly query this host.
+It will also still be used as a possible match in multidrop mode, in
+case it is (as in this case) the real host name.
 .PP
 The `interval' option (which takes a numeric argument) allows you to poll a
 server less frequently than the basic poll interval.  If you say