From 09dc2d2ee5145e8ed3cce0debfca8eccea91b383 Mon Sep 17 00:00:00 2001 From: Matthias Andree Date: Wed, 17 May 2006 13:46:37 +0000 Subject: Revise --flush description, suggested by Frederic Marchal. svn path=/branches/BRANCH_6-3/; revision=4844 --- NEWS | 2 ++ fetchmail.man | 18 +++++++++--------- 2 files changed, 11 insertions(+), 9 deletions(-) diff --git a/NEWS b/NEWS index a5c07bb9..603c34a0 100644 --- a/NEWS +++ b/NEWS @@ -76,6 +76,8 @@ fetchmail 6.3.5 (not yet released): Found by Dan Fandrich. * Make IMAP4 IDLE work on servers that do not update RECENT counts. Reported by Lars Tewes. +* Fix --flush description in the manual page, fetchmail does not mark messages + seen unless it has successfully delivered them. Suggested by Frederic Marchal. # CHANGES: * Rename all fetchmail-internal lock_* functions to fm_lock_*. Obsoletes diff --git a/fetchmail.man b/fetchmail.man index 1fc8830d..b2e7b1e5 100644 --- a/fetchmail.man +++ b/fetchmail.man @@ -5,7 +5,7 @@ .\" .\" For license terms, see the file COPYING in this directory. .\" -.TH fetchmail 1 "fetchmail 6.3.4" "fetchmail" "fetchmail reference manual" +.TH fetchmail 1 "fetchmail 6.3.5" "fetchmail" "fetchmail reference manual" .SH NAME fetchmail \- fetch mail from a POP, IMAP, ETRN, or ODMR-capable server @@ -203,15 +203,15 @@ you have specified a default of \fBkeep\fR in your .B \-F | \-\-flush POP3/IMAP only. This is a dangerous option and can cause mail loss when used improperly. It deletes old (seen) messages from the mailserver -before retrieving new messages. Warning: This can cause mail loss if +before retrieving new messages. \fBWarning:\fR This can cause mail loss if you check your mail with other clients than fetchmail, and cause -fetchmail to delete a message it had never fetched before. Similarly, 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. You -should probably not use this option in your configuration file. What you -probably want is the default setting: if you don't specify '\-k', then -fetchmail will automatically delete messages after successful -delivery. This option does not work with ETRN and ODMR. +fetchmail to delete a message it had never fetched before. It can also +cause mail loss if the mail server marks the message seen after +retrieval (IMAP2 servers). You should probably not use this option in your +configuration file. If you use it with POP3, you must use the 'uidl' +option. What you probably want is the default setting: if you don't +specify '\-k', then fetchmail will automatically delete messages after +successful delivery. .TP .B \-\-limitflush POP3/IMAP only, since version 6.3.0. Delete oversized messages from the -- cgit v1.2.3