[deployment-guide/comm-rel: 400/727] Updated the Additional Resources section.

Jaromir Hradilek jhradile at fedoraproject.org
Tue Oct 19 12:58:22 UTC 2010


commit 9baf4564ead1fff57db2c88bfda1c4033ce8ccac
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Tue Aug 17 10:36:32 2010 +0200

    Updated the Additional Resources section.

 en-US/The_BIND_DNS_Server.xml |  178 ++++++++++++++++-------------------------
 1 files changed, 68 insertions(+), 110 deletions(-)
---
diff --git a/en-US/The_BIND_DNS_Server.xml b/en-US/The_BIND_DNS_Server.xml
index c1b42af..fb64b1b 100644
--- a/en-US/The_BIND_DNS_Server.xml
+++ b/en-US/The_BIND_DNS_Server.xml
@@ -1862,10 +1862,6 @@ $TTL 86400
   </section>
   <section id="s1-bind-additional-resources">
     <title>Additional Resources</title>
-    <indexterm>
-      <primary>BIND</primary>
-      <secondary>additional resources</secondary>
-    </indexterm>
     <para>
       The following sources of information provide additional resources regarding BIND.
     </para>
@@ -1876,134 +1872,96 @@ $TTL 86400
         <secondary>additional resources</secondary>
         <tertiary>installed documentation</tertiary>
       </indexterm>
-      <!-- RHEL5:   ddomingo at redhat.com: took out main <itemizedlist>  --><!-- RHEL5:        <itemizedlist>
-        <listitem> -->
       <para>
-        BIND features a full range of installed documentation covering many different topics, each placed in its own subject directory. For each item below, replace <replaceable>&lt;version-number&gt;</replaceable> with the version of <filename>bind</filename> installed on the system:
+        BIND features a full range of installed documentation covering many different topics, each placed in its own subject directory. For each item below, replace <replaceable>version</replaceable> with the version of the <package>bind</package> package installed on the system:
       </para>
       <variablelist>
         <varlistentry>
-          <term><filename>/usr/share/doc/bind-<replaceable>&lt;version-number&gt;</replaceable>/</filename></term>
+          <term><filename class="directory">/usr/share/doc/bind-<replaceable>version</replaceable>/</filename></term>
           <listitem>
             <para>
-              This directory lists the most recent features. <!-- RHEL5:  Replace <replaceable>&lt;version-number&gt;</replaceable> with the version of <filename>bind</filename> installed on the system. -->
+              The main directory containing the most recent documentation.
             </para>
           </listitem>
         </varlistentry>
         <varlistentry>
-          <term><filename>/usr/share/doc/bind-<replaceable>&lt;version-number&gt;</replaceable>/arm/</filename></term>
+          <term><filename class="directory">/usr/share/doc/bind-<replaceable>version</replaceable>/arm/</filename></term>
           <listitem>
             <para>
-              This directory contains the <citetitle>BIND 9 Administrator Reference Manual</citetitle> in HTML and SGML formats, which details BIND resource requirements, how to configure different types of nameservers, how to perform load balancing, and other advanced topics. For most new users of BIND, this is the best place to start.<!-- RHEL5:   Replace <replaceable>&lt;version-number&gt;</replaceable> with the version of <filename>bind</filename> installed on the system. -->
+              The directory containing the <citetitle>BIND 9 Administrator Reference Manual</citetitle> in HTML and SGML formats, which details BIND resource requirements, how to configure different types of nameservers, how to perform load balancing, and other advanced topics. For most new users of BIND, this is the best place to start.
             </para>
           </listitem>
         </varlistentry>
         <varlistentry>
-          <term><filename>/usr/share/doc/bind-<replaceable>&lt;version-number&gt;</replaceable>/draft/</filename></term>
+          <term><filename class="directory">/usr/share/doc/bind-<replaceable>version</replaceable>/draft/</filename></term>
           <listitem>
             <para>
-              This directory contains assorted technical documents that review issues related to DNS service and propose some methods to address them.<!-- RHEL5:   Replace <replaceable>&lt;version-number&gt;</replaceable> with the version of <filename>bind</filename> installed on the system. -->
+              The directory containing assorted technical documents that review issues related to the DNS service, and propose some methods to address them.
             </para>
           </listitem>
         </varlistentry>
         <varlistentry>
-          <term><filename>/usr/share/doc/bind-<replaceable>&lt;version-number&gt;</replaceable>/misc/</filename></term>
+          <term><filename class="directory">/usr/share/doc/bind-<replaceable>version</replaceable>/misc/</filename></term>
           <listitem>
             <para>
