From 7c861885d41500c38eb9caef02b8aa695b1cff4a Mon Sep 17 00:00:00 2001 From: Matthias Andree Date: Tue, 8 Jul 2008 13:33:55 +0000 Subject: 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 --- NEWS | 2 ++ TODO.txt | 1 + fetchmail.man | 12 ++++++++---- 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\ \fR or \fB\-d\ \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\ ', @@ -1202,7 +1205,8 @@ The or .B \-\-logfile 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. -- cgit v1.2.3