You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by nd...@apache.org on 2005/11/18 20:51:58 UTC
svn commit: r345552 - in /httpd/httpd/branches/2.2.x/docs/manual:
filter.html.en filter.xml.es filter.xml.fr filter.xml.ja filter.xml.ko
mod/core.html.en mod/core.xml.de mod/core.xml.ja
Author: nd
Date: Fri Nov 18 11:51:49 2005
New Revision: 345552
URL: http://svn.apache.org/viewcvs?rev=345552&view=rev
Log:
update transformation
Modified:
httpd/httpd/branches/2.2.x/docs/manual/filter.html.en
httpd/httpd/branches/2.2.x/docs/manual/filter.xml.es
httpd/httpd/branches/2.2.x/docs/manual/filter.xml.fr
httpd/httpd/branches/2.2.x/docs/manual/filter.xml.ja
httpd/httpd/branches/2.2.x/docs/manual/filter.xml.ko
httpd/httpd/branches/2.2.x/docs/manual/mod/core.html.en
httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml.de
httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml.ja
Modified: httpd/httpd/branches/2.2.x/docs/manual/filter.html.en
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/filter.html.en?rev=345552&r1=345551&r2=345552&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/filter.html.en (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/filter.html.en Fri Nov 18 11:51:49 2005
@@ -48,17 +48,19 @@
</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 @@
<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 @@
<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 @@
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"> en </a> |
Modified: httpd/httpd/branches/2.2.x/docs/manual/filter.xml.es
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/filter.xml.es?rev=345552&r1=345551&r2=345552&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/filter.xml.es (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/filter.xml.es Fri Nov 18 11:51:49 2005
@@ -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,
Modified: httpd/httpd/branches/2.2.x/docs/manual/filter.xml.fr
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/filter.xml.fr?rev=345552&r1=345551&r2=345552&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/filter.xml.fr (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/filter.xml.fr Fri Nov 18 11:51:49 2005
@@ -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,
Modified: httpd/httpd/branches/2.2.x/docs/manual/filter.xml.ja
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/filter.xml.ja?rev=345552&r1=345551&r2=345552&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/filter.xml.ja [iso-2022-jp] (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/filter.xml.ja [iso-2022-jp] Fri Nov 18 11:51:49 2005
@@ -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,
Modified: httpd/httpd/branches/2.2.x/docs/manual/filter.xml.ko
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/filter.xml.ko?rev=345552&r1=345551&r2=345552&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/filter.xml.ko [euc-kr] (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/filter.xml.ko [euc-kr] Fri Nov 18 11:51:49 2005
@@ -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,
Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/core.html.en
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/mod/core.html.en?rev=345552&r1=345551&r2=345552&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/mod/core.html.en (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/mod/core.html.en Fri Nov 18 11:51:49 2005
@@ -316,10 +316,12 @@
<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 @@
<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.
-
- 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>
+ 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>
+
+ <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 @@
<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 @@
<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 @@
<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>
Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml.de
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml.de?rev=345552&r1=345551&r2=345552&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml.de (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml.de Fri Nov 18 11:51:49 2005
@@ -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,
Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml.ja
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml.ja?rev=345552&r1=345551&r2=345552&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml.ja [iso-2022-jp] (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml.ja [iso-2022-jp] Fri Nov 18 11:51:49 2005
@@ -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,