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 2799c3616040c29cb3f38559c18213632c6f7b69..349eac2bb4d024128f66153eef40b6535e626299 100644 (file)
--- 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 8ba70c24e30172286ac3adeccd662d4f9747e468..9db90abbe689019be0f7fed14d65ab9a3dfed7e8 100644 (file)
--- 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>