httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From n.@apache.org
Subject cvs commit: httpd-2.0/docs/manual/mod mod_headers.html.en mod_headers.xml.ja quickreference.html.de quickreference.html.en quickreference.html.es quickreference.html.ko.euc-kr
Date Mon, 05 Jul 2004 19:15:56 GMT
nd          2004/07/05 12:15:55

  Modified:    docs/manual/mod mod_headers.html.en mod_headers.xml.ja
                        quickreference.html.de quickreference.html.en
                        quickreference.html.es
                        quickreference.html.ko.euc-kr
  Log:
  update transformation
  
  Revision  Changes    Path
  1.30      +35 -7     httpd-2.0/docs/manual/mod/mod_headers.html.en
  
  Index: mod_headers.html.en
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_headers.html.en,v
  retrieving revision 1.29
  retrieving revision 1.30
  diff -u -u -r1.29 -r1.30
  --- mod_headers.html.en	12 Jun 2004 14:30:52 -0000	1.29
  +++ mod_headers.html.en	5 Jul 2004 19:15:54 -0000	1.30
  @@ -45,6 +45,7 @@
   <h3>Topics</h3>
   <ul id="topics">
   <li><img alt="" src="../images/down.gif" /> <a href="#order">Order of
Processing</a></li>
  +<li><img alt="" src="../images/down.gif" /> <a href="#early">Early and
Late Processing</a></li>
   <li><img alt="" src="../images/down.gif" /> <a href="#examples">Examples</a></li>
   </ul></div>
   <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"
/></a></div>
  @@ -68,6 +69,27 @@
       reversed, the MirrorID header is set to "mirror 12".</p>
   </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"
/></a></div>
   <div class="section">
  +<h2><a name="early" id="early">Early and Late Processing</a></h2>
  +    <p><code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code>
can be applied either early or late
  +    in the request.  The normal mode is late, when Request Headers are
  +    set immediately before running the content generator and Response
  +    Headers just as the response is sent down the wire.  Always use
  +    Late mode in an operational server.</p>
  +
  +    <p>Early mode is designed as a test/debugging aid for developers.
  +    Directives defined using the <code>early</code> keyword are set
  +    right at the beginning of processing the request.  This means
  +    they can be used to simulate different requests and set up test
  +    cases, but it also means that headers may be changed at any time
  +    by other modules before generating a Response.</p>
  +
  +    <p>Because early directives are processed before the request path's
  +    configuration is traversed, early headers can only be set in a
  +    main server or virtual host context.  Early directives cannot depend
  +    on a request path, so they will fail in contexts such as
  +    <code>&lt;Directory&gt;</code> or <code>&lt;Location&gt;</code>.</p>
  +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"
/></a></div>
  +<div class="section">
   <h2><a name="examples" id="examples">Examples</a></h2>
   
       <ol>
  @@ -140,7 +162,7 @@
   <table class="directive">
   <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure
HTTP response headers</td></tr>
   <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Header
[<var>condition</var>] set|append|add|unset|echo
  -<var>header</var> [<var>value</var>] [env=[!]<var>variable</var>]</code></td></tr>
  +<var>header</var> [<var>value</var>] [early|env=[!]<var>variable</var>]</code></td></tr>
   <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server
config, virtual host, directory, .htaccess</td></tr>
   <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
   <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
  @@ -232,15 +254,18 @@
       </div> 
   
       <p>The <code class="directive">Header</code> directive may be followed
by an
  -    additional argument, which may be used to specify conditions
  -    under which the action will be taken. If the <a href="../env.html">environment
variable</a> specified in the
  +    an additional argument, which may be used to specify conditions under
  +    which the action will be taken, or may be the keyword <code>early</code>
  +    to specify <a href="#early">early processing</a>. If the
  +    <a href="../env.html">environment variable</a> specified in the
       <code>env=<var>...</var></code> argument exists (or if the
environment
       variable does not exist and <code>env=!<var>...</var></code>
is specified)
       then the action specified by the <code class="directive">Header</code>
directive
       will take effect. Otherwise, the directive will have no effect
       on the request.</p>
   
  -    <p>The <code class="directive">Header</code> directives are processed
just
  +    <p>Except in <a href="#early">early</a> mode, the
  +    <code class="directive">Header</code> directives are processed just
       before the response is sent to the network. These means that it is
       possible to set and/or override most headers, except for those headers
       added by the header filter.</p>
  @@ -251,7 +276,7 @@
   <table class="directive">
   <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure
HTTP request headers</td></tr>
   <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RequestHeader
set|append|add|unset <var>header</var>
  -[<var>value</var>] [env=[!]<var>variable</var>]</code></td></tr>
  +[<var>value</var>] [early|env=[!]<var>variable</var>]</code></td></tr>
   <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server
