Bugfixes

git-svn-id: file:///svnroot/mailfromd/trunk@1389 7a8a7f39-df28-0410-adc6-e0d955640f24

1 files changed, 44 insertions, 6 deletions

diff --git a/doc/mailfromd.texi b/doc/mailfromd.texi
index 1e88bb19..890def01 100644
--- a/doc/mailfromd.texi
+++ b/doc/mailfromd.texi
@@ -9196,12 +9196,50 @@ Overrides @code{#pragma option stack-trace}, which you are advised to
 use instead (@pxref{pragma stack-trace}).  @xref{tracing runtime
 errors}, for the detailed description of this feature.
 
-@opsummary{gacopyz-debug}
-@item --gacopyz-debug
-Instruct @command{gacopyz} library to produce a trace of its
-interaction with the @acronym{MTA}.  This option is meant to assist in
-developing @command{gacopyz}.  It issues huge amounts of information
-to log files.
+@opsummary{gacopyz-log}
+@item --gacopyz-log=@var{level}
+Set desired logging level for @command{gacopyz} library
+(@pxref{Gacopyz}).  There are five logging levels.  The following
+table lists them in order of decreasing priority:
+
+@table @asis
+@item fatal
+Log fatal errors.
+
+@item err
+Log error messages.
+
+@item warn
+Log warning messages.
+
+@item info
+Log informational messages.  In particular, this enables printing
+messages on each subprocess startup and termination, which look like
+that:
+
+@smallexample
+Apr 28 09:00:11 host mailfromd[9411]: connect from 192.168.10.1:50398
+Apr 28 09:00:11 host mailfromd[9411]: finishing connection
+@end smallexample
+
+This level can be useful for debugging your scripts.
+
+@item debug
+Log debugging information.  This level prints huge amounts of
+information, in particular it displays dumps of each Milter packet
+sent and received.
+
+@end table
+
+Although it is possible to set these levels independently of each
+other, it is seldom practical.  Therefore, the option
+@option{--gacopyz-log=@var{level}} enables all logging levels from
+@var{level} up.  For example, @option{--gacopyz-log=warn} enables
+log levels @samp{warn}, @samp{err} and @samp{fatal}.  It is the
+default.  If you need to trace each subprocess startup and shutdown,
+set @option{--gacopyz-log=info}.  Setting the logging level to
+@samp{debug} can be needed only for @command{Gacopyz} developers, to
+debug the protocol.
 
 @xref{Testing Filter Scripts}.