[deployment-guide/comm-rel: 509/727] Updated the HostnameLookups directive description.

[Jaromir Hradilek]

commit dcf3120afd7852578a60bf32f1e8a88e2ff78216
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Sat Aug 28 14:59:52 2010 +0200

    Updated the HostnameLookups directive description.

 en-US/The_Apache_HTTP_Server.xml |   89 +++++++++++++++++++++++++++-----------
 1 files changed, 63 insertions(+), 26 deletions(-)
---
diff --git a/en-US/The_Apache_HTTP_Server.xml b/en-US/The_Apache_HTTP_Server.xml
index fba98bb..3238b9e 100644
--- a/en-US/The_Apache_HTTP_Server.xml
+++ b/en-US/The_Apache_HTTP_Server.xml
@@ -909,7 +909,7 @@ ErrorDocument 404 /404-not_found.html</screen>
             </para>
             <screen>ExtendedStatus <replaceable>option</replaceable></screen>
             <para>
-              For a list of valid <replaceable>option</replaceable>s, see <xref linkend="table-apache-httpdconf-extendedstatus" />. This option is turned off by default.
+              For a list of valid <replaceable>option</replaceable>s, see <xref linkend="table-apache-httpdconf-extendedstatus" />. The default option is <option>Off</option>.
             </para>
             <table id="table-apache-httpdconf-extendedstatus">
               <title>Available options</title>
@@ -984,32 +984,69 @@ ErrorDocument 404 /404-not_found.html</screen>
             </example>
           </listitem>
         </varlistentry>
+        <varlistentry>
+          <term><option>HostnameLookups</option></term>
+          <listitem>
+            <para>
+              The <option>HostnameLookups</option> directive allows you to enable automatic resolving of IP addresses. It takes the following form:
+            </para>
+            <screen>HostnameLookups <replaceable>option</replaceable></screen>
+            <para>
+              For a list of valid <replaceable>option</replaceable>s, see <xref linkend="table-apache-httpdconf-hostnamelookup" />. To conserve resources on the server, the default option is <option>Off</option>.
+            </para>
+            <table id="table-apache-httpdconf-hostnamelookup">
+              <title>Available options</title>
+              <tgroup cols="2">
+                <colspec colname="option" colnum="1" colwidth="20*" />
+                <colspec colname="description" colnum="2" colwidth="60*" />
+                <thead>
+                  <row>
+                    <entry>
+                      Option
+                    </entry>
+                    <entry>
+                      Description
+                    </entry>
+                  </row>
+                </thead>
+                <tbody>
+                  <row>
+                    <entry>
+                      <option>On</option>
+                    </entry>
+                    <entry>
+                      Enables resolving the IP address for each connection so that the hostname can be logged. Hovewer, this adds processing overhead.
+                    </entry>
+                  </row>
+                  <row>
+                    <entry>
+                      <option>Double</option>
+                    </entry>
+                    <entry>
+                      Enables performing the double-reverse DNS lookup. In comparison to the above option, this adds even more processing overhead.
+                    </entry>
+                  </row>
+                  <row>
+                    <entry>
+                      <option>Off</option>
+                    </entry>
+                    <entry>
+                      Disables resolving the IP address for each connection.
+                    </entry>
+                  </row>
+                </tbody>
+              </tgroup>
+            </table>
+            <para>
+              Note that if the presence of hostnames is required in server log files, you can use one of the many log analyzer tools that perform the DNS lookups more efficiently and in bulk when rotating the web server log files.
+            </para>
+            <example id="example-apache-httpdconf-hostnamelookups">
+              <title>Using the <option>HostnameLookups</option> directive</title>
+              <screen>HostnameLookups Off</screen>
+            </example>
+          </listitem>
+        </varlistentry>
       </variablelist>
-      <formalpara id="s2-apache-hostnamelookups">
-        <title>HostnameLookups</title>
-        <indexterm>
-          <primary><command>HostnameLookups</command></primary>
-          <secondary>Apache configuration directive</secondary>
-        </indexterm>
-        <indexterm>
-          <primary>configuration directives, Apache</primary>
-          <secondary><command>HostnameLookups</command></secondary>
-        </indexterm>
-        <indexterm>
-          <primary>Apache HTTP Server</primary>
-          <secondary>log files</secondary>
-          <tertiary>using log analyzer tools with</tertiary>
-        </indexterm>
-        <para>
-          <command>HostnameLookups</command> can be set to <option>on</option>, <option>off</option>, or <option>double</option>. If <command>HostnameLookups</command> is set to <option>on</option>, the server automatically resolves the IP address for each connection. Resolving the IP address means that the server makes one or more connections to a DNS server, adding processing overhead. If <command>HostnameLookups</command> is set to <option>double</option>, the server performs a double-reverse DNS look up adding even more processing overhead.
-        </para>
-      </formalpara>
-      <para>
-        To conserve resources on the server, <command>HostnameLookups</command> is set to <option>off</option> by default.
-      </para>
-      <para>
-        If hostnames are required in server log files, consider running one of the many log analyzer tools that perform the DNS lookups more efficiently and in bulk when rotating the Web server log files.
-      </para>
       <formalpara id="s2-apache-ifdefine">
         <title>IfDefine</title>
         <indexterm>