aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--NEWS3
-rw-r--r--fetchmail.man15
2 files changed, 11 insertions, 7 deletions
diff --git a/NEWS b/NEWS
index 0703c319..c3f116b0 100644
--- a/NEWS
+++ b/NEWS
@@ -68,6 +68,9 @@ fetchmail-6.3.27 (not yet released, if ever):
* Convert most links from berlios.de to sourceforge.net.
* Report error to stderr, and exit, if --idle is combined with multiple
accounts.
+* Point to --idle from GENERAL OPERATION to clarify --idle and multiple
+ mailboxes do not mix. In response to Jeremy Chadwick's trouble 2014-11-19,
+ fetchmail-users mailing list.
# KNOWN BUGS AND WORKAROUNDS
(This section floats upwards through the NEWS file so it stays with the
diff --git a/fetchmail.man b/fetchmail.man
index 03f6233b..895e511a 100644
--- a/fetchmail.man
+++ b/fetchmail.man
@@ -145,9 +145,9 @@ the \fBfetchmailconf\fP program edits). Command-line options override
\fI~/.fetchmailrc\fP declarations.
.PP
Each server name that you specify following the options on the command
-line will be queried. If you don't specify any servers on the command
+line will be queried. If you do not specify any servers on the command
line, each 'poll' entry in your \fI~/.fetchmailrc\fP file will be
-queried.
+queried, unless the idle option is used, which see.
.PP
To facilitate the use of \fBfetchmail\fP in scripts and pipelines, it
returns an appropriate exit code upon termination -- see EXIT CODES
@@ -319,11 +319,12 @@ also: \-\-idfile.
(Keyword: idle, since before 6.0.0)
.br
Enable IDLE use (effective only with IMAP). Note that this works with
-only one folder at a given time. While the idle rcfile keyword had been
-supported for a long time, the \-\-idle command-line option was added in
-version 6.3.3. IDLE use means that fetchmail tells the IMAP server to
-send notice of new messages, so they can be retrieved sooner than would
-be possible with regular polls.
+only one account and one folder at a given time, other folders or
+accounts will not be polled when idle is in effect! While the idle rcfile
+keyword had been supported for a long time, the \-\-idle command-line
+option was added in version 6.3.3. IDLE use means that fetchmail tells
+the IMAP server to send notice of new messages, so they can be retrieved
+sooner than would be possible with regular polls.
.TP
.B \-P <portnumber> | \-\-service <servicename>
(Keyword: service) Since version 6.3.0.