From: Eric Covener <covener@apache.org>
Date: Fri, 16 Oct 2009 17:04:46 +0000 (+0000)
Subject: be clear that onsuccess is the default, reword explanation of when "always" helps.
X-Git-Tag: 2.2.15~190
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=86b9e19d6d59eb57620a825e911bf0b031141aba;p=thirdparty%2Fapache%2Fhttpd.git

be clear that onsuccess is the default, reword explanation of when "always" helps.



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

diff --git a/docs/manual/mod/mod_headers.html.en b/docs/manual/mod/mod_headers.html.en
index 3029e8b743b..9df58f14a5e 100644
--- a/docs/manual/mod/mod_headers.html.en
+++ b/docs/manual/mod/mod_headers.html.en
@@ -214,12 +214,13 @@ headers</td></tr>
     and output filters are run, allowing outgoing headers to be
     modified.</p>
 
-    <p>The optional <var>condition</var> can be either <code>onsuccess</code>
-    or <code>always</code>. It determines, which internal header table should be
-    operated on. <code>onsuccess</code> stands for <code>2<var>xx</var></code>
-    status codes and <code>always</code> for all status codes (including
-    <code>2<var>xx</var></code>). Especially if you want to unset headers
-    set by certain modules, you should try out, which table is affected.</p>
+    <p>By default, this directive only affects successful responses (responses
+    in the <code>2<var>xx</var></code> range).  The optional <var>condition</var>
+    can be either <code>onsuccess</code> (default) or <code>always</code> (all
+    status codes, including successful responses).  A value of <code>always</code>
+    may be needed to influence headers set by some internal modules even for
+    successful responses, and is always needed to affect non-<code>2<var>xx</var></code> 
+    responses such as redirects or client errors</p>.
 
     <p>The action it performs is determined by the second
     argument. 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 f6894c80cc1..7069c8a568f 100644
--- a/docs/manual/mod/mod_headers.xml
+++ b/docs/manual/mod/mod_headers.xml
@@ -298,12 +298,13 @@ headers</description>
     and output filters are run, allowing outgoing headers to be
     modified.</p>
 
-    <p>The optional <var>condition</var> can be either <code>onsuccess</code>
-    or <code>always</code>. It determines, which internal header table should be
-    operated on. <code>onsuccess</code> stands for <code>2<var>xx</var></code>
-    status codes and <code>always</code> for all status codes (including
-    <code>2<var>xx</var></code>). Especially if you want to unset headers
-    set by certain modules, you should try out, which table is affected.</p>
+    <p>By default, this directive only affects successful responses (responses
+    in the <code>2<var>xx</var></code> range).  The optional <var>condition</var>
+    can be either <code>onsuccess</code> (default) or <code>always</code> (all
+    status codes, including successful responses).  A value of <code>always</code>
+    may be needed to influence headers set by some internal modules even for
+    successful responses, and is always needed to affect non-<code>2<var>xx</var></code> 
+    responses such as redirects or client errors</p>.
 
     <p>The action it performs is determined by the second
     argument. This can be one of the following values:</p>