-              This directory contains documents designed to address specific advanced issues. Users of BIND version 8 should consult the <filename>migration</filename> document for specific changes they must make when moving to BIND 9. The <filename>options</filename> file lists all of the options implemented in BIND 9 that are used in <filename>/etc/named.conf</filename>.<!-- RHEL5:   Replace <replaceable>&lt;version-number&gt;</replaceable> with the version of <filename>bind</filename> installed on the system. -->
+              The directory designed to address specific advanced issues. Users of BIND version 8 should consult the <filename>migration</filename> document for specific changes they must make when moving to BIND 9. The <filename>options</filename> file lists all of the options implemented in BIND 9 that are used in <filename>/etc/named.conf</filename>.
             </para>
           </listitem>
         </varlistentry>
         <varlistentry>
-          <term><filename>/usr/share/doc/bind-<replaceable>&lt;version-number&gt;</replaceable>/rfc/</filename></term>
+          <term><filename class="directory">/usr/share/doc/bind-<replaceable>version</replaceable>/rfc/</filename></term>
           <listitem>
             <para>
-              This directory provides every RFC document related to BIND.<!-- RHEL5:   Replace <replaceable>&lt;version-number&gt;</replaceable> with the version of <filename>bind</filename> installed on the system. -->
+              The directory providing every RFC document related to BIND.
             </para>
           </listitem>
         </varlistentry>
       </variablelist>
-      <!-- RHEL5:   ddomingo at redhat.com: above <variablelist> replaces below <itemizedlist>
-          <itemizedlist>
-            <listitem>
-              <para><filename>/usr/share/doc/bind-<replaceable>&lt;version-number&gt;</replaceable>/</filename> &mdash; This directory lists the most recent features. Replace <replaceable>&lt;version-number&gt;</replaceable> with the version of
-                <filename>bind</filename> installed on the system.</para>
-            </listitem>
-            <listitem>
-              <para><filename>/usr/share/doc/bind-<replaceable>&lt;version-number&gt;</replaceable>/arm/</filename> &mdash; This directory contains HTML and SGML of the <citetitle>BIND 9 Administrator Reference Manual</citetitle>, which details BIND resource requirements, how to configure different types of nameservers, how to perform load balancing, and other advanced topics. For most new users of BIND, this is the best place to start. Replace <replaceable>&lt;version-number&gt;</replaceable> with
-                the version of <filename>bind</filename> installed on the system.</para>
-            </listitem>
-            <listitem>
-              <para><filename>/usr/share/doc/bind-<replaceable>&lt;version-number&gt;</replaceable>/draft/</filename> &mdash; This directory contains assorted technical documents that reviews issues related to DNS service and some methods proposed
-                to address them. Replace <replaceable>&lt;version-number&gt;</replaceable> with the version of <filename>bind</filename> installed on the system.</para>
-            </listitem>
-            <listitem>
-              <para><filename>/usr/share/doc/bind-<replaceable>&lt;version-number&gt;</replaceable>/misc/</filename> &mdash; This directory contains documents designed to address specific advanced issues. Users of BIND version 8 should consult the
-                <filename>migration</filename> document for specific changes they must make when moving to BIND 9. The <filename>options</filename> file lists all of the options implemented in BIND 9 that are used in
-                <filename>/etc/named.conf</filename>. Replace <replaceable>&lt;version-number&gt;</replaceable> with the version of <filename>bind</filename> installed on the system.</para>
-            </listitem>
-            <listitem>
-              <para><filename>/usr/share/doc/bind-<replaceable>&lt;version-number&gt;</replaceable>/rfc/</filename> &mdash; This directory provides every RFC document related to BIND. Replace <replaceable>&lt;version-number&gt;</replaceable> with
-                the version of <filename>bind</filename> installed on the system.</para>
-            </listitem>
-          </itemizedlist>
- --><!-- RHEL5:          </listitem>
-        <listitem>
- -->
       <para>
-        <!-- RHEL5:  BIND-related man pages &mdash;  -->There are also a number of man pages for the various applications and configuration files involved with BIND. The following lists some of the more important man pages.
+        There is also a number of man pages for the various applications and configuration files involved with BIND:
       </para>
       <variablelist>
         <varlistentry>
-          <term>Administrative Applications</term>
+          <term><command>man rndc</command></term>
           <listitem>
-            <itemizedlist>
-              <listitem>
-                <para>
-                  <command>man rndc</command> — Explains the different options available when using the <command>rndc</command> command to control a BIND nameserver.
-                </para>
-              </listitem>
-            </itemizedlist>
+            <para>
+              The manual page for <command>rndc</command> containing the full documentation on its usage.
+            </para>
           </listitem>
         </varlistentry>
         <varlistentry>
-          <term>Server Applications</term>
+          <term><command>man named</command></term>
           <listitem>
