[master] delve man page improvements

diff --git a/bin/delve/delve.docbook b/bin/delve/delve.docbook
index 12ff996ba4ae4a680a883dc769f3b05cb75d3eaf..75630b863a6fdeafff27a24ab7733bf9e449a24e 100644 (file)
--- a/bin/delve/delve.docbook
+++ b/bin/delve/delve.docbook
@@ -20,7 +20,7 @@
 <refentry id="man.delve">
 
   <refentryinfo>
-    <date>February 12, 2014</date>
+    <date>February 21, 2014</date>
   </refentryinfo>
 
   <refmeta>
@@ -68,6 +68,11 @@
       <arg><option>-h</option></arg>
     </cmdsynopsis>
 
+    <cmdsynopsis>
+      <command>delve</command>
+      <arg><option>-v</option></arg>
+    </cmdsynopsis>
+
     <cmdsynopsis>
       <command>delve</command>
       <arg choice="opt" rep="repeat">queryopt</arg>
@@ -189,8 +194,9 @@
   <refsect1>
     <title>OPTIONS</title>
     <variablelist>
+
       <varlistentry>
-       <term>-a</term>
+       <term>-a <replaceable class="parameter">anchor-file</replaceable></term>
        <listitem>
          <para>
            Specifies a file from which to read DNSSEC trust anchors.
@@ -223,7 +229,7 @@
       </varlistentry>
 
       <varlistentry>
-       <term>-b</term>
+       <term>-b  <replaceable class="parameter">address</replaceable></term>
        <listitem>
          <para>
            Sets the source IP address of the query to
@@ -236,7 +242,7 @@
       </varlistentry>
 
       <varlistentry>
-       <term>-c</term>
+       <term>-c <replaceable class="parameter">class</replaceable></term>
        <listitem>
          <para>
            Sets the query class for the requested data. Currently,
@@ -247,61 +253,68 @@
       </varlistentry>
 
       <varlistentry>
-       <term>-i</term>
+       <term>-d <replaceable class="parameter">level</replaceable></term>
        <listitem>
          <para>
-           Insecure mode. This disables internal DNSSEC validation.
-           (Note, however, this does not set the CD bit on upstream
-           queries. If the server being queried is performing DNSSEC
-           validation, then it will not return invalid data; this
-           can cause <command>delve</command> to time out. When it
-           is necessary to examine invalid data to debug a DNSSEC
-           problem, use <command>dig +cd</command>.)
+           Set the systemwide debug level to <option>level</option>.
+           The allowed range is from 0 to 99.
+           The default is 0 (no debugging).
+           Debugging traces from <command>delve</command> become
+           more verbose as the debug level increases.
+           See the <option>+mtrace</option>, <option>+rtrace</option>,
+           and <option>+vtrace</option> options below for additional
+           debugging details.
          </para>
        </listitem>
       </varlistentry>
 
       <varlistentry>
-       <term>-m</term>
+       <term>-h</term>
        <listitem>
          <para>
-           Enables memory usage debugging.
+           Display the <command>delve</command> help usage output and exit.
          </para>
        </listitem>
       </varlistentry>
 
       <varlistentry>
-       <term>-p</term>
+       <term>-i</term>
        <listitem>
          <para>
-           Specifies a destination port to use for queries instead of
-           the standard DNS port number 53.  This option would be used
-           with a name server that has been configured to listen
-           for queries on a non-standard port number.
+           Insecure mode. This disables internal DNSSEC validation.
+           (Note, however, this does not set the CD bit on upstream
+           queries. If the server being queried is performing DNSSEC
+           validation, then it will not return invalid data; this
+           can cause <command>delve</command> to time out. When it
+           is necessary to examine invalid data to debug a DNSSEC
+           problem, use <command>dig +cd</command>.)
          </para>
        </listitem>
       </varlistentry>
 
       <varlistentry>
-       <term>-4</term>
+       <term>-m</term>
        <listitem>
          <para>
-           Forces <command>delve</command> to only use IPv4.
+           Enables memory usage debugging.
          </para>
        </listitem>
       </varlistentry>
 
       <varlistentry>
-       <term>-6</term>
+       <term>-p <replaceable class="parameter">port#</replaceable></term>
        <listitem>
          <para>
-           Forces <command>delve</command> to only use IPv6.
+           Specifies a destination port to use for queries instead of
+           the standard DNS port number 53.  This option would be used
+           with a name server that has been configured to listen
+           for queries on a non-standard port number.
          </para>
        </listitem>
       </varlistentry>
 
       <varlistentry>
-       <term>-q</term>
+       <term>-q <replaceable class="parameter">name</replaceable></term>
        <listitem>
          <para>
            Sets the query name to <parameter>name</parameter>.
@@ -315,7 +328,7 @@
       </varlistentry>
 
       <varlistentry>
-       <term>-t</term>
+       <term>-t <replaceable class="parameter">type</replaceable></term>
        <listitem>
          <para>
            Sets the query type to <parameter>type</parameter>, which
@@ -334,7 +347,16 @@
       </varlistentry>
 
       <varlistentry>
-       <term>-x</term>
+       <term>-v</term>
+       <listitem>
+         <para>
+           Print the <command>delve</command> version and exit.
+         </para>
+       </listitem>
+      </varlistentry>
+
+      <varlistentry>
+       <term>-x <replaceable class="parameter">addr</replaceable></term>
        <listitem>
          <para>
            Performs a reverse lookup, mapping an addresses to
@@ -349,6 +371,25 @@
          </para>
        </listitem>
       </varlistentry>
+
+      <varlistentry>
+       <term>-4</term>
+       <listitem>
+         <para>
+           Forces <command>delve</command> to only use IPv4.
+         </para>
+       </listitem>
+      </varlistentry>
+
+      <varlistentry>
+       <term>-6</term>
+       <listitem>
+         <para>
+           Forces <command>delve</command> to only use IPv6.
+         </para>
+       </listitem>
+      </varlistentry>
+
     </variablelist>
   </refsect1>
 
@@ -581,8 +622,8 @@
          <term><option>+[no]root[=ROOT]</option></term>
          <listitem>
            <para>
-             Indicates whether to perform conventional (non-
-             lookaside) DNSSEC validation, and if so, specifies the
+             Indicates whether to perform conventional (non-lookaside)
+             DNSSEC validation, and if so, specifies the
              name of a trust anchor.  The default is to validate using
              a trust anchor of "." (the root zone), for which there is
              a built-in key.  If specifying a different trust anchor,