From: Chris Darroch Date: Thu, 23 Aug 2007 18:44:07 +0000 (+0000) Subject: Fix some typos, whitespace, and formatting. Make sure all options are X-Git-Tag: 2.2.6~133 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2c35b25aae7d502f4c6d630dbba7c49c8d6a2961;p=thirdparty%2Fapache%2Fhttpd.git Fix some typos, whitespace, and formatting. Make sure all options are listed in appropriate locations. Deprecate "add" in favour of "set" throughout. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x@569115 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_headers.xml b/docs/manual/mod/mod_headers.xml index c370737d62e..93c4f93b8d2 100644 --- a/docs/manual/mod/mod_headers.xml +++ b/docs/manual/mod/mod_headers.xml @@ -99,7 +99,7 @@ is available only in Apache 2.0 bottlenecks between the client and the server. - Header add MyHeader "%D %t" + Header set MyHeader "%D %t"

results in this header being added to the response:

@@ -113,7 +113,7 @@ is available only in Apache 2.0 Say hello to Joe - Header add MyHeader "Hello Joe. It took %D microseconds \
+ Header set MyHeader "Hello Joe. It took %D microseconds \
for Apache to serve this request." @@ -127,32 +127,34 @@ is available only in Apache 2.0
  • Conditionally send MyHeader on the response if and - only if header "MyRequestHeader" is present on the request. This - is useful for constructing headers in response to some client + only if header MyRequestHeader is present on the request. + This is useful for constructing headers in response to some client stimulus. Note that this example requires the services of the mod_setenvif module. - SetEnvIf MyRequestHeader value HAVE_MyRequestHeader
    - Header add MyHeader "%D %t mytext" env=HAVE_MyRequestHeader
    -     + SetEnvIf MyRequestHeader myvalue HAVE_MyRequestHeader
    + Header set MyHeader "%D %t mytext" env=HAVE_MyRequestHeader + -

    If the header MyRequestHeader: value is present on - the HTTP request, the response will contain the following header:

    +

    If the header MyRequestHeader: myvalue is present on + the HTTP request, the response will contain the following header:

    - - MyHeader: D=3775428 t=991424704447256 mytext - -
    • -
  • Enable DAV to work with Apache running HTTP through SSL hardware - (problem description) by replacing https: with - http: in the Destination header: - - RequestHeader edit Destination ^https: http: early - + + MyHeader: D=3775428 t=991424704447256 mytext +
    • +
  • + Enable DAV to work with Apache running HTTP through SSL hardware + (problem + description) by replacing https: with + http: in the Destination header: + + + RequestHeader edit Destination ^https: http: early + +
    • @@ -188,8 +190,8 @@ is available only in Apache 2.0
    The request header is added to the existing set of headers, even if this header already exists. This can result in two (or more) headers having the same name. This can lead to - unforeseen consequences, and in general append should be - used instead.
    + unforeseen consequences, and in general set or + append should be used instead.
    unset
    The request header of this name is removed, if it exists. If @@ -206,10 +208,10 @@ is available only in Apache 2.0

    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 a + ignored. For set, append and + add a value is given as the third argument. If a value contains spaces, it should be surrounded by double - quotes. For unset, no value should be given. + quotes. For unset, no value should be given. value may be a character string, a string containing format specifiers or a combination of both. The supported format specifiers are the same as for the Header, @@ -277,8 +279,8 @@ is available only in Apache 2.0

    The response header is added to the existing set of headers, even if this header already exists. This can result in two (or more) headers having the same name. This can lead to - unforeseen consequences, and in general "append" should be - used instead.
    + unforeseen consequences, and in general set or + append should be used instead.
    unset
    The response header of this name is removed, if it exists. @@ -287,7 +289,7 @@ is available only in Apache 2.0
    echo
    Request headers with this name are echoed back in the - response headers. header may be a + response headers. header may be a regular expression. value must be omitted.
    @@ -301,14 +303,15 @@ is available only in Apache 2.0

    This argument is followed by a header name, which can include the 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 + ignored for set, append, add, + unset, and edit. + The header name for echo + is case sensitive and may be a regular expression.

    -

    For add, append and set a +

    For set, append and add a value is specified as the third argument. If value - contains spaces, it should be surrounded by doublequotes. + contains spaces, it should be surrounded by double quotes. value may be a character string, a string containing format specifiers or a combination of both. The following format specifiers are supported in value:

    @@ -346,7 +349,7 @@ is available only in Apache 2.0 +StdEnvVars. If SSLOptions +StdEnvVars must be enabled anyway for some other reason, %e will be more efficient than %s.

    - +

    For edit there is both a value argument which is a regular expression,