From: Evan Hunt <each@isc.org>
Date: Fri, 21 Feb 2014 16:33:17 +0000 (-0800)
Subject: [master] delve man page improvements
X-Git-Tag: v9.10.0b1~16
X-Git-Url: http://git.ipfire.org/gitweb/index.cgi?a=commitdiff_plain;h=f0f3f595b196744a498ee72f14f797421c07d693;p=thirdparty%2Fbind9.git

[master] delve man page improvements
---

diff --git a/bin/delve/delve.docbook b/bin/delve/delve.docbook
index 12ff996ba4a..75630b863a6 100644
--- 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,