|
@@ -2809,34 +2809,43 @@ TODO; there's a ticket to determine these levels, see #1074
|
|
|
<varlistentry>
|
|
<varlistentry>
|
|
|
<term><option>destination</option> is <quote>console</quote></term>
|
|
<term><option>destination</option> is <quote>console</quote></term>
|
|
|
<listitem>
|
|
<listitem>
|
|
|
- <simpara>
|
|
|
|
|
|
|
+ <para>
|
|
|
The value of output must be one of <quote>stdout</quote>
|
|
The value of output must be one of <quote>stdout</quote>
|
|
|
(messages printed to standard output) or
|
|
(messages printed to standard output) or
|
|
|
<quote>stderr</quote> (messages printed to standard
|
|
<quote>stderr</quote> (messages printed to standard
|
|
|
error).
|
|
error).
|
|
|
- </simpara>
|
|
|
|
|
|
|
+ </para>
|
|
|
|
|
+ <para>
|
|
|
|
|
+ Note: if output is set to <quote>stderr</quote> and a lot of
|
|
|
|
|
+ messages are produced in a short time (e.g. if the logging
|
|
|
|
|
+ level is set to DEBUG), you may occasionally see some messages
|
|
|
|
|
+ jumbled up together. This is due to a combination of the way
|
|
|
|
|
+ that messages are written to the screen and the unbuffered
|
|
|
|
|
+ nature of the standard error stream. If this occurs, it is
|
|
|
|
|
+ recommended that output be set to <quote>stdout</quote>.
|
|
|
|
|
+ </para>
|
|
|
</listitem>
|
|
</listitem>
|
|
|
</varlistentry>
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
<varlistentry>
|
|
|
<term><option>destination</option> is <quote>file</quote></term>
|
|
<term><option>destination</option> is <quote>file</quote></term>
|
|
|
<listitem>
|
|
<listitem>
|
|
|
- <simpara>
|
|
|
|
|
|
|
+ <para>
|
|
|
The value of output is interpreted as a file name;
|
|
The value of output is interpreted as a file name;
|
|
|
log messages will be appended to this file.
|
|
log messages will be appended to this file.
|
|
|
- </simpara>
|
|
|
|
|
|
|
+ </para>
|
|
|
</listitem>
|
|
</listitem>
|
|
|
</varlistentry>
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
<varlistentry>
|
|
|
<term><option>destination</option> is <quote>syslog</quote></term>
|
|
<term><option>destination</option> is <quote>syslog</quote></term>
|
|
|
<listitem>
|
|
<listitem>
|
|
|
- <simpara>
|
|
|
|
|
|
|
+ <para>
|
|
|
The value of output is interpreted as the
|
|
The value of output is interpreted as the
|
|
|
<command>syslog</command> facility (e.g.
|
|
<command>syslog</command> facility (e.g.
|
|
|
<emphasis>local0</emphasis>) that should be used
|
|
<emphasis>local0</emphasis>) that should be used
|
|
|
for log messages.
|
|
for log messages.
|
|
|
- </simpara>
|
|
|
|
|
|
|
+ </para>
|
|
|
</listitem>
|
|
</listitem>
|
|
|
</varlistentry>
|
|
</varlistentry>
|
|
|
|
|
|
Stephen Morris