diff options
| author | Stefan Fritsch <sf@apache.org> | 2011-01-20 20:17:38 +0100 |
|---|---|---|
| committer | Stefan Fritsch <sf@apache.org> | 2011-01-20 20:17:38 +0100 |
| commit | 2fb1e997b7be039a542f5cc13f06101da4647457 (patch) | |
| tree | 3fa0e79e7fd6497e9980db4600d18b10daa932c1 /docs/manual/mod/core.html.en | |
| parent | Add support to set variables with the 'Define' directive. Change (diff) | |
| download | apache2-2fb1e997b7be039a542f5cc13f06101da4647457.tar.xz apache2-2fb1e997b7be039a542f5cc13f06101da4647457.zip | |
Update docs for changed Define syntax
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1061468 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/mod/core.html.en')
| -rw-r--r-- | docs/manual/mod/core.html.en | 30 |
1 files changed, 24 insertions, 6 deletions
diff --git a/docs/manual/mod/core.html.en b/docs/manual/mod/core.html.en index 0b80b3d4cf..070a363e90 100644 --- a/docs/manual/mod/core.html.en +++ b/docs/manual/mod/core.html.en @@ -593,15 +593,33 @@ which no other media type configuration could be found. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="Define" id="Define">Define</a> <a name="define" id="define">Directive</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define the existence of a variable</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Define <var>parameter-name</var></code></td></tr> -<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Define a variable</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Define <var>parameter-name</var> [<var>parameter-value</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr> <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> - <p>Equivalent to passing the <code>-D</code> argument to <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</p> - <p>This directive can be used to toggle the use of <code class="directive"><a href="#ifdefine"><IfDefine></a></code> sections without needing to alter - <code>-D</code> arguments in any startup scripts.</p> + <p>In its one parameter form, <code class="directive">Define</code> is equivalent + to passing the <code>-D</code> argument to <code class="program"><a href="../programs/httpd.html">httpd</a></code>. It + can be used to toggle the use of + <code class="directive"><a href="#ifdefine"><IfDefine></a></code> sections + without needing to alter <code>-D</code> arguments in any startup + scripts.</p> + + <p>In addition to that, if the second parameter is given, a config variable + is set to this value. The variable can be used in the configuration using + the <code>${VAR}</code> syntax. The variable is always globally defined + and not limited to the scope of the surrounding config section.</p> + + <div class="example"><p><code> + <IfDefine TEST><br /> + Define servername test.example.com<br /> + </IfDefine><br /> + <IfDefine !TEST><br /> + Define servername www.example.com<br /> + Define SSL<br /> + </IfDefine><br /> + </code></p></div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> |