From: Eric Covener <covener@apache.org>
Date: Sun, 1 Nov 2009 16:26:07 +0000 (+0000)
Subject: document SetEnv "late" processing
X-Git-Tag: 2.2.15~170
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=626e3d3361d3c352c64054ec0ba39e070b94987f;p=thirdparty%2Fapache%2Fhttpd.git

document SetEnv "late" processing


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x@831696 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/mod_env.html.en b/docs/manual/mod/mod_env.html.en
index 322036ee3a7..ef90db83ac9 100644
--- a/docs/manual/mod/mod_env.html.en
+++ b/docs/manual/mod/mod_env.html.en
@@ -87,6 +87,16 @@ SSI pages</td></tr>
       SetEnv SPECIAL_PATH /foo/bin
     </code></p></div>
 
+    <div class="note"><p>The internal environment variables set by this directive are set
+    <em>after</em> most early request processing directives are run, such as access
+    control and URI-to-filename mapping.  If the environment variable you're
+    setting is meant as input into this early phase of processing such as the
+    <code class="directive"><a href="../mod/mod_rerite.html#rewriterule">RewriteRule</a></code> directive, you should 
+    instead set the environment variable with
+    <code class="directive"><a href="../mod/mod_setenvif.html# setenvif"> SetEnvIf</a></code>.</p>
+    </div>
+     
+
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="directive-section"><h2><a name="UnsetEnv" id="UnsetEnv">UnsetEnv</a> <a name="unsetenv" id="unsetenv">Directive</a></h2>
diff --git a/docs/manual/mod/mod_env.xml b/docs/manual/mod/mod_env.xml
index fbbfb246260..e7937674c0e 100644
--- a/docs/manual/mod/mod_env.xml
+++ b/docs/manual/mod/mod_env.xml
@@ -72,6 +72,16 @@ SSI pages</description>
     <example><title>Example</title>
       SetEnv SPECIAL_PATH /foo/bin
     </example>
+
+    <note><p>The internal environment variables set by this directive are set
+    <em>after</em> most early request processing directives are run, such as access
+    control and URI-to-filename mapping.  If the environment variable you're
+    setting is meant as input into this early phase of processing such as the
+    <directive module="mod_rerite">RewriteRule</directive> directive, you should 
+    instead set the environment variable with
+    <directive module="mod_setenvif"> SetEnvIf</directive>.</p>
+    </note>
+     
 </usage>
 </directivesynopsis>