[trac1011] some docbook formatting for new content

This needs to be indented correctly still.

doc/guide/bind10-guide.xml

@@ -1603,25 +1603,20 @@ then change those defaults with config set Resolver/forward_addresses[0]/address
 
         </para>
 
-        <para>
-
-name (string)
-
-        </para>
-
-        <para>
+        <section>
+          <title>name (string)</title>
 
+          <para>
 	  Each logger in the system has a name, the name being that
 	  of the component using it to log messages. For instance,
 	  if you want to configure logging for the resolver module,
 	  you add an entry for a logger named 'Resolver'. This
 	  configuration will then be used by the loggers in the
 	  Resolver module, and all the libraries used by it.
+              </para>
 
 <!-- TODO: how to know these names? -->
 
-        </para>
-
         <para>
 
 	  If you want to specify logging for one specific library
@@ -1691,11 +1686,10 @@ name (string)
 
         </para>
 
-        <para>
+        </section>
 
-severity (string)
-
-        </para>
+        <section>
+          <title>severity (string)</title>
 
         <para>
 
@@ -1708,14 +1702,39 @@ severity (string)
 	  Each message is logged with an associated severity which
 	  may be one of the following (in descending order of
 	  severity):
+        </para>
 
+<itemizedlist>
+<listitem>
+<simpara>
     FATAL
+</simpara>
+</listitem>
+
+<listitem>
+<simpara>
     ERROR
+</simpara>
+</listitem>
+
+<listitem>
+<simpara>
     WARN
+</simpara>
+</listitem>
+
+<listitem>
+<simpara>
     INFO
-    DEBUG
+</simpara>
+</listitem>
 
-        </para>
+<listitem>
+<simpara>
+    DEBUG
+</simpara>
+</listitem>
+</itemizedlist>
 
         <para>
 
@@ -1729,11 +1748,10 @@ severity (string)
 
         </para>
 
-        <para>
+        </section>
 
-output_options (list)
-
-        </para>
+        <section>
+          <title>output_options (list)</title>
 
         <para>
 
@@ -1749,11 +1767,10 @@ output_options (list)
 
         </para>
 
-        <para>
+        </section>
 
-debuglevel (integer)
-
-        </para>
+        <section>
+          <title>debuglevel (integer)</title>
 
         <para>
 
@@ -1774,11 +1791,10 @@ debuglevel (integer)
 
         </para>
 
-        <para>
-
-additive (true or false)
+        </section>
 
-        </para>
+        <section>
+          <title>additive (true or false)</title>
 
         <para>
 
@@ -1796,6 +1812,8 @@ additive (true or false)
 
       </section>
 
+      </section>
+
       <section>
         <title>Output Options</title>
 
@@ -1807,31 +1825,45 @@ additive (true or false)
 
         </para>
 
+        <section>
+          <title>destination (string)</title>
+
         <para>
 
-destination (string)
+          The destination is the type of output. It can be one of:
 
         </para>
 
-        <para>
+<!-- TODO: itemized list -->
 
-          The destination is the type of output. It can be one of:
+<itemizedlist>
 
-        </para>
+<listitem>
+<simpara>
+    console
+</simpara>
+</listitem>
 
-        <para>
+<listitem>
+<simpara>
+   file
+</simpara>
+</listitem>
 
-    * console
-    * file
-    * syslog
+<listitem>
+<simpara>
+    syslog
+</simpara>
+</listitem>
 
-        </para>
+</itemizedlist>
 
-        <para>
 
-output (string)
 
-        </para>
+        </section>
+
+        <section>
+          <title>output (string)</title>
 
         <para>
 
@@ -1840,30 +1872,38 @@ output (string)
 
         </para>
 
-        <para>
-
-    * destination is 'console'
+        <variablelist>
 
+          <varlistentry>
+            <term>destination is 'console'</term>
+            <listitem>
+              <simpara>
       'output' must be one of 'stdout' (messages printed to standard output) or 'stderr' (messages printed to standard error).
+              </simpara>
+            </listitem>
+          </varlistentry>
 
-        </para>
-
-        <para>
-
-    * destination is 'file'
 
+          <varlistentry>
+            <term>destination is 'file'</term>
+            <listitem>
+              <simpara>
       The value of output is interpreted as a file name; log messages will be appended to this file.
+              </simpara>
+            </listitem>
+          </varlistentry>
 
 
-        </para>
-
-        <para>
-
-    * destination is 'syslog'
-
+          <varlistentry>
+            <term>destination is 'syslog'</term>
+            <listitem>
+              <simpara>
       The value of output is interpreted as the syslog facility (e.g. 'local0') that should be used for log messages.
+              </simpara>
+            </listitem>
+          </varlistentry>
 
-        </para>
+        </variablelist>
 
         <para>
 
@@ -1871,11 +1911,10 @@ output (string)
 
         </para>
 
-        <para>
+        </section>
 
-flush (true of false)
-
-        </para>
+        <section>
+          <title>flush (true of false)</title>
 
         <para>
 
@@ -1886,11 +1925,10 @@ flush (true of false)
 
         </para>
 
-        <para>
-
-maxsize (integer)
+        </section>
 
-        </para>
+        <section>
+          <title>maxsize (integer)</title>
 
         <para>
 
@@ -1908,11 +1946,10 @@ maxsize (integer)
 
         </para>
 
-        <para>
+        </section>
 
-maxver (integer)
-
-        </para>
+        <section>
+          <title>maxver (integer)</title>
 
         <para>
 
@@ -1921,6 +1958,7 @@ maxver (integer)
 	  if 'file'.
 
       </para>
+        </section>
 
       </section>