From: André Malo <nd@apache.org>
Date: Fri, 18 Nov 2005 19:51:49 +0000 (+0000)
Subject: update transformation
X-Git-Tag: 2.1.10~3
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2b9b3adbf5038eb2294ca4fe94a416eae42b9204;p=thirdparty%2Fapache%2Fhttpd.git

update transformation


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x@345552 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/filter.html.en b/docs/manual/filter.html.en
index ebba31e68ab..b748c2423d2 100644
--- a/docs/manual/filter.html.en
+++ b/docs/manual/filter.html.en
@@ -48,17 +48,19 @@ independent of the traditional request processing phases.</p>
 </p>
 <p>Some examples of filtering in the standard Apache distribution are:</p>
 <ul>
-<li>mod_includes, implements server-side includes.</li>
-<li>mod_ssl, implements SSL encryption (https).</li>
-<li>mod_deflate, implements compression/decompression on the fly.</li>
-<li>mod_charset_lite, transcodes between different character sets.</li>
-<li>mod_ext_filter, runs an external program as a filter.</li>
+<li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code>, implements server-side includes.</li>
+<li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>, implements SSL encryption (https).</li>
+<li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code>, implements compression/decompression on the fly.</li>
+<li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code>, transcodes between different character sets.</li>
+<li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code>, runs an external program as a filter.</li>
 </ul>
-<p>Apache also uses a number of filters internally, to perform
+<p>Apache also uses a number of filters internally to perform
 functions like chunking and byte-range handling.</p>
 
-<p>A wider range of applications are implemented by third-party
-filter modules.  A few of these are:</p>
+<p>A wider range of applications are implemented by third-party filter
+modules available from <a href="http://modules.apache.org/">modules.apache.org</a> and
+elsewhere.  A few of these are:</p>
+
 <ul>
 <li>HTML and XML processing and rewriting</li>
 <li>XSLT transforms and XIncludes</li>
@@ -89,7 +91,7 @@ used as a provider and inserted dynamically.  For example,</p>
 <li>an HTML processing filter will only run if the content is
 text/html or application/xhtml+xml</li>
 <li>A compression filter will only run if the input is a
-compressable type and not already compressed</li>
+compressible type and not already compressed</li>
 <li>A charset conversion filter will be inserted if a text
 document is not already in the desired charset</li>
 </ul>
@@ -98,11 +100,11 @@ document is not already in the desired charset</li>
 <h2><a name="using" id="using">Using Filters</a></h2>
 
 <p>There are two ways to use filtering: Simple and Dynamic.
-In general, you should use one or the other: mixing them can
+In general, you should use one or the other; mixing them can
 have unexpected consequences (although simple Input filtering
-can be mixed freely with either simple or dynamic Output filtering!</p>
+can be mixed freely with either simple or dynamic Output filtering).</p>
 <p>The Simple Way is the only way to configure input filters, and is
-suficient for output filters where you need a static filter chain.
+sufficient for output filters where you need a static filter chain.
 Relevant directives are
     <code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code>,
     <code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code>,
@@ -115,11 +117,13 @@ Relevant directives are
 of output filters, as discussed in the <code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code> page.
 Relevant directives are
     <code class="directive"><a href="./mod/mod_filter.html#filterchain">FilterChain</a></code>,
-    <code class="directive"><a href="./mod/mod_filter.html#filterdeclare">FilterDeclare</a></code>,
+    <code class="directive"><a href="./mod/mod_filter.html#filterdeclare">FilterDeclare</a></code>, and
     <code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code>.</p>
-<p>One further directive AddOutputFilterByType is still supported,
-but may be problematic and is now deprecated.  Use dynamic configuration
-instead.</p>
+
+<p>One further directive <code class="directive"><a href="./mod/core.html#addoutputfilterbytype">AddOutputFilterByType</a></code> is still supported,
+but may be problematic and is now deprecated.  Use dynamic
+configuration instead.</p>
+
   </div></div>
 <div class="bottomlang">
 <p><span>Available Languages: </span><a href="./en/filter.html" title="English">&nbsp;en&nbsp;</a> |
diff --git a/docs/manual/filter.xml.es b/docs/manual/filter.xml.es
index 33342e65269..2224fce582a 100644
--- a/docs/manual/filter.xml.es
+++ b/docs/manual/filter.xml.es
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="./style/manual.es.xsl"?>
-<!-- English Revision: 151408:344973 (outdated) -->
+<!-- English Revision: 151408:345333 (outdated) -->
 
 <!--
  Copyright 2004-2005 The Apache Software Foundation or its licensors,
diff --git a/docs/manual/filter.xml.fr b/docs/manual/filter.xml.fr
index 078947583c2..a1830ac08ab 100644
--- a/docs/manual/filter.xml.fr
+++ b/docs/manual/filter.xml.fr
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
-<!-- English Revision: 151408:344973 (outdated) -->
+<!-- English Revision: 151408:345333 (outdated) -->
 
 <!--
  Copyright 2004-2005 The Apache Software Foundation or its licensors,
diff --git a/docs/manual/filter.xml.ja b/docs/manual/filter.xml.ja
index f00de9af229..54490283f39 100644
--- a/docs/manual/filter.xml.ja
+++ b/docs/manual/filter.xml.ja
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="iso-2022-jp" ?>
 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="./style/manual.ja.xsl"?>
