Documentation updates.

svn path=/trunk/; revision=3803

3 files changed, 28 insertions, 14 deletions

diff --git a/NEWS b/NEWS
index 58a1221c..a3710f74 100644
--- a/NEWS
+++ b/NEWS
@@ -11,6 +11,7 @@
   of RFC2177 IDLE.
 * Jason Tishler's fix patch for Cygwin.
 * Spanish and Polish translations updated.
+* Support ssh-style authentication in POP3
 
 fetchmail-6.2.1 (Tue Jan 14 08:17:19 EST 2003), 22219 lines:
 
diff --git a/fetchmail.man b/fetchmail.man
index 7322e945..ce90f441 100644
--- a/fetchmail.man
+++ b/fetchmail.man
@@ -164,7 +164,8 @@ you have specified a default of \fBkeep\fR in your
 .B \-F | \-\-flush
 POP3/IMAP only.  Delete old (previously retrieved) messages from the mailserver
 before retrieving new messages. This option does not work with ETRN or
-ODMR.
+ODMR.  In combination with the --limit option, --flush can be used to 
+delete oversized messages waiting on the server.
 Warning: if your local MTA hangs and fetchmail is aborted, the next
 time you run fetchmail, it will delete mail that was never delivered to you.
 What you probably want is the default setting: if you don't specify `-k', then
@@ -437,17 +438,18 @@ MAILBOXES below apply.
 .SS Resource Limit Control Options
 .TP
 .B \-l <maxbytes> | \-\-limit <maxbytes>
-(Keyword: limit)
-Takes a maximum octet size argument.  Messages larger than this size
-will not be fetched and will be left on the server (in foreground
-sessions, the progress messages will note that they are "oversized").
-If the fetch protocol permits (in particular, under IMAP or POP3
-without the fetchall option) the message will not be marked seen An
-explicit --limit of 0 overrides any limits set in your run control
-file. This option is intended for those needing to strictly control
-fetch time due to expensive and variable phone rates.  In daemon mode,
-oversize notifications are mailed to the calling user (see the
---warnings option).  This option does not work with ETRN or ODMR.
+(Keyword: limit) Takes a maximum octet size argument.  Messages larger
+than this size will not be fetched and will be left on the server (in
+foreground sessions, the progress messages will note that they are
+"oversized").  If the fetch protocol permits (in particular, under
+IMAP or POP3 without the fetchall option) the message will not be
+marked seen An explicit --limit of 0 overrides any limits set in your
+run control file. This option is intended for those needing to
+strictly control fetch time due to expensive and variable phone rates.
+Combined with --flush, it can be used to delete oversized messages
+waiting on a server.  In daemon mode, oversize notifications are
+mailed to the calling user (see the --warnings option).  This option
+does not work with ETRN or ODMR.
 .TP
 .B \-w <interval> | \-\-warnings <interval>
 (Keyword: warnings)
@@ -2078,6 +2080,8 @@ BSMTP batch file could not be opened.
 Poll terminated by a fetch limit (see the --fetchlimit option).
 .IP 14
 Server busy indication.
+.IP 15
+Server timed out during an IMAP IDLE.
 .IP 23
 Internal error.  You should see a message on standard error with
 details.
diff --git a/todo.html b/todo.html
index 4a64aac1..76285949 100644
--- a/todo.html
+++ b/todo.html
@@ -19,7 +19,7 @@ content="Known bugs and to-do items in fetchmail" />
 <tr>
 <td width="30%">Back to <a href="/~esr">Eric's Home Page</a></td>
 <td width="30%" align="center">Up to <a href="/~esr/sitemap.html">Site Map</a></td>
-<td width="30%" align="right">$Date: 2003/02/28 11:02:51 $</td>
+<td width="30%" align="right">$Date: 2003/02/28 21:57:59 $</td>
 </tr>
 </table>
 
@@ -31,6 +31,15 @@ fetchmail is now pretty mature and I have many other projects, so I
 don't personally chase obscure or marginal problems. Help with any
 of these will be cheerfully accepted.</p>
 
+<p>Feature request from "Ralf G. R. Bergs" <rabe@RWTH-Aachen.DE> "When
+fetchmail downloads mail and Exim+SpamAssassin detecs an incoming
+message as spam, fetchmail tries to bounce it. Unfortunately it uses
+an incorrect hostname as part of the sender address (I've an internal
+LAN with private hostnames, plus an official IP address and hostname,
+and fetchmail picks the internal name of my host.) So I'd like to have
+a config statement that allows me to explicitly set a senderaddress
+for bounce messages."
+
 <p>POP3 can't presently distinguish a wedged or down server from an
 authentication failure. Possible fix: after issuing a PASS command.
 wait 300 (xx) seconds for a "-ERR" or a "+OK" . If nothing comes
@@ -71,7 +80,7 @@ reports.</p>
 <tr>
 <td width="30%">Back to <a href="/~esr">Eric's Home Page</a></td>
 <td width="30%" align="center">Up to <a href="/~esr/sitemap.html">Site Map</a></td>
-<td width="30%" align="right">$Date: 2003/02/28 11:02:51 $</td>
+<td width="30%" align="right">$Date: 2003/02/28 21:57:59 $</td>
 </tr>
 </table>