Parcourir la source

[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.
Kean Johnston il y a 11 ans
Parent
commit
b0c660bc1b
1 fichiers modifiés avec 12 ajouts et 11 suppressions
  1. 12 11
      src/lib/log/logging.dox

+ 12 - 11
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