aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMatthias Andree <matthias.andree@gmx.de>2006-05-17 13:46:37 +0000
committerMatthias Andree <matthias.andree@gmx.de>2006-05-17 13:46:37 +0000
commit09dc2d2ee5145e8ed3cce0debfca8eccea91b383 (patch)
tree511a18e74032501edf711c6dcf92f8e66b3705f3
parent99a6c435e8a24f72ec3cdb8d39c98a180ceb2b49 (diff)
downloadfetchmail-09dc2d2ee5145e8ed3cce0debfca8eccea91b383.tar.gz
fetchmail-09dc2d2ee5145e8ed3cce0debfca8eccea91b383.tar.bz2
fetchmail-09dc2d2ee5145e8ed3cce0debfca8eccea91b383.zip
Revise --flush description, suggested by Frederic Marchal.
svn path=/branches/BRANCH_6-3/; revision=4844
-rw-r--r--NEWS2
-rw-r--r--fetchmail.man18
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