Return-Path: Delivered-To: apmail-httpd-cvs-archive@www.apache.org Received: (qmail 1351 invoked from network); 21 Aug 2007 23:27:01 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 21 Aug 2007 23:27:01 -0000 Received: (qmail 32677 invoked by uid 500); 21 Aug 2007 23:26:53 -0000 Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org Received: (qmail 32515 invoked by uid 500); 21 Aug 2007 23:26:52 -0000 Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm Precedence: bulk Reply-To: dev@httpd.apache.org list-help: list-unsubscribe: List-Post: List-Id: Delivered-To: mailing list cvs@httpd.apache.org Received: (qmail 32504 invoked by uid 99); 21 Aug 2007 23:26:52 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 21 Aug 2007 16:26:52 -0700 X-ASF-Spam-Status: No, hits=-100.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.3] (HELO eris.apache.org) (140.211.11.3) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 21 Aug 2007 23:27:23 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 14DB61A981A; Tue, 21 Aug 2007 16:26:26 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r568324 - in /httpd/httpd/trunk/docs/manual/mod: mod_dbd.html.en mod_headers.html.en mod_headers.xml.ja mod_headers.xml.ko quickreference.html.en Date: Tue, 21 Aug 2007 23:26:25 -0000 To: cvs@httpd.apache.org From: chrisd@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20070821232626.14DB61A981A@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: chrisd Date: Tue Aug 21 16:26:23 2007 New Revision: 568324 URL: http://svn.apache.org/viewvc?rev=568324&view=rev Log: update transformation Modified: httpd/httpd/trunk/docs/manual/mod/mod_dbd.html.en httpd/httpd/trunk/docs/manual/mod/mod_headers.html.en httpd/httpd/trunk/docs/manual/mod/mod_headers.xml.ja httpd/httpd/trunk/docs/manual/mod/mod_headers.xml.ko httpd/httpd/trunk/docs/manual/mod/quickreference.html.en Modified: httpd/httpd/trunk/docs/manual/mod/mod_dbd.html.en URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_dbd.html.en?rev=568324&r1=568323&r2=568324&view=diff ============================================================================== --- httpd/httpd/trunk/docs/manual/mod/mod_dbd.html.en (original) +++ httpd/httpd/trunk/docs/manual/mod/mod_dbd.html.en Tue Aug 21 16:26:23 2007 @@ -209,12 +209,12 @@

DBDPersist Directive

- +
Description:Whether to use persistent connections
Syntax:DBDPersist 0|1
Syntax:DBDPersist On|Off
Context:server config, virtual host
Status:Extension
Module:mod_dbd
-

If set to 0, persistent and pooled connections are disabled. +

If set to Off, persistent and pooled connections are disabled. A new database connection is opened when requested by a client, and closed immediately on release. This option is for debugging and low-usage servers.

Modified: httpd/httpd/trunk/docs/manual/mod/mod_headers.html.en URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_headers.html.en?rev=568324&r1=568323&r2=568324&view=diff ============================================================================== --- httpd/httpd/trunk/docs/manual/mod/mod_headers.html.en (original) +++ httpd/httpd/trunk/docs/manual/mod/mod_headers.html.en Tue Aug 21 16:26:23 2007 @@ -109,7 +109,7 @@ 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:

@@ -123,7 +123,7 @@ 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."

@@ -137,38 +137,69 @@
  • 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
    -

    - -

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

    - -

    - MyHeader: D=3775428 t=991424704447256 mytext -

    + SetEnvIf MyRequestHeader myvalue HAVE_MyRequestHeader
    + Header set MyHeader "%D %t mytext" env=HAVE_MyRequestHeader +

  • + +

    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 -

    + +
  • + 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 +

  • +
  • + Set the same header value under multiple non-exclusive conditions, + but do not duplicate the value in the final header. + If all of the following conditions applied to a request (i.e., + if the CGI, NO_CACHE and + NO_STORE environment variables all existed for the + request): + +

    + Header merge Cache-Control no-cache env=CGI
    + Header merge Cache-Control no-cache env=NO_CACHE
    + Header merge Cache-Control no-store env=NO_STORE +

    + +

    then the response would contain the following header:

    + +

    + Cache-Control: no-cache, no-store +

    + +

    If append was used instead of merge, + then the response would contain the following header:

    + +

    + Cache-Control: no-cache, no-cache, no-store +

    +
  • top

    Header Directive

    - @@ -201,12 +232,22 @@ header it is separated from the existing header with a comma. This is the HTTP standard way of giving a header multiple values. +
    merge
    +
    The response header is appended to any existing header of + the same name, unless the value to be appended already appears in the + header's comma-delimited list of values. When a new value is merged onto + an existing header it is separated from the existing header with a comma. + This is the HTTP standard way of giving a header multiple values. + Values are compared in a case sensitive manner, and after + all format specifiers have been processed. Values in double quotes + are considered different from otherwise identical unquoted values.
    +
    add
    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, + append or merge should be used instead.
    unset
    The response header of this name is removed, if it exists. @@ -215,7 +256,7 @@
    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.
    @@ -228,14 +269,16 @@

    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, merge, + add, unset and edit. + The header name for echo + is case sensitive and may be a regular expression.

    -

    For add, append and set a - value is specified as the third argument. If value - contains spaces, it should be surrounded by doublequotes. +

    For set, append, merge and + add a value is specified as the third argument. + If value + 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:

    @@ -266,7 +309,7 @@ +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, @@ -294,7 +337,7 @@

    Description:Configure HTTP response headers
    Syntax:Header [condition] set|append|add|unset|echo|edit +
    Syntax:Header [condition] set|append|merge|add|unset|echo|edit header [value] [early|env=[!]variable]
    Context:server config, virtual host, directory, .htaccess
    Override:FileInfo
    - @@ -319,12 +362,22 @@ is the HTTP standard way of giving a header multiple values. +
    merge
    +
    The response header is appended to any existing header of + the same name, unless the value to be appended already appears in the + existing header's comma-delimited list of values. When a new value is + merged onto an existing header it is separated from the existing header + with a comma. This is the HTTP standard way of giving a header multiple + values. Values are compared in a case sensitive manner, and after + all format specifiers have been processed. Values in double quotes + are considered different from otherwise identical unquoted values.
    +
    add
    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, + append or merge should be used instead.
    unset
    The request header of this name is removed, if it exists. If @@ -340,10 +393,10 @@

    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, merge 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, Modified: httpd/httpd/trunk/docs/manual/mod/mod_headers.xml.ja URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_headers.xml.ja?rev=568324&r1=568323&r2=568324&view=diff ============================================================================== --- httpd/httpd/trunk/docs/manual/mod/mod_headers.xml.ja [iso-2022-jp] (original) +++ httpd/httpd/trunk/docs/manual/mod/mod_headers.xml.ja [iso-2022-jp] Tue Aug 21 16:26:23 2007 @@ -1,7 +1,7 @@ - + +

    Description:Configure HTTP request headers
    Syntax:RequestHeader set|append|add|unset|edit header +
    Syntax:RequestHeader set|append|merge|add|unset|edit header [value] [replacement] [early|env=[!]variable]
    Context:server config, virtual host, directory, .htaccess
    Override:FileInfo