[deployment-guide/comm-rel: 496/727] Updated the CustomLog directive description.

[Jaromir Hradilek]

commit ba67b66ca468b2a82f774ee991a7f2236f6d2200
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Thu Aug 26 10:44:32 2010 +0200

    Updated the CustomLog directive description.

 en-US/The_Apache_HTTP_Server.xml |   41 +++++++++++++++----------------------
 1 files changed, 17 insertions(+), 24 deletions(-)
---
diff --git a/en-US/The_Apache_HTTP_Server.xml b/en-US/The_Apache_HTTP_Server.xml
index 59bd1fb..3854fb3 100644
--- a/en-US/The_Apache_HTTP_Server.xml
+++ b/en-US/The_Apache_HTTP_Server.xml
@@ -772,30 +772,23 @@ AddIcon /icons/blank.png ^^BLANKICON^^</screen>
             </example>
           </listitem>
         </varlistentry>
+        <varlistentry>
+          <term><option>CustomLog</option></term>
+          <listitem>
+            <para>
+              The <option>CustomLog</option> directive allows you to specify the log filename and the log file format. It takes the following form:
+            </para>
+            <screen>CustomLog <replaceable>filename</replaceable> <replaceable>format</replaceable></screen>
+            <para>
+              The <replaceable>filename</replaceable> is a path relative to the directory that is specified by the <option>ServerRoot</option> directive (that is, <filename class="directory">/etc/httpd/</filename> by default). The <replaceable>format</replaceable> has to be either an explicit format string, or a format name that was previously defined using the <option>LogFormat</option> directive.
+            </para>
+            <example id="example-apache-httpdconf-customlog">
+              <title>Using the <option>CustomLog</option> directive</title>
+              <screen>CustomLog logs/access_log combined</screen>
+            </example>
+          </listitem>
+        </varlistentry>
       </variablelist>
-      <formalpara id="s2-apache-customlog">
-        <title>CustomLog</title>
-        <indexterm>
-          <primary><command>CustomLog</command></primary>
-          <secondary>Apache configuration directive</secondary>
-        </indexterm>
-        <indexterm>
-          <primary>configuration directives, Apache</primary>
-          <secondary><command>CustomLog</command></secondary>
-        </indexterm>
-        <indexterm>
-          <primary>Apache HTTP Server</primary>
-          <secondary>log files</secondary>
-          <tertiary>combined log file format</tertiary>
-        </indexterm>
-        <para>
-          <command>CustomLog</command> identifies the log file and the log file format. By default, the access log is recorded to the <filename>/var/log/httpd/access_log</filename> file while errors are recorded in the <filename>/var/log/httpd/error_log</filename> file.
-        </para>
-      </formalpara>
-      <para>
-        The default <command>CustomLog</command> format is the <option>combined</option> log file format, as illustrated here:
-      </para>
-      <screen><command><replaceable>remotehost rfc931 user date "request" status bytes referrer user-agent</replaceable></command></screen>
       <formalpara id="s2-apache-defaulticon">
         <title>DefaultIcon</title>
         <indexterm>
@@ -1270,7 +1263,7 @@ AddIcon /icons/blank.png ^^BLANKICON^^</screen>
           <tertiary>combined log file format</tertiary>
         </indexterm>
         <para>
-          The <command>LogFormat</command> directive configures the format of the various Web server log files. The actual <command>LogFormat</command> used depends on the settings given in the <command>CustomLog</command> directive (refer to <xref linkend="s2-apache-customlog" />).
+          The <command>LogFormat</command> directive configures the format of the various Web server log files. The actual <command>LogFormat</command> used depends on the settings given in the <command>CustomLog</command> directive<!-- (refer to <xref linkend="s2-apache-customlog" />)-->.
         </para>
       </formalpara>
       <para>