mention that "Header onsuccess" is the default and reword the description

of "Header always" to talk less about implementation details and more about
the FAQ of redirects or 401's.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@826005 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/mod/mod_headers.html.en b/docs/manual/mod/mod_headers.html.en
index b0448a7f6019a6ec5797cf2885dfe3aeff554a64..c9a58f783a53408f836cc77a97d702eb184a62ca 100644 (file)
--- a/docs/manual/mod/mod_headers.html.en
+++ b/docs/manual/mod/mod_headers.html.en
@@ -217,12 +217,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 8fd54a4bda75d2824bf2e0fcd5a1ecb95c1685a1..4ba00c140f5bc0daca2bac39b324113ba6857ad2 100644 (file)
--- a/docs/manual/mod/mod_headers.xml
+++ b/docs/manual/mod/mod_headers.xml
@@ -302,12 +302,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>