-            <itemizedlist>
-              <listitem>
-                <para>
-                  <command>man named</command> — Explores assorted arguments that can be used to control the BIND nameserver daemon.
-                </para>
-              </listitem>
-              <listitem>
-                <para>
-                  <command>man lwresd</command> — Describes the purpose of and options available for the lightweight resolver daemon.
-                </para>
-              </listitem>
-            </itemizedlist>
+            <para>
+              The manual page for <systemitem class="service">named</systemitem> containing the documentation on assorted arguments that can be used to control the BIND nameserver daemon.
+            </para>
           </listitem>
         </varlistentry>
         <varlistentry>
-          <term>Configuration Files</term>
+          <term><command>man lwresd</command></term>
           <listitem>
-            <itemizedlist>
-              <listitem>
-                <para>
-                  <command>man named.conf</command> — A comprehensive list of options available within the <command>named</command> configuration file.
-                </para>
-              </listitem>
-              <listitem>
-                <para>
-                  <command>man rndc.conf</command> — A comprehensive list of options available within the <command>rndc</command> configuration file.
-                </para>
-              </listitem>
-            </itemizedlist>
+            <para>
+              The manual page for <systemitem class="service">lwresd</systemitem> containing the full documentation on the lightweight resolver daemon and its usage.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><command>man named.conf</command></term>
+          <listitem>
+            <para>
+              The manual page with a comprehensive list of options available within the <systemitem class="service">named</systemitem> configuration file.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><command>man rndc.conf</command></term>
+          <listitem>
+            <para>
+               The manual page with a comprehensive list of options available within the <command>rndc</command> configuration file.
+            </para>
           </listitem>
         </varlistentry>
       </variablelist>
-      <!-- RHEL5:          </listitem>
-      </itemizedlist>
- -->
     </section>
     <section id="s2-bind-useful-websites">
       <title>Useful Websites</title>
@@ -2012,22 +1970,16 @@ $TTL 86400
         <secondary>additional resources</secondary>
         <tertiary>useful websites</tertiary>
       </indexterm>
-      <itemizedlist>
-        <listitem>
-          <para>
-            <!-- RHEL5:   ddomingo: updated link, but still redirects
-            <ulink url="http://www.isc.org/products/BIND/">http://www.isc.org/products/BIND/</ulink> -->
-            <ulink url="http://www.isc.org/software/bind" /> — The home page of the BIND project containing information about current releases as well as a PDF version of the <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
-          </para>
-        </listitem>
-<!-- atkac at redhat.com: The DNS-HOWTO document is quite outdated. I would rather to exclude it in favor of default /etc/named.conf;
-        <listitem>
-          <para>
-            <ulink
-              url="http://www.redhat.com/mirrors/LDP/HOWTO/DNS-HOWTO.html">http://www.redhat.com/mirrors/LDP/HOWTO/DNS-HOWTO.html</ulink> — Covers the use of BIND as a resolving, caching nameserver and the configuration of various zone files necessary to serve as the primary nameserver for a domain.</para>
-        </listitem>
--->
-      </itemizedlist>
+      <variablelist>
+        <varlistentry>
+          <term><ulink url="http://www.isc.org/software/bind" /></term>
+          <listitem>
+            <para>
+              The home page of the BIND project containing information about current releases as well as a PDF version of the <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
+            </para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
     </section>
     <section id="s2-bind-related-books">
       <title>Related Books</title>
@@ -2036,18 +1988,24 @@ $TTL 86400
         <secondary>additional resources</secondary>
         <tertiary>related books</tertiary>
       </indexterm>
-      <itemizedlist>
-        <listitem>
-          <para>
-            <citetitle>DNS and BIND</citetitle> by Paul Albitz and Cricket Liu; O'Reilly &amp; Associates — A popular reference that explains both common and esoteric BIND configuration options, as well as providing strategies for securing a DNS server.
-          </para>
-        </listitem>
-        <listitem>
-          <para>
-            <citetitle>The Concise Guide to DNS and BIND</citetitle> by Nicolai Langfeldt; Que — Looks at the connection between multiple network services and BIND, with an emphasis on task-oriented, technical topics.
-          </para>
-        </listitem>
-      </itemizedlist>
+      <variablelist>
+        <varlistentry>
+          <term><citetitle>DNS and BIND</citetitle> by Paul Albitz and Cricket Liu; O'Reilly &amp; Associates</term>
+          <listitem>
+            <para>
+               A popular reference that explains both common and esoteric BIND configuration options, and provides strategies for securing a DNS server.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><citetitle>The Concise Guide to DNS and BIND</citetitle> by Nicolai Langfeldt; Que</term>
+          <listitem>
+            <para>
+              Looks at the connection between multiple network services and BIND, with an emphasis on task-oriented, technical topics.
+            </para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
     </section>
   </section>
 </chapter>


More information about the docs-commits mailing list