Improve documentation: --logfile requires --daemon mode

Make this clearer, and document that --daemon is the wait
interval after completing a cycle before starting the next,
so that poll time count towards the interval.

Also take a note to make logfile more useful (used more often).

svn path=/branches/BRANCH_6-3/; revision=5216

3 files changed, 11 insertions, 4 deletions

diff --git a/NEWS b/NEWS
index b7f6fdb2..a3b10d3b 100644
--- a/NEWS
+++ b/NEWS
@@ -146,6 +146,8 @@ fetchmail 6.3.9 (not yet released):
   silently accept additional g=x permissions for compatibility with previous
   6.2.X and 6.3.X versions.
   Inconsistency (program 0710, manpage 0600) reported by Petr Uzel.
+* The --logfile documentation is now clearer about requiring detached daemon 
+  mode.
 
 # TRANSLATION UPDATES:
 * Polish (Jakub Bogusz)
diff --git a/TODO.txt b/TODO.txt
index f99a56d6..b5fdc152 100644
--- a/TODO.txt
+++ b/TODO.txt
@@ -114,6 +114,7 @@ questionable:
   but stuff it at the end
 - allow forcing RETR (RETR vs. TOP, fetchmail-users, drbob 2008-01-11)
 - use SASL?
+- make logfile more useful (redirect not only in daemon mode)
 
 DOCUMENTATION:
 - Add info whether Keywords are global, server or user keywords
diff --git a/fetchmail.man b/fetchmail.man
index 20b413d2..8e3b51f1 100644
--- a/fetchmail.man
+++ b/fetchmail.man
@@ -1154,7 +1154,9 @@ specified host and then sleeping for a given polling interval.
 There are several ways to make fetchmail work in daemon mode. On the
 command line, \fB\-\-daemon\ <interval>\fR or \fB\-d\ <interval>\fR
 option runs \fIfetchmail\fR in daemon mode.  You must specify a numeric
-argument which is a polling interval in seconds.
+argument which is a polling interval (time to wait after completing a 
+whole poll cycle with the last server and before starting the next poll 
+cycle with the first server) in seconds.
 .PP
 Example: simply invoking
 .IP
@@ -1162,8 +1164,9 @@ fetchmail \-d 900
 .PP
 will, therefore, poll all the hosts described in your
 .I ~/.fetchmailrc
-file (except those explicitly excluded with the 'skip' verb) once
-every 15 minutes.
+file (except those explicitly excluded with the 'skip' verb) a bit less 
+often than once every 15 minutes (exactly: 15 minutes + time that the 
+poll take)
 .PP
 It is also possible to set a polling interval
 in your \fI~/.fetchmailrc\fR file by saying 'set\ daemon\ <interval>',
@@ -1202,7 +1205,8 @@ The
 or
 .B \-\-logfile <filename>
 option (keyword: set logfile) is only effective when fetchmail is
-detached. Note that the logfile must exist BEFORE fetchmail is run, you
+detached and in daemon mode. Note that the logfile must exist BEFORE 
+fetchmail is run, you
 can use the
 .BR touch (1)
 command with the filename as its sole argument to create it.