Return-Path: 
 <cvs-return-34075-apmail-httpd-cvs-archive=httpd.apache.org@httpd.apache.org>
Delivered-To: apmail-httpd-cvs-archive@www.apache.org
Received: (qmail 86941 invoked from network); 16 Oct 2009 17:05:10 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3)
  by minotaur.apache.org with SMTP; 16 Oct 2009 17:05:10 -0000
Received: (qmail 94574 invoked by uid 500); 16 Oct 2009 17:05:10 -0000
Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org
Received: (qmail 94494 invoked by uid 500); 16 Oct 2009 17:05:10 -0000
Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@httpd.apache.org
list-help: <mailto:cvs-help@httpd.apache.org>
list-unsubscribe: <mailto:cvs-unsubscribe@httpd.apache.org>
List-Post: <mailto:cvs@httpd.apache.org>
List-Id: <cvs.httpd.apache.org>
Delivered-To: mailing list cvs@httpd.apache.org
Received: (qmail 94485 invoked by uid 99); 16 Oct 2009 17:05:10 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 16 Oct 2009 17:05:10 +0000
X-ASF-Spam-Status: No, hits=-2.6 required=5.0
	tests=BAYES_00
X-Spam-Check-By: apache.org
Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4)
    by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 16 Oct 2009 17:05:07 +0000
Received: by eris.apache.org (Postfix, from userid 65534)
	id 6069B23888CE; Fri, 16 Oct 2009 17:04:47 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r826006 - in /httpd/httpd/branches/2.2.x/docs/manual/mod:
 mod_headers.html.en mod_headers.xml
Date: Fri, 16 Oct 2009 17:04:47 -0000
To: cvs@httpd.apache.org
From: covener@apache.org
X-Mailer: svnmailer-1.0.8
Message-Id: <20091016170447.6069B23888CE@eris.apache.org>

Author: covener
Date: Fri Oct 16 17:04:46 2009
New Revision: 826006

URL: http://svn.apache.org/viewvc?rev=826006&view=rev
Log:
be clear that onsuccess is the default, reword explanation of when "always" helps.


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

Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/mod_headers.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/mod/mod_headers.html.en?rev=826006&r1=826005&r2=826006&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/mod/mod_headers.html.en (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/mod/mod_headers.html.en Fri Oct 16 17:04:46 2009
@@ -214,12 +214,13 @@
     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>

Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/mod_headers.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/mod/mod_headers.xml?rev=826006&r1=826005&r2=826006&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/mod/mod_headers.xml (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/mod/mod_headers.xml Fri Oct 16 17:04:46 2009
@@ -298,12 +298,13 @@
     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>