[deployment-guide/comm-rel: 590/727] Updated the IfDefine directive description.

Jaromir Hradilek jhradile at fedoraproject.org
Tue Oct 19 13:14:38 UTC 2010


commit 07691c59176746f7f8f187e037da35800173ebfc
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Mon Sep 6 16:38:32 2010 +0200

    Updated the IfDefine directive description.

 en-US/The_Apache_HTTP_Server.xml |   38 +++++++++++++++++++++-----------------
 1 files changed, 21 insertions(+), 17 deletions(-)
---
diff --git a/en-US/The_Apache_HTTP_Server.xml b/en-US/The_Apache_HTTP_Server.xml
index b26b76f..13516fb 100644
--- a/en-US/The_Apache_HTTP_Server.xml
+++ b/en-US/The_Apache_HTTP_Server.xml
@@ -260,6 +260,27 @@ httpd (pid 19014) is running...</screen>
           </listitem>
         </varlistentry>
         <varlistentry>
+          <term><option>&lt;IfDefine&gt;</option></term>
+          <listitem>
+            <para>
+              The <option>IfDefine</option> directive allows you to apply certain directives only if the selected parameter is supplied on the command line. It takes the following form:
+            </para>
+            <screen>&lt;IfDefine <replaceable>parameter</replaceable>&gt;
+  <replaceable>directive</replaceable>
+  &#8230;
+&lt;/IfDefine&gt;</screen>
+            <para>
+              The <replaceable>parameter</replaceable> is a keyword that can be supplied at a shell prompt using the <option>-D</option><replaceable>parameter</replaceable> command line option (for example, <command>httpd -DEnableHome</command>).
+            </para>
+            <example id="example-apache-httpdconf-ifdefine">
+              <title>Using the <option>&lt;IfDefine&gt;</option> directive</title>
+              <screen>&lt;IfDefine EnableHome&gt;
+  UserDir public_html
+&lt;/IfDefine&gt;</screen>
+            </example>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
           <term><option>AccessFileName</option></term>
           <listitem>
             <para>
@@ -2450,23 +2471,6 @@ ErrorDocument 404 /404-not_found.html</screen>
           </listitem>
         </varlistentry>
       </variablelist>
-      <formalpara id="s2-apache-ifdefine">
-        <title>IfDefine</title>
-        <indexterm>
-          <primary><command>IfDefine</command></primary>
-          <secondary>Apache configuration directive</secondary>
-        </indexterm>
-        <indexterm>
-          <primary>configuration directives, Apache</primary>
-          <secondary><command>IfDefine</command></secondary>
-        </indexterm>
-        <para>
-          The <command>IfDefine</command> tags surround configuration directives that are applied if the "test" stated in the <command>IfDefine</command> tag is true. The directives are ignored if the test is false.
-        </para>
-      </formalpara>
-      <para>
-        The test in the <command>IfDefine</command> tags is a parameter name (for example, <command>HAVE_PERL</command>). If the parameter is defined, meaning that it is provided as an argument to the server's start-up command, then the test is true. In this case, when the Web server is started, the test is true and the directives contained in the <command>IfDefine</command> tags are applied.
-      </para>
       <formalpara id="s2-apache-ifmodule">
         <title>IfModule</title>
         <indexterm>


More information about the docs-commits mailing list