svn commit: r564905 - in /httpd/httpd/branches/2.0.x/docs/manual/mod: mod_headers.html.en mod_headers.xml

[rb...@apache.org]

Author: rbowen
Date: Sat Aug 11 05:15:08 2007
New Revision: 564905

URL: http://svn.apache.org/viewvc?view=rev&rev=564905
Log:
Add a description of the env= optional syntax, as per issue #27951

Modified:
    httpd/httpd/branches/2.0.x/docs/manual/mod/mod_headers.html.en
    httpd/httpd/branches/2.0.x/docs/manual/mod/mod_headers.xml

Modified: httpd/httpd/branches/2.0.x/docs/manual/mod/mod_headers.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.0.x/docs/manual/mod/mod_headers.html.en?view=diff&rev=564905&r1=564904&r2=564905
==============================================================================
--- httpd/httpd/branches/2.0.x/docs/manual/mod/mod_headers.html.en (original)
+++ httpd/httpd/branches/2.0.x/docs/manual/mod/mod_headers.html.en Sat Aug 11 05:15:08 2007
@@ -256,7 +256,7 @@
 <table class="directive">
 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure HTTP request headers</td></tr>
 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RequestHeader set|append|add|unset <var>header</var>
-[<var>value</var>]</code></td></tr>
+[<var>value</var> [env=[!]<var>variable</var>]]</code></td></tr>
 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
@@ -298,6 +298,16 @@
     <code>set</code> a <var>value</var> is given as the third argument. If
     <var>value</var> contains spaces, it should be surrounded by double
     quotes. For unset, no <var>value</var> should be given.</p>
+
+    <p>When the <code class="directive">RequestHeader</code> directive is used with the
+    <code>add</code>, <code>append</code>, or <code>set</code>
+    argument, a fourth argument may be used to specify conditions
+    under which the action will be taken. If the <a href="../env.html">environment variable</a> specified in the
+    <code>env=...</code> argument exists (or if the environment
+    variable does not exist and <code>env=!...</code> is specified)
+    then the action specified by the <code class="directive">RequestHeader</code> directive
+    will take effect. Otherwise, the directive will have no effect
+    on the request.</p>
 
     <p>The <code class="directive">RequestHeader</code> directive is processed
     just before the request is run by its handler in the fixup phase.

Modified: httpd/httpd/branches/2.0.x/docs/manual/mod/mod_headers.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.0.x/docs/manual/mod/mod_headers.xml?view=diff&rev=564905&r1=564904&r2=564905
==============================================================================
--- httpd/httpd/branches/2.0.x/docs/manual/mod/mod_headers.xml (original)
+++ httpd/httpd/branches/2.0.x/docs/manual/mod/mod_headers.xml Sat Aug 11 05:15:08 2007
@@ -142,7 +142,7 @@
 <name>RequestHeader</name>
 <description>Configure HTTP request headers</description>
 <syntax>RequestHeader set|append|add|unset <var>header</var>
-[<var>value</var>]</syntax>
+[<var>value</var> [env=[!]<var>variable</var>]]</syntax>
 <contextlist><context>server config</context><context>virtual host</context>
 <context>directory</context><context>.htaccess</context></contextlist>
 <override>FileInfo</override>
@@ -184,6 +184,17 @@
     <code>set</code> a <var>value</var> is given as the third argument. If
     <var>value</var> contains spaces, it should be surrounded by double
     quotes. For unset, no <var>value</var> should be given.</p>
+
+    <p>When the <directive>RequestHeader</directive> directive is used with the
+    <code>add</code>, <code>append</code>, or <code>set</code>
+    argument, a fourth argument may be used to specify conditions
+    under which the action will be taken. If the <a
+    href="../env.html">environment variable</a> specified in the
+    <code>env=...</code> argument exists (or if the environment
+    variable does not exist and <code>env=!...</code> is specified)
+    then the action specified by the <directive>RequestHeader</directive> directive
+    will take effect. Otherwise, the directive will have no effect
+    on the request.</p>
 
     <p>The <directive>RequestHeader</directive> directive is processed
     just before the request is run by its handler in the fixup phase.