From: Eric Covener <covener@apache.org>
Date: Thu, 20 May 2010 18:55:40 +0000 (+0000)
Subject: backport 946616 and 946617 from trunk:
X-Git-Tag: 2.2.16~65
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f3d20b894617b6de0931378ffef5f74317e650cb;p=thirdparty%2Fapache%2Fhttpd.git

backport 946616 and 946617 from trunk:
  PR49308: Header directive doesn't see CGI-issued headers because they live in err_headers.
  emphasize request/response in the timing description, easy to miss the significance


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

diff --git a/docs/manual/mod/mod_headers.html.en b/docs/manual/mod/mod_headers.html.en
index 42eb811617b..a2b068afbf8 100644
--- a/docs/manual/mod/mod_headers.html.en
+++ b/docs/manual/mod/mod_headers.html.en
@@ -70,8 +70,8 @@ headers</td></tr>
 <div class="section">
 <h2><a name="early" id="early">Early and Late Processing</a></h2>
     <p><code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code> can be applied either early or late
-    in the request.  The normal mode is late, when Request Headers are
-    set immediately before running the content generator and Response
+    in the request.  The normal mode is late, when <em>Request</em> Headers are
+    set immediately before running the content generator and <em>Response</em>
     Headers just as the response is sent down the wire.  Always use
     Late mode in an operational server.</p>
 
@@ -222,6 +222,11 @@ headers</td></tr>
     successful responses, and is always needed to affect non-<code>2<var>xx</var></code> 
     responses such as redirects or client errors.</p>
 
+    <div class="note"><h3>CGI</h3>
+      <p>To manipulate headers set by CGI scripts, it is necessary to specify 
+      <code>always</code> for the first parameter.</p>
+    </div>
+
     <p>The action it performs is determined by the first
     argument (second argument if a <var>condition</var> is specified).
     This can be one of the following values:</p>
diff --git a/docs/manual/mod/mod_headers.xml b/docs/manual/mod/mod_headers.xml
index bef45ae4ddd..2d94333abfa 100644
--- a/docs/manual/mod/mod_headers.xml
+++ b/docs/manual/mod/mod_headers.xml
@@ -58,8 +58,8 @@ headers</description>
 
 <section id="early"><title>Early and Late Processing</title>
     <p><module>mod_headers</module> can be applied either early or late
-    in the request.  The normal mode is late, when Request Headers are
-    set immediately before running the content generator and Response
+    in the request.  The normal mode is late, when <em>Request</em> Headers are
+    set immediately before running the content generator and <em>Response</em>
     Headers just as the response is sent down the wire.  Always use
     Late mode in an operational server.</p>
 
@@ -306,6 +306,11 @@ headers</description>
     successful responses, and is always needed to affect non-<code>2<var>xx</var></code> 
     responses such as redirects or client errors.</p>
 
+    <note><title>CGI</title>
+      <p>To manipulate headers set by CGI scripts, it is necessary to specify 
+      <code>always</code> for the first parameter.</p>
+    </note>
+
     <p>The action it performs is determined by the first
     argument (second argument if a <var>condition</var> is specified).
     This can be one of the following values:</p>