-<!-- English Revision: 151408:344973 (outdated) -->
+<!-- English Revision: 151408:345333 (outdated) -->
 
 <!--
  Copyright 2002-2005 The Apache Software Foundation or its licensors,
diff --git a/docs/manual/filter.xml.ko b/docs/manual/filter.xml.ko
index d76b86b7d42..3e6d55d49f4 100644
--- a/docs/manual/filter.xml.ko
+++ b/docs/manual/filter.xml.ko
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="EUC-KR" ?>
 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="./style/manual.ko.xsl"?>
-<!-- English Revision: 151408:344973 (outdated) -->
+<!-- English Revision: 151408:345333 (outdated) -->
 
 <!--
  Copyright 2003-2005 The Apache Software Foundation or its licensors,
diff --git a/docs/manual/mod/core.html.en b/docs/manual/mod/core.html.en
index 7c6946b56e7..ff03acde700 100644
--- a/docs/manual/mod/core.html.en
+++ b/docs/manual/mod/core.html.en
@@ -316,10 +316,12 @@ content-type is <code>text/plain</code> or <code>text/html</code></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>Core</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.33 and later</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.33 and later; deprecated in Apache 2.1 and later</td></tr>
 </table>
     <p>This directive activates a particular output <a href="../filter.html">filter</a> for a request depending on the
-    response <a class="glossarylink" href="../glossary.html#mime-type" title="see glossary">MIME-type</a>.</p>
+    response <a class="glossarylink" href="../glossary.html#mime-type" title="see glossary">MIME-type</a>.  Because of certain
+    problems discussed below, this directive is deprecated.  The same
+    functionality is available using <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>.</p>
 
     <p>The following example uses the <code>DEFLATE</code> filter, which
     is provided by <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>. It will compress all
@@ -554,18 +556,20 @@ authentication</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 </table>
     <p>This directive selects the type of user authentication for a
-    directory. Only <code>Basic</code> and <code>Digest</code> are
-    currently implemented.
+    directory. The authentication types available are
+    <code>Basic</code> (implemented by
+    <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>) and <code>Digest</code>
+    (implemented by <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>).</p>
 
-     It must be accompanied by <code class="directive"><a href="#authname">AuthName</a></code> and <code class="directive"><a href="#require">Require</a></code> directives, and directives such
-     as <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> and
-     <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code> to
-     work.</p>
+    <p>To implement authentication, you must also use the <code class="directive"><a href="#authname">AuthName</a></code> and <code class="directive"><a href="#require">Require</a></code> directives.  In addition, the
+    server must have an authentication-provider module such as
+    <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> and an authorization module such
+    as <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code>.</p>
 
 <h3>See also</h3>
 <ul>
 <li><a href="../howto/auth.html">Authentication, Authorization,
-and Access Control</a></li>
+    and Access Control</a></li>
 </ul>
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -2392,8 +2396,11 @@ a resource</td></tr>
 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 </table>
-    <p>This directive selects which authenticated users can access
-    a resource. The allowed syntaxes are:</p>
+    <p>This directive selects which authenticated users can access a
+    resource.  The restrictions are processed by authorization
+    modules.  Some of the allowed syntaxes provided by
+    <code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code> and
+    <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> are:</p>
 
     <dl>
       <dt><code>Require user <var>userid</var> [<var>userid</var>]
@@ -2408,6 +2415,11 @@ a resource</td></tr>
       <dd>All valid users can access the resource.</dd>
     </dl>
 
+    <p>Other authorization modules that implement require options
+    include <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>,
+    <code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code>, and
+    <code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code>.</p>
+
     <p><code class="directive">Require</code> must be accompanied by
     <code class="directive"><a href="#authname">AuthName</a></code> and <code class="directive"><a href="#authtype">AuthType</a></code> directives, and directives such
     as <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
@@ -2432,6 +2444,8 @@ a resource</td></tr>
 
 <h3>See also</h3>
 <ul>
+<li><a href="../howto/auth.html">Authentication, Authorization,
+    and Access Control</a></li>
 <li><code class="directive"><a href="#satisfy">Satisfy</a></code></li>
 <li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li>
 </ul>
diff --git a/docs/manual/mod/core.xml.de b/docs/manual/mod/core.xml.de
index 6bcadb7a78c..1f2609fe988 100644
--- a/docs/manual/mod/core.xml.de
+++ b/docs/manual/mod/core.xml.de
@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.de.xsl"?>
-<!-- English Revision: 167959:344974 (outdated) -->
+<!-- English Revision: 167959:345333 (outdated) -->
 
 <!--
  Copyright 2003-2005 The Apache Software Foundation or its licensors,
diff --git a/docs/manual/mod/core.xml.ja b/docs/manual/mod/core.xml.ja
index ac7ecba7284..428183c3293 100644
--- a/docs/manual/mod/core.xml.ja
+++ b/docs/manual/mod/core.xml.ja
@@ -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: 190982:344974 (outdated) -->
+<!-- English Revision: 190982:345333 (outdated) -->
 
 <!--
  Copyright 2003-2005 The Apache Software Foundation or its licensors,