BIND 10 trac2566, updated. b0c660bc1b3dc12f92125c55e633bde7048f2414 [2566] Use code block markers in some of the definition lists.
BIND 10 source code commits
bind10-changes at lists.isc.org
Sat Jan 25 12:06:32 UTC 2014
The branch, trac2566 has been updated
via b0c660bc1b3dc12f92125c55e633bde7048f2414 (commit)
from 99f167be3a1849333e527046104b42c13ee83e0d (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
commit b0c660bc1b3dc12f92125c55e633bde7048f2414
Author: Kean Johnston <kean at isc.org>
Date: Sat Jan 25 14:04:16 2014 +0200
[2566] Use code block markers in some of the definition lists.
Where a definition list is used to discuss function parameters, use
the <code> modifier to make it more clear that the definition
term is discussing a variable in the function signature mentioned
above the definition list.
-----------------------------------------------------------------------
Summary of changes:
src/lib/log/logging.dox | 23 ++++++++++++-----------
1 file changed, 12 insertions(+), 11 deletions(-)
-----------------------------------------------------------------------
diff --git a/src/lib/log/logging.dox b/src/lib/log/logging.dox
index 428e181..f4d022c 100644
--- a/src/lib/log/logging.dox
+++ b/src/lib/log/logging.dox
@@ -613,11 +613,11 @@ void isc::log::initLogger(const std::string& root,
@endcode
Arguments are:
<dl>
-<dt>root</dt>
+<dt><code>root</code></dt>
<dd>Name of the root logger. This should be the name of the program
(e.g. "b10-auth") and is used when configuring logging.</dd>
-<dt>severity</dt>
+<dt><code>severity</code></dt>
<dd>Default severity that the program will start logging with. Although
this may be overridden when the program obtains its configuration from
the configuration database, this is the severity that it used until then.
@@ -635,19 +635,19 @@ isc::log::NONE
(The level NONE may be used to disable logging.)
</dd>
-<dt>dbglevel</dt>
+<dt><code>dbglevel</code></dt>
<dd>The debug log level is only interpreted when the severity is
isc::log::DEBUG and is an integer ranging from 0 to 99. 0 should be
used for the highest-level debug messages and 99 for the lowest-level
(and typically more verbose) messages.</dd>
-<dt>file</dt>
+<dt><code>file</code></dt>
<dd>The name of a local message file. This will be read and its
definitions used to replace the compiled-in text of the messages.
The default value of NULL indicates that no local message file is
supplied.</dd>
-<dt>buffer</dt>
+<dt><code>buffer</code></dt>
<dd>If set to true, initial log messages will be internally buffered,
until the first time a logger specification is processed. This
way the program can use logging before even processing its logging
@@ -658,7 +658,8 @@ SHOULD call one of the @ref isc::log::LoggerManager::process() calls.
(If you are using the built-in logging configuration handling in @ref
isc::config::ModuleCCSession, this is automatically handled.) If the
program exits before this is done, all log messages are dumped in a raw
-format to stdout (so that no messages get lost).</dd> </dl>
+format to stdout (so that no messages get lost).</dd>
+</dl>
@subsubsection logInitializationCppVariant2 Variant #2, Used by Unit Tests
@code
@@ -711,23 +712,23 @@ isc.log.init(name, severity, debuglevel, file, buffer)
@endcode
<dl>
-<dt>name</dt>
+<dt><code>name</code></dt>
<dd>String giving the name of the root logger. This is the only mandatory
argument, the rest are optional.</dd>
-<dt>severity</dt>
+<dt><code>severity</code></dt>
<dd>The severity, and is one of the strings "DEBUG", INFO" etc.
The default is "INFO".</dd>
-<dt>debuglevel</dt>
+<dt><code>debuglevel</code></dt>
<dd>Debug level, an integer between 0 and 99. A default value of 0 will
be used if this is not specified.</dd>
-<dt>file</dt>
+<dt><code>file</code></dt>
<dd>Name of the external message file (if present). By default, no
external message file is used.</dd>
-<dt>buffer</dt>
+<dt><code>buffer</code></dt>
<dd>If set to true, initial log messages will be internally buffered,
until the first time a logger specification is processed. This
way the program can use logging before even processing its logging
More information about the bind10-changes
mailing list