Clarify that --loghost works only while detached; after report by Nico Golde.

svn path=/trunk/; revision=4405

diff --git a/NEWS b/NEWS
index 913ec635901d5f5abe3f4ebbc55db88f29a6d46c..0e717dde1fc4119ba3648b038c625a496f7444ea 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -275,6 +275,7 @@ fetchmail 6.3.0 (not yet released officially):
   hostname. Matthias Andree
 * Revise some error messages so they are less confusing. Sunil Shetye.
 * Man page: update --smtphost documentation. Matthias Andree
+* Man page: clarify --loghost works only while detached. Matthias Andree
 
 # INTERNAL CHANGES
 * Switched to automake. Matthias Andree.

diff --git a/fetchmail.man b/fetchmail.man
index 9e5e433a33c8606b0f84a594e7f0d39e4fd45a56..ccea5afb8fe588ce1d64938b70e145caf1bc3261 100644 (file)
--- a/fetchmail.man
+++ b/fetchmail.man
@@ -1046,11 +1046,11 @@ The
 .B \-L <filename>
 or
 .B \-\-logfile <filename>
-option (keyword: set logfile) allows you to redirect status messages
-emitted while detached into a specified logfile (follow the
-option with the logfile name).  The logfile is opened for append, so
-previous messages aren't deleted.  This is primarily useful for
-debugging configurations.
+option (keyword: set logfile) is only effective when fetchmail is
+detached. This option allows you to redirect status messages
+into a specified logfile (follow the option with the logfile name).  The
+logfile is opened for append, so previous messages aren't deleted.  This
+is primarily useful for debugging configurations.
 .PP
 The
 .B \-\-syslog
@@ -1892,12 +1892,14 @@ authentication.  These defaults may be overridden by later options.
 .PP
 There are some global option statements: 'set logfile'
 followed by a string sets the same global specified by --logfile.  A
-command-line --logfile option will override this.  Also, 'set daemon'
-sets the poll interval as --daemon does.  This can be overridden by a
-command-line --daemon option; in particular --daemon 0 can be used to
-force foreground operation. The 'set postmaster' statement sets the
-address to which multidrop mail defaults if there are no local
-matches.  Finally, 'set syslog' sends log messages to syslogd(8).
+command-line --logfile option will override this. Note that --logfile is
+only effective if fetchmail detaches itself from the terminal.  Also,
+'set daemon' sets the poll interval as --daemon does.  This can be
+overridden by a command-line --daemon option; in particular --daemon 0
+can be used to force foreground operation. The 'set postmaster'
+statement sets the address to which multidrop mail defaults if there are
+no local matches.  Finally, 'set syslog' sends log messages to
+syslogd(8).
 
 .SH INTERACTION WITH RFC 822
 When trying to determine the originating address of a message,