config, virtual host, directory, .htaccess</td></tr>
   <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
   <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
  @@ -301,14 +326,17 @@
   
       <p>The <code class="directive">RequestHeader</code> directive may
be followed by
       an additional argument, which may be used to specify conditions under
  -    which the action will be taken. If the <a href="../env.html">environment
  +    which the action will be taken, or may be the keyword <code>early</code>
  +    to specify <a href="#early">early processing</a>. If the
  +    <a href="../env.html">environment
       variable</a> specified in the <code>env=<var>...</var></code>
argument
       exists (or if the environment variable does not exist and
       <code>env=!<var>...</var></code> is specified) then the action
specified
       by the <code class="directive">RequestHeader</code> directive will take
effect.
       Otherwise, the directive will have no effect on the request.</p>
   
  -    <p>The <code class="directive">RequestHeader</code> directive is
processed
  +    <p>Except in <a href="#early">early</a> mode, the
  +    <code class="directive">RequestHeader</code> directive is processed
       just before the request is run by its handler in the fixup phase.
       This should allow headers generated by the browser, or by Apache
       input filters to be overridden or modified.</p>
  
  
  
  1.12      +1 -1      httpd-2.0/docs/manual/mod/mod_headers.xml.ja
  
  Index: mod_headers.xml.ja
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_headers.xml.ja,v
  retrieving revision 1.11
  retrieving revision 1.12
  diff -u -u -r1.11 -r1.12
  --- mod_headers.xml.ja	12 Jun 2004 14:30:52 -0000	1.11
  +++ mod_headers.xml.ja	5 Jul 2004 19:15:54 -0000	1.12
  @@ -1,7 +1,7 @@
   <?xml version="1.0" encoding="iso-2022-jp"?>
   <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
  -<!-- English Revision: 1.7 (outdated: 1.17) -->
  +<!-- English Revision: 1.7 (outdated: 1.18) -->
   
   <!--
    Copyright 2003-2004 The Apache Software Foundation
  
  
  
  1.69      +2 -2      httpd-2.0/docs/manual/mod/quickreference.html.de
  
  Index: quickreference.html.de
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/quickreference.html.de,v
  retrieving revision 1.68
  retrieving revision 1.69
  diff -u -u -r1.68 -r1.69
  --- quickreference.html.de	4 Jul 2004 10:25:21 -0000	1.68
  +++ quickreference.html.de	5 Jul 2004 19:15:54 -0000	1.69
  @@ -335,7 +335,7 @@
   <tr><td><a href="mpm_common.html#group" id="G" name="G">Group <var>Unix-Gruppe</var></a></td><td>
#-1 </td><td>s</td><td>M</td></tr><tr><td class="descr"
colspan="4">Benutzergruppe, unter welcher der Server Anfragen
     beantwortet</td></tr>
   <tr class="odd"><td><a href="mod_headers.html#header" id="H" name="H">Header
[<var>condition</var>] set|append|add|unset|echo
  -<var>header</var> [<var>value</var>] [env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr
class="odd"><td class="descr" colspan="4">Configure HTTP response headers</td></tr>
  +<var>header</var> [<var>value</var>] [early|env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr
class="odd"><td class="descr" colspan="4">Configure HTTP response headers</td></tr>
   <tr><td><a href="mod_autoindex.html#headername">HeaderName <var>filename</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr><td
class="descr" colspan="4">Name of the file that will be inserted at the top
   of the index listing</td></tr>
   <tr class="odd"><td><a href="core.html#hostnamelookups">HostnameLookups
On|Off|Double</a></td><td> Off </td><td>svd</td><td>C</td></tr><tr
class="odd"><td class="descr" colspan="4">Aktiviert DNS-Lookups auf Client-IP-Adressen</td></tr>
  @@ -555,7 +555,7 @@
   ...</a></td><td></td><td>vdh</td><td>B</td></tr><tr><td
class="descr" colspan="4">Removes any content type associations for a set of file
   extensions</td></tr>
   <tr class="odd"><td><a href="mod_headers.html#requestheader">RequestHeader
set|append|add|unset <var>header</var>
  -[<var>value</var>] [env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr
class="odd"><td class="descr" colspan="4">Configure HTTP request headers</td></tr>
  +[<var>value</var>] [early|env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr
class="odd"><td class="descr" colspan="4">Configure HTTP request headers</td></tr>
   <tr><td><a href="core.html#require">Require <var>Name</var>
[<var>Name</var>] ...</a></td><td></td><td>dh</td><td>C</td></tr><tr><td
class="descr" colspan="4">Whlt die authentisierten Benutzer aus, die auf eine
   Ressource zugreifen knnen</td></tr>
   <tr class="odd"><td><a href="mod_rewrite.html#rewritebase">RewriteBase
<em>URL-path</em></a></td><td></td><td>dh</td><td>E</td></tr><tr
class="odd"><td class="descr" colspan="4">Sets the base URL for per-directory rewrites</td></tr>
  
  
  
  1.124     +2 -2      httpd-2.0/docs/manual/mod/quickreference.html.en
  
  Index: quickreference.html.en
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/quickreference.html.en,v
  retrieving revision 1.123
  retrieving revision 1.124
  diff -u -u -r1.123 -r1.124
  --- quickreference.html.en	4 Jul 2004 10:25:21 -0000	1.123
  +++ quickreference.html.en	5 Jul 2004 19:15:55 -0000	1.124
  @@ -328,7 +328,7 @@
   <tr><td><a href="mpm_common.html#group" id="G" name="G">Group <var>unix-group</var></a></td><td>
#-1 </td><td>s</td><td>M</td></tr><tr><td class="descr"
colspan="4">Group under which the server will answer
   requests</td></tr>
   <tr class="odd"><td><a href="mod_headers.html#header" id="H" name="H">Header
[<var>condition</var>] set|append|add|unset|echo
  -<var>header</var> [<var>value</var>] [env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr
class="odd"><td class="descr" colspan="4">Configure HTTP response headers</td></tr>
  +<var>header</var> [<var>value</var>] [early|env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr
class="odd"><td class="descr" colspan="4">Configure HTTP response headers</td></tr>
   <tr><td><a href="mod_autoindex.html#headername">HeaderName <var>filename</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr><td
class="descr" colspan="4">Name of the file that will be inserted at the top
   of the index listing</td></tr>
   <tr class="odd"><td><a href="core.html#hostnamelookups">HostnameLookups
On|Off|Double</a></td><td> Off </td><td>svd</td><td>C</td></tr><tr
class="odd"><td class="descr" colspan="4">Enables DNS lookups on client IP addresses</td></tr>
  @@ -542,7 +542,7 @@
   ...</a></td><td></td><td>vdh</td><td>B</td></tr><tr><td
class="descr" colspan="4">Removes any content type associations for a set of file
   extensions</td></tr>
   <tr class="odd"><td><a href="mod_headers.html#requestheader">RequestHeader
set|append|add|unset <var>header</var>
  -[<var>value</var>] [env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr
class="odd"><td class="descr" colspan="4">Configure HTTP request headers</td></tr>
  +[<var>value</var>] [early|env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr
class="odd"><td class="descr" colspan="4">Configure HTTP request headers</td></tr>
   <tr><td><a href="core.html#require">Require <var>entity-name</var>
[<var>entity-name</var>] ...</a></td><td></td><td>dh</td><td>C</td></tr><tr><td
class="descr" colspan="4">Selects which authenticated users can access
   a resource</td></tr>
   <tr class="odd"><td><a href="mod_rewrite.html#rewritebase">RewriteBase
<em>URL-path</em></a></td><td></td><td>dh</td><td>E</td></tr><tr
class="odd"><td class="descr" colspan="4">Sets the base URL for per-directory rewrites</td></tr>
  
  
  
  1.9       +2 -2      httpd-2.0/docs/manual/mod/quickreference.html.es
  
  Index: quickreference.html.es
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/quickreference.html.es,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -u -r1.8 -r1.9
  --- quickreference.html.es	4 Jul 2004 10:25:22 -0000	1.8
  +++ quickreference.html.es	5 Jul 2004 19:15:55 -0000	1.9
  @@ -331,7 +331,7 @@
   <tr><td><a href="mpm_common.html#group" id="G" name="G">Group <var>unix-group</var></a></td><td>
#-1 </td><td>s</td><td>M</td></tr><tr><td class="descr"
colspan="4">Group under which the server will answer
   requests</td></tr>
   <tr class="odd"><td><a href="mod_headers.html#header" id="H" name="H">Header
[<var>condition</var>] set|append|add|unset|echo
  -<var>header</var> [<var>value</var>] [env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr
class="odd"><td class="descr" colspan="4">Configure HTTP response headers</td></tr>
  +<var>header</var> [<var>value</var>] [early|env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr
class="odd"><td class="descr" colspan="4">Configure HTTP response headers</td></tr>
   <tr><td><a href="mod_autoindex.html#headername">HeaderName <var>filename</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr><td
class="descr" colspan="4">Name of the file that will be inserted at the top
   of the index listing</td></tr>
   <tr class="odd"><td><a href="core.html#hostnamelookups">HostnameLookups
On|Off|Double</a></td><td> Off </td><td>svd</td><td>C</td></tr><tr
class="odd"><td class="descr" colspan="4">Enables DNS lookups on client IP addresses</td></tr>
  @@ -545,7 +545,7 @@
   ...</a></td><td></td><td>vdh</td><td>B</td></tr><tr><td
class="descr" colspan="4">Removes any content type associations for a set of file
   extensions</td></tr>
   <tr class="odd"><td><a href="mod_headers.html#requestheader">RequestHeader
set|append|add|unset <var>header</var>
  -[<var>value</var>] [env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr
class="odd"><td class="descr" colspan="4">Configure HTTP request headers</td></tr>
  +[<var>value</var>] [early|env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr
class="odd"><td class="descr" colspan="4">Configure HTTP request headers</td></tr>
   <tr><td><a href="core.html#require">Require <var>entity-name</var>
[<var>entity-name</var>] ...</a></td><td></td><td>dh</td><td>C</td></tr><tr><td
class="descr" colspan="4">Selects which authenticated users can access
   a resource</td></tr>
   <tr class="odd"><td><a href="mod_rewrite.html#rewritebase">RewriteBase
<em>URL-path</em></a></td><td></td><td>dh</td><td>E</td></tr><tr
class="odd"><td class="descr" colspan="4">Sets the base URL for per-directory rewrites</td></tr>
  
  
  
  1.8       +2 -2      httpd-2.0/docs/manual/mod/quickreference.html.ko.euc-kr
  
  Index: quickreference.html.ko.euc-kr
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/quickreference.html.ko.euc-kr,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -u -r1.7 -r1.8
  --- quickreference.html.ko.euc-kr	29 Jun 2004 16:57:34 -0000	1.7
  +++ quickreference.html.ko.euc-kr	5 Jul 2004 19:15:55 -0000	1.8
  @@ -286,7 +286,7 @@
   <tr class="odd"><td><a href="mpm_common.html#group" id="G" name="G">Group
<var>unix-group</var></a></td><td> #-1 </td><td>s</td><td>M</td></tr><tr
class="odd"><td class="descr" colspan="4">Group under which the server will answer
   requests</td></tr>
   <tr><td><a href="mod_headers.html#header" id="H" name="H">Header [<var>condition</var>]
set|append|add|unset|echo
  -<var>header</var> [<var>value</var>] [env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr><td
class="descr" colspan="4">Configure HTTP response headers</td></tr>
  +<var>header</var> [<var>value</var>] [early|env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr><td
class="descr" colspan="4">Configure HTTP response headers</td></tr>
   <tr class="odd"><td><a href="mod_autoindex.html#headername">HeaderName
<var>filename</var></a></td><td></td><td>svdh</td><td>B</td></tr><tr
class="odd"><td class="descr" colspan="4">ϸ    ̸</td></tr>
   <tr><td><a href="core.html#hostnamelookups">HostnameLookups On|Off|Double</a></td><td>
Off </td><td>svd</td><td>C</td></tr><tr><td class="descr"
colspan="4">Enables DNS lookups on client IP addresses</td></tr>
   <tr class="odd"><td><a href="mod_ident.html#identitycheck" id="I" name="I">IdentityCheck
On|Off</a></td><td> Off </td><td>svd</td><td>E</td></tr><tr
class="odd"><td class="descr" colspan="4">Enables logging of the RFC 1413 identity
of the remote
  @@ -493,7 +493,7 @@
   ...</a></td><td></td><td>vdh</td><td>B</td></tr><tr
class="odd"><td class="descr" colspan="4">Removes any content type associations for
a set of file
   extensions</td></tr>
   <tr><td><a href="mod_headers.html#requestheader">RequestHeader set|append|add|unset
<var>header</var>
  -[<var>value</var>] [env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr><td
class="descr" colspan="4">Configure HTTP request headers</td></tr>
  +[<var>value</var>] [early|env=[!]<var>variable</var>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr><td
class="descr" colspan="4">Configure HTTP request headers</td></tr>
   <tr class="odd"><td><a href="core.html#require">Require <var>entity-name</var>
[<var>entity-name</var>] ...</a></td><td></td><td>dh</td><td>C</td></tr><tr
class="odd"><td class="descr" colspan="4">Selects which authenticated users can access
   a resource</td></tr>
   <tr><td><a href="mod_rewrite.html#rewritebase">RewriteBase <em>URL-path</em></a></td><td></td><td>dh</td><td>E</td></tr><tr><td
class="descr" colspan="4">Sets the base URL for per-directory rewrites</td></tr>
  
  
  

Mime
View raw message