From: Bill Stoddard <stoddard@apache.org>
Date: Fri, 1 Jun 2001 04:39:08 +0000 (+0000)
Subject: Update doc with info on Header echo directive
X-Git-Tag: 2.0.19~157
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f99513610bde67c0742fc1acbaa432edb096e693;p=thirdparty%2Fapache%2Fhttpd.git

Update doc with info on Header echo directive


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

diff --git a/CHANGES b/CHANGES
index 2799c361604..349eac2bb4d 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,4 +1,8 @@
 Changes with Apache 2.0.19-dev
+  *) New Header directive 'echo' option. "Header echo regex" will
+     cause any headers received on the request that match regex to be
+     echoed to (included in) the response headers.
+     [Bill Stoddard]
 
   *) include/ap_compat.h tested and set APR_COMPAT_H instead of AP_COMPAT_H.
      This prevented the inclusion of apr_compat.h.  PR #7773
diff --git a/docs/manual/mod/mod_headers.html b/docs/manual/mod/mod_headers.html
index 8ba70c24e30..9db90abbe68 100644
--- a/docs/manual/mod/mod_headers.html
+++ b/docs/manual/mod/mod_headers.html
@@ -157,6 +157,10 @@ the browser, or by Apache input filters to be overridden or modified.
  HREF="directive-dict.html#Syntax"
  REL="Help"
 ><STRONG>Syntax:</STRONG></A> Header unset <EM>header</EM><BR>
+<A
+ HREF="directive-dict.html#Syntax"
+ REL="Help"
+><STRONG>Syntax:</STRONG></A> Header echo <EM>header</EM><BR>
 <A
  HREF="directive-dict.html#Context"
  REL="Help"
@@ -178,8 +182,7 @@ the browser, or by Apache input filters to be overridden or modified.
 This directive can replace, merge or remove HTTP response headers. The header
 is modified just after the content handler and output filters are run, 
 allowing outgoing headers to be modified. The action it performs is determined 
-by the first argument. This can be one of the following values, as with
-RequestHeader:
+by the first argument. This can be one of the following values:
 
 <UL>
 <LI><STRONG>set</STRONG><BR>
@@ -200,13 +203,23 @@ RequestHeader:
 <LI><STRONG>unset</STRONG><BR>
   The response header of this name is removed, if it exists. If there are
   multiple headers of the same name, all will be removed.
+
+<LI><STRONG>echo</STRONG><BR>
+  Request headers with this name are echoed back in the response headers.
+  <EM>header</EM> may be a regular expression. For example, the directive
+  <P>
+  Header echo ^TS*
+  <P>
+  will cause all request headers that begin with TS to be echoed
+  or copied over to the response headers.
 </UL>
 
 This argument is followed by a header name, which can include the
-final colon, but it is not required. Case is ignored. For
-add, append and set a value is given as the third argument. If this
-value contains spaces, it should be surrounded by double quotes.
-For unset, no value should be given.
+final colon, but it is not required. Case is ignored for set, append, add
+and unset. The header name for echo is case sensitive and may be a
+regular expression. For add, append and set a value is given as the third 
+argument. If this value contains spaces, it should be surrounded by double 
+quotes. For unset and echo, no value should be given.
 
 <H3>Order of Processing</H3>