You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by sl...@apache.org on 2002/03/09 19:31:24 UTC
cvs commit: httpd-2.0/docs/manual/mod mod_include.html mod_info.html mod_isapi.html mod_log_config.html mod_mime.html mod_mime_magic.html mod_negotiation.html mod_usertrack.html
slive 02/03/09 10:31:23
Modified: docs/manual/mod mod_include.html mod_info.html
mod_isapi.html mod_log_config.html mod_mime.html
mod_mime_magic.html mod_negotiation.html
mod_usertrack.html
Log:
Update transformations.
Revision Changes Path
1.50 +29 -33 httpd-2.0/docs/manual/mod/mod_include.html
Index: mod_include.html
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_include.html,v
retrieving revision 1.49
retrieving revision 1.50
diff -u -d -b -u -r1.49 -r1.50
--- mod_include.html 6 Mar 2002 17:08:19 -0000 1.49
+++ mod_include.html 9 Mar 2002 18:31:23 -0000 1.50
@@ -2,8 +2,7 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
---><title>mod_include - Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img alt="[APACHE DOCUMENTATION]" src="../images/sub.gif"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_include</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td><description>This module provides for server-parsed html
-documents.</description></td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>include_module</td></tr><tr><td align="left" valign="top"><a href="module-dict.html#Compatibility" class="help">Compatibility:</a></td><td><compatibility></compatibility></td></tr></table></td></tr></table><h2>Summary</h2><summary>
+--><title>mod_include - Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img alt="[APACHE DOCUMENTATION]" src="../images/sub.gif"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_include</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td><description>Server-parsed html documents (Server Side Includes)</description></td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>include_module</td></tr></table></td></tr></table><h2>Summary</h2><summary>
<p>This module provides a filter which will process files
before they are sent to the client. The processing is
@@ -12,12 +11,7 @@
inclusion other files or programs, as well as the setting and
printing of environment variables.</p>
- <seealso><strong>See also</strong>:
- <a href="core.html#options" class="directive"><code class="directive">Options</code></a>,
- <a href="core.html#setoutputfilter" class="directive"><code class="directive">SetOutputFilter</code></a>
- and <a href="core.html#acceptpathinfo" class="directive"><code class="directive">AcceptPathInfo</code></a>.</seealso>
-
-</summary><h2>Directives</h2><ul><li><a href="#ssiendtag">SSIEndTag</a></li><li><a href="#ssierrormsg">SSIErrorMsg</a></li><li><a href="#ssistarttag">SSIStartTag</a></li><li><a href="#ssitimeformat">SSITimeFormat</a></li><li><a href="#xbithack">XBitHack</a></li></ul><h2><a name="enabling">Enabling Server-Side Includes</a></h2>
+</summary><p><strong>See also </strong></p><ul><li><a href="core.html#options" class="directive"><code class="directive">Options</code></a></li><li><a href="core.html#setoutputfilter" class="directive"><code class="directive">SetOutputFilter</code></a></li><li><a href="core.html#acceptpathinfo" class="directive"><code class="directive">AcceptPathInfo</code></a></li></ul><h2>Directives</h2><ul><li><a href="#ssiendtag">SSIEndTag</a></li><li><a href="#ssierrormsg">SSIErrorMsg</a></li><li><a href="#ssistarttag">SSIStartTag</a></li><li><a href="#ssitimeformat">SSITimeFormat</a></li><li><a href="#ssiundefinedecho">SSIUndefinedEcho</a></li><li><a href="#xbithack">XBitHack</a></li></ul><h2><a name="enabling">Enabling Server-Side Includes</a></h2>
<p>Server Side Includes are implemented by the
@@ -50,8 +44,8 @@
<code>text/x-server-parsed-html3</code> (and the resulting
output will have the mime type <code>text/html</code>).</p>
- <seealso>For more information, see our <a href="../howto/ssi.html">Tutorial on Server Side
- Includes</a>.</seealso>
+ <p>For more information, see our <a href="../howto/ssi.html">Tutorial on Server Side
+ Includes</a>.</p>
<h2><a name="basic">Basic Elements</a></h2>
<p>The document is parsed as an HTML document, with special
@@ -64,7 +58,7 @@
<p>The value will often be enclosed in double quotes; many
commands only allow a single attribute-value pair. Note that
- the comment terminator (<samp>--></samp>) should be preceded
+ the comment terminator (<code>--></code>) should be preceded
by whitespace to ensure that it isn't considered part of an SSI
token. </p>
@@ -99,7 +93,7 @@
</dl>
</dd>
- <dt><strong><a id="echo" name="echo">echo</a></strong></dt>
+ <dt><strong><a name="echo">echo</a></strong></dt>
<dd>
<p>This command prints one of the <a href="#includevars">include
@@ -352,10 +346,10 @@
<h2><a name="includevars">Include Variables</a></h2>
- In addition to the variables in the standard CGI environment,
+ <p>In addition to the variables in the standard CGI environment,
these are available for the <code>echo</code> command, for
<code>if</code> and <code>elif</code>, and to any program
- invoked by the document.
+ invoked by the document.</p>
<dl>
<dt>DATE_GMT</dt>
@@ -387,9 +381,9 @@
<p>Variable substitution is done within quoted strings in most
cases where they may reasonably occur as an argument to an SSI
- directive. This includes the <samp>config</samp>,
- <samp>exec</samp>, <samp>flastmod</samp>, <samp>fsize</samp>,
- <samp>include</samp>, and <samp>set</samp> directives, as well
+ directive. This includes the <code>config</code>,
+ <code>exec</code>, <code>flastmod</code>, <code>fsize</code>,
+ <code>include</code>, and <code>set</code> directives, as well
as the arguments to conditional operators. You can insert a
literal dollar sign into the string using backslash
quoting:</p>
@@ -407,10 +401,10 @@
<!--#set var="Zed" value="${REMOTE_HOST}_${REQUEST_METHOD}" -->
</code></td></tr></table></blockquote>
- <p>This will result in the <samp>Zed</samp> variable being set
- to "<samp>X_Y</samp>" if <samp>REMOTE_HOST</samp> is
- "<samp>X</samp>" and <samp>REQUEST_METHOD</samp> is
- "<samp>Y</samp>".</p>
+ <p>This will result in the <code>Zed</code> variable being set
+ to "<code>X_Y</code>" if <code>REMOTE_HOST</code> is
+ "<code>X</code>" and <code>REQUEST_METHOD</code> is
+ "<code>Y</code>".</p>
<p>EXAMPLE: the below example will print "in foo" if the
DOCUMENT_URI is /foo/file.html, "in bar" if it is
@@ -425,11 +419,11 @@
in neither<br>
<!--#endif -->
</code></td></tr></table></blockquote>
-<h2>Flow Control Elements</h2>
+<h2><a name="flowctrl">Flow Control Elements</a></h2>
- These are available in Apache 1.2 and above. The basic flow
- control elements are:
+ <p>These are available in Apache 1.2 and above. The basic flow
+ control elements are:</p>
<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
<!--#if expr="<em>test_condition</em>" --><br>
@@ -471,7 +465,7 @@
<dd>Compare string1 with string 2. If string2 has the form
<em>/string/</em> then it is compared as a regular
expression. Regular expressions have the same syntax as those
- found in the Unix <samp>egrep</samp> command.</dd>
+ found in the Unix <code>egrep</code> command.</dd>
<dt>( <em>test_condition</em> )</dt>
@@ -517,11 +511,11 @@
<h2>Using Server Side Includes for ErrorDocuments</h2>
- There is <a href="../misc/custom_errordocs.html">a document</a>
+ <p>There is <a href="../misc/custom_errordocs.html">a document</a>
which describes how to use the features of mod_include to offer
- internationalized customized server error documents.
+ internationalized customized server error documents.</p>
- <h2>PATH_INFO with Server Side Includes</h2>
+<h2>PATH_INFO with Server Side Includes</h2>
<p>Files processed for server-side includes no longer accept
requests with PATH_INFO (trailing pathname information) by
@@ -534,8 +528,7 @@
<p>This directive changes the string that mod_include looks for
to mark the end of a include command.</p>
- <seealso>See also: <code class="directive">SSIStartTag</code>.</seealso>
-</usage><hr/><h2><a name="SSIErrorMsg">SSIErrorMsg</a> <a name="ssierrormsg">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Changes the error message displayed when there is an error</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>SSIErrorMsg <em>message</em></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>SSIErrorMsg
+</usage><p><strong>See also </strong></p><ul><li><code class="directive">SSIStartTag</code></li></ul><hr/><h2><a name="SSIErrorMsg">SSIErrorMsg</a> <a name="ssierrormsg">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Changes the error message displayed when there is an error</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>SSIErrorMsg <em>message</em></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>SSIErrorMsg
"[an error occurred while processing this directive]"</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td/></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_include</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>Available in version 2.0.30 and later.</td></tr></table></td></tr></table><usage>
<p>The SSIErrorMsg directive changes the error message displayed
when mod_include encounters an error. For production servers you
@@ -556,9 +549,7 @@
output of a file each processing different commands (possibly at
different times).</p>
- <seealso>See also: <code class="directive">SSIEndTag</code></seealso>
-
-</usage><hr/><h2><a name="SSITimeFormat">SSITimeFormat</a> <a name="ssitimeformat">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Configures the format in which date strings are
+</usage><p><strong>See also </strong></p><ul><li><code class="directive">SSIEndTag</code></li></ul><hr/><h2><a name="SSITimeFormat">SSITimeFormat</a> <a name="ssitimeformat">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Configures the format in which date strings are
displayed</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>SSITimeFormat <em>formatstring</em></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>SSITimeFormat "%A, %d-%b-%Y %H:%M:%S %Z"</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td/></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_include</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>Available in version 2.0.30 and later.</td></tr></table></td></tr></table><usage>
<p>This directive changes the format in which date strings are displayed
when echoing DATE environment variables. The <em>formatstring</em>
@@ -566,6 +557,11 @@
<p>This directive has the same effect as the <code><--#config
timefmt=<em>formatstring</em> --></code> element.</p>
+</usage><hr/><h2><a name="SSIUndefinedEcho">SSIUndefinedEcho</a> <a name="ssiundefinedecho">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Changes the string that mod_include displays when
+a variable isn't set.</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>SSIUndefinedEcho <em>tag</em></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>SSIUndefinedEcho "<-- undef -->"</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td>FileInfo</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_include</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>Available in version 2.0.34 and later.
+</td></tr></table></td></tr></table><usage>
+ <p>This directive changes the string that mod_include displays
+ when a variable is not set and "echoed".</p>
</usage><hr/><h2><a name="XBitHack">XBitHack</a> <a name="xbithack">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Parse SSI directives in files with the execute
bit set</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>XBitHack on|off|full</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>XBitHack off</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td>Options</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_include</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td/></tr></table></td></tr></table><usage>
<p>The XBitHack directives controls the parsing of ordinary
1.16 +6 -9 httpd-2.0/docs/manual/mod/mod_info.html
Index: mod_info.html
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_info.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -b -u -r1.15 -r1.16
--- mod_info.html 6 Mar 2002 17:08:19 -0000 1.15
+++ mod_info.html 9 Mar 2002 18:31:23 -0000 1.16
@@ -2,13 +2,10 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
---><title>mod_info - Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img alt="[APACHE DOCUMENTATION]" src="../images/sub.gif"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_info</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td><description>This module provides a comprehensive overview of the server
-configuration including all installed modules and directives in the
-configuration files.</description></td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>info_module</td></tr><tr><td align="left" valign="top"><a href="module-dict.html#Compatibility" class="help">Compatibility:</a></td><td><compatibility>Available in Apache 1.1 and later</compatibility></td></tr></table></td></tr></table><h2>Summary</h2><summary>
-
- <h2>Using mod_info</h2>
+--><title>mod_info - Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img alt="[APACHE DOCUMENTATION]" src="../images/sub.gif"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_info</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td><description>Provides a comprehensive overview of the server
+configuration</description></td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>info_module</td></tr></table></td></tr></table><h2>Summary</h2><summary>
- <p>To configure it, add the following to your
+ <p>To configure <code><a href="mod_info.html">mod_info</a></code>, add the following to your
<code>httpd.conf</code> file.</p>
<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
@@ -17,12 +14,12 @@
</Location><br>
</code></td></tr></table></blockquote>
- You may wish to add a
+ <p>You may wish to add a
<a href="core.html#<limit>" class="directive"><code class="directive"><Limit></code></a>
clause inside the
<a href="core.html#<location>" class="directive"><code class="directive"><location></code></a>
directive to limit access to your server configuration
- information.
+ information.</p>
<p>Once configured, the server information is obtained by
accessing <code>http://your.host.dom/server-info</code></p>
@@ -45,7 +42,7 @@
ramifications for your site.</p>
</td></tr></table></blockquote>
</summary><h2>Directives</h2><ul><li><a href="#addmoduleinfo">AddModuleInfo</a></li></ul><hr/><h2><a name="AddModuleInfo">AddModuleInfo</a> <a name="addmoduleinfo">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Allows additional information to be added to the module
-information displayed by the server-info handler</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>AddModuleInfo <em>module-name string</em></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>none</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual
+information displayed by the server-info handler</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>AddModuleInfo <em>module-name string</em></syntax></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual
host</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_info</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>Apache 1.3 and above</td></tr></table></td></tr></table><usage>
<p>This allows the content of <em>string</em> to be shown as
HTML interpreted, <strong>Additional Information</strong> for
1.12 +49 -209 httpd-2.0/docs/manual/mod/mod_isapi.html
Index: mod_isapi.html
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_isapi.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -d -b -u -r1.11 -r1.12
--- mod_isapi.html 22 Sep 2001 19:36:01 -0000 1.11
+++ mod_isapi.html 9 Mar 2002 18:31:23 -0000 1.12
@@ -1,35 +1,8 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta name="generator" content="HTML Tidy, see www.w3.org" />
-
- <title>Apache module mod_isapi</title>
- </head>
- <!-- Background white, links blue (unvisited), navy (visited), red (active) -->
-
- <body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
- vlink="#000080" alink="#FF0000">
- <!--#include virtual="header.html" -->
-
- <h1 align="CENTER">Module mod_isapi</h1>
-
- <p>This module supports ISAPI Extensions within Apache for
- Windows.</p>
-
- <p><a href="module-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="module-dict.html#SourceFile"
- rel="Help"><strong>Source File:</strong></a> mod_isapi.c<br />
- <a href="module-dict.html#ModuleIdentifier"
- rel="Help"><strong>Module Identifier:</strong></a>
- isapi_module<br />
- <a href="module-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> WIN32 only</p>
-
- <h2>Summary</h2>
-
+<html xmlns="http://www.w3.org/TR/xhtml1/strict"><head><!--
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+--><title>mod_isapi - Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img alt="[APACHE DOCUMENTATION]" src="../images/sub.gif"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_isapi</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td><description>ISAPI Extensions within Apache for Windows</description></td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>isapi_module</td></tr><tr><td align="left" valign="top"><a href="module-dict.html#Compatibility" class="help">Compatibility:</a></td><td><compatibility>Win32 only</compatibility></td></tr></table></td></tr></table><h2>Summary</h2><summary>
<p>This module implements the Internet Server extension API. It
allows Internet Server extensions (<em>e.g.</em> ISAPI .dll
modules) to be served by Apache for Windows, subject to the
@@ -41,44 +14,23 @@
directly if you are experiencing problems running their ISAPI
extention. <strong>Please <em>do not</em> post such problems to
Apache's lists or bug reporting pages.</strong></p>
-
- <h2>Directives</h2>
-
- <ul>
- <li><a href="#isapifilecache">ISAPIFileCache</a></li>
-
- <li><a
- href="#isapireadaheadbuffer">ISAPIReadAheadBuffer</a></li>
-
- <li><a
- href="#isapilognotsupported">ISAPILogNotSupported</a></li>
-
- <li><a
- href="#isapiappendlogtoerrors">ISAPIAppendLogToErrors</a></li>
-
- <li><a
- href="#isapiappendlogtoquery">ISAPIAppendLogToQuery</a></li>
- </ul>
-
- <h2>Usage</h2>
-
- <p>In the server configuration file, use the AddHandler
- directive to associate ISAPI files with the
- <code>isapi-isa</code> handler, and map it to the with their
- file extensions. To enable any .dll file to be processed as an
- ISAPI extention, edit the httpd.conf file and add the following
- line:</p>
-<pre>
+</summary><h2>Directives</h2><ul><li><a href="#isapiappendlogtoerrors">ISAPIAppendLogToErrors</a></li><li><a href="#isapiappendlogtoquery">ISAPIAppendLogToQuery</a></li><li><a href="#isapifilechache">ISAPIFileChache</a></li><li><a href="#isapilognotsupported">ISAPILogNotSupported</a></li><li><a href="#isapireadaheadbuffer">ISAPIReadAheadBuffer</a></li></ul><h2>Usage</h2> <p>In the server configuration file, use
+the <a href="mod_mime.html#addhandler" class="directive"><code class="directive">AddHandler</code></a> directive to
+associate ISAPI files with the <code>isapi-isa</code> handler, and map
+it to the with their file extensions. To enable any .dll file to be
+processed as an ISAPI extention, edit the httpd.conf file and add the
+following line:</p>
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
AddHandler isapi-isa .dll
-</pre>
+</code></td></tr></table></blockquote>
<p>There is no capability within the Apache server to leave a
requested module loaded. However, you may preload and keep a
specific module loaded by using the following syntax in your
httpd.conf:</p>
-<pre>
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
ISAPICacheFile c:/WebWork/Scripts/ISAPI/mytest.dll
-</pre>
+</code></td></tr></table></blockquote>
<p>Whether or not you have preloaded an ISAPI extension, all
ISAPI extensions are governed by the same permissions and
@@ -86,12 +38,10 @@
ExecCGI</code> must be set for the directory that contains the
ISAPI .dll file.</p>
- <p>Review the <a href="#notes">Additional Notes</a> and the <a
- href="#journal">Programmer's Journal</a> for additional details
+ <p>Review the <a href="#notes">Additional Notes</a> and the <a href="#journal">Programmer's Journal</a> for additional details
and clarification of the specific ISAPI support offered by
mod_isapi.</p>
-
- <h2><a id="notes" name="notes">Additional Notes</a></h2>
+<h2><a name="notes">Additional Notes</a></h2>
<p>Apache's ISAPI implementation conforms to all of the ISAPI
2.0 specification, except for some "Microsoft-specific"
@@ -117,29 +67,27 @@
it <strong>does not support ISAPI Filters.</strong> Support for
filters may be added at a later date, but no support is planned
at this time.</p>
+<h2><a name="journal">Programmer's Journal</a></h2>
- <h2><a id="journal" name="journal">Programmer's
- Journal</a></h2>
-
- <p>If you are programming Apache 2.0 mod_isapi modules, you
- must limit your calls to ServerSupportFunction to the following
- directives:</p>
+ <p>If you are programming Apache 2.0 <code><a href="mod_isapi.html">mod_isapi</a></code>
+ modules, you must limit your calls to ServerSupportFunction to the
+ following directives:</p>
<dl>
<dt>HSE_REQ_SEND_URL_REDIRECT_RESP</dt>
- <dd>Redirect the user to another location.<br />
+ <dd>Redirect the user to another location.<br>
This must be a fully qualified URL (e.g.
http://server/location).</dd>
<dt>HSE_REQ_SEND_URL</dt>
- <dd>Redirect the user to another location.<br />
+ <dd>Redirect the user to another location.<br>
This cannot be a fully qualified URL, you are not allowed to
pass the protocol or a server name (e.g. simply
- /location).<br />
+ /location).<br>
This redirection is handled by the server, not the
- browser.<br />
+ browser.<br>
<strong>Warning:</strong> in their recent documentation,
Microsoft appears to have abandoned the distinction between
the two HSE_REQ_SEND_URL functions. Apache continues to treat
@@ -220,146 +168,38 @@
GetServerVariable, as well as the ALL_HTTP and ALL_RAW
values.</p>
- <p>Apache 2.0 mod_isapi supports additional features introduced
- in later versions of the ISAPI specification, as well as
- limited emulation of async I/O and the TransmitFile semantics.
- Apache also supports preloading ISAPI .dlls for performance,
- neither of which were not available under Apache 1.3
+ <p>Apache 2.0 <code><a href="mod_isapi.html">mod_isapi</a></code> supports additional
+ features introduced in later versions of the ISAPI specification,
+ as well as limited emulation of async I/O and the TransmitFile
+ semantics. Apache also supports preloading ISAPI .dlls for
+ performance, neither of which were not available under Apache 1.3
mod_isapi.</p>
- <hr />
-
- <h2><a id="isapifilecache" name="isapifilecache">ISAPIFileCache
- directive</a></h2>
- <!--%plaintext <?INDEX {\tt ISAPIFileCache} directive> -->
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> ISAPIFileCache
- <em>file</em> [<em>file</em>] ...<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config<br />
- <a href="directive-dict.html#Override"
- rel="Help"><strong>Override:</strong></a> None<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_isapi<br />
- <a href="module-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> Apache 2.0 and
- later, Win32 only
-
+<hr/><h2><a name="ISAPIAppendLogToErrors">ISAPIAppendLogToErrors</a> <a name="isapiappendlogtoerrors">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Record HSE_APPEND_LOG_PARAMETER requests from ISAPI
+extensions to the error log</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>ISAPIAppendLogToErrors on|off</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>ISAPIAppendLogToErrors off</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_isapi</td></tr></table></td></tr></table><usage>
+ <p>Record HSE_APPEND_LOG_PARAMETER requests from ISAPI
+ extensions to the server error log.</p>
+</usage><hr/><h2><a name="ISAPIAppendLogToQuery">ISAPIAppendLogToQuery</a> <a name="isapiappendlogtoquery">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Record HSE_APPEND_LOG_PARAMETER requests from ISAPI
+extensions to the query field</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>ISAPIAppendLogToQuery on|off</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>ISAPIAppendLogToQuery off</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_isapi</td></tr></table></td></tr></table><usage>
+ <p>Record HSE_APPEND_LOG_PARAMETER requests from ISAPI
+ extensions to the query field (appended to the CustomLog %q
+ component).</p>
+</usage><hr/><h2><a name="ISAPIFileChache">ISAPIFileChache</a> <a name="isapifilechache">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>ISAPI .dll files to be loaded at startup</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>ISAPIFileCache <em>file-path</em> [<em>file-path</em>] ...</syntax></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_isapi</td></tr></table></td></tr></table><usage>
<p>Specifies a space-separated list of file names to be loaded
when the Apache server is launched, and remain loaded until the
server is shut down. This directive may be repeated for every
ISAPI .dll file desired. The full path name of each file should
be specified.</p>
- <hr />
-
- <h2><a id="isapireadaheadbuffer"
- name="isapireadaheadbuffer">ISAPIReadAheadBuffer
- directive</a></h2>
- <!--%plaintext <?INDEX {\tt ISAPIReadAheadBuffer} directive> -->
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> ISAPIReadAheadBuffer
- <em>size</em><br />
- <a href="directive-dict.html#Default"
- rel="Help"><strong>Default:</strong></a> 49152<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config<br />
- <a href="directive-dict.html#Override"
- rel="Help"><strong>Override:</strong></a> None<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_isapi<br />
- <a href="module-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> Apache 1.3.13
- and later, Win32 only
-
+</usage><hr/><h2><a name="ISAPILogNotSupported">ISAPILogNotSupported</a> <a name="isapilognotsupported">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Log unsupported feature requests from ISAPI
+extensions</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>ISAPILogNotSupported on|off</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>ISAPILogNotSupported on</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_isapi</td></tr></table></td></tr></table><usage>
+ <p>Logs all requests for unsupported features from ISAPI
+ extensions in the server error log. While this should be turned
+ off once all desired ISAPI modules are functioning, it defaults
+ to on to help administrators track down problems.</p>
+</usage><hr/><h2><a name="ISAPIReadAheadBuffer">ISAPIReadAheadBuffer</a> <a name="isapireadaheadbuffer">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Size of the Read Ahead Buffer sent to ISAPI
+extensions</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>ISAPIReadAheadBuffer <em>size</em></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>ISAPIReadAheadBuffer 49152</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_isapi</td></tr></table></td></tr></table><usage>
<p>Defines the maximum size of the Read Ahead Buffer sent to
ISAPI extensions when they are initially invoked. All remaining
data must be retrieved using the ReadClient callback; some
ISAPI extensions may not support the ReadClient function. Refer
questions to the ISAPI extension's author.</p>
- <hr />
-
- <h2><a id="isapilognotsupported"
- name="isapilognotsupported">ISAPILogNotSupported
- directive</a></h2>
- <!--%plaintext <?INDEX {\tt ISAPILogNotSupported} directive> -->
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> ISAPILogNotSupported
- on|off<br />
- <a href="directive-dict.html#Default"
- rel="Help"><strong>Default:</strong></a> on<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config<br />
- <a href="directive-dict.html#Override"
- rel="Help"><strong>Override:</strong></a> None<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_isapi<br />
- <a href="module-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> Apache 1.3.13
- and later, Win32 only
-
- <p>Logs all requests for unsupported features from ISAPI
- extensions in the server error log. While this should be turned
- off once all desired ISAPI modules are functioning, it defaults
- to on to help administrators track down problems.</p>
- <hr />
-
- <h2><a id="isapiappendlogtoerrors"
- name="isapiappendlogtoerrors">ISAPIAppendLogToErrors
- directive</a></h2>
- <!--%plaintext <?INDEX {\tt ISAPIAppendLogToErrors} directive> -->
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> ISAPIAppendLogToErrors
- on|off<br />
- <a href="directive-dict.html#Default"
- rel="Help"><strong>Default:</strong></a> off<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config<br />
- <a href="directive-dict.html#Override"
- rel="Help"><strong>Override:</strong></a> None<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_isapi<br />
- <a href="module-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> Apache 1.3.13
- and later, Win32 only
-
- <p>Record HSE_APPEND_LOG_PARAMETER requests from ISAPI
- extensions to the server error log.</p>
- <hr />
-
- <h2><a id="isapiappendlogtoquery"
- name="isapiappendlogtoquery">ISAPIAppendLogToQuery
- directive</a></h2>
- <!--%plaintext <?INDEX {\tt ISAPIAppendLogToQuery} directive> -->
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> ISAPIAppendLogToQuery
- on|off<br />
- <a href="directive-dict.html#Default"
- rel="Help"><strong>Default:</strong></a> off<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config<br />
- <a href="directive-dict.html#Override"
- rel="Help"><strong>Override:</strong></a> None<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_isapi<br />
- <a href="module-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> Apache 1.3.13
- and later, Win32 only
-
- <p>Record HSE_APPEND_LOG_PARAMETER requests from ISAPI
- extensions to the query field (appended to the CustomLog %q
- component).</p>
-
- <p><!--#include virtual="footer.html" -->
- </p>
- </body>
-</html>
-
+</usage><hr/><h3 align="center">Apache HTTP Server Version 2.0</h3><a href="./"><img alt="Index" src="../images/index.gif"/></a><a href="../"><img alt="Home" src="../images/home.gif"/></a></blockquote></body></html>
\ No newline at end of file
1.58 +6 -16 httpd-2.0/docs/manual/mod/mod_log_config.html
Index: mod_log_config.html
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_log_config.html,v
retrieving revision 1.57
retrieving revision 1.58
diff -u -d -b -u -r1.57 -r1.58
--- mod_log_config.html 6 Mar 2002 17:08:19 -0000 1.57
+++ mod_log_config.html 9 Mar 2002 18:31:23 -0000 1.58
@@ -2,9 +2,7 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
---><title>mod_log_config - Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img alt="[APACHE DOCUMENTATION]" src="../images/sub.gif"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_log_config</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td><description>This module provides for logging of the requests
-made to the server, using the Common Log Format or a
-user-specified format.</description></td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>log_config_module</td></tr><tr><td align="left" valign="top"><a href="module-dict.html#Compatibility" class="help">Compatibility:</a></td><td><compatibility></compatibility></td></tr></table></td></tr></table><h2>Summary</h2><summary>
+--><title>mod_log_config - Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img alt="[APACHE DOCUMENTATION]" src="../images/sub.gif"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_log_config</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td><description>Logging of the requests made to the server</description></td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>log_config_module</td></tr></table></td></tr></table><h2>Summary</h2><summary>
<p>This module provides for flexible logging of client
requests. Logs are written in a customizable format, and may be
@@ -20,11 +18,7 @@
step. The <code>TransferLog</code> and <code>CustomLog</code>
directives can be used multiple times in each server to cause
each request to be logged to multiple files.</p>
-
-<seealso><strong>See also</strong>:
-<a href="../logs.html">Apache Log Files</a>.</seealso>
-
-<h2><a name="formats">Custom Log Formats</a></h2>
+</summary><p><strong>See also </strong></p><ul><li><a href="../logs.html">Apache Log Files</a></li></ul><h2>Directives</h2><ul><li><a href="#cookielog">CookieLog</a></li><li><a href="#customlog">CustomLog</a></li><li><a href="#logformat">LogFormat</a></li><li><a href="#transferlog">TransferLog</a></li></ul><h2><a name="formats">Custom Log Formats</a></h2>
<p>The format argument to the <code>LogFormat</code> and
@@ -187,8 +181,6 @@
because otherwise log analysis programs would have to duplicate
the entire vhost matching algorithm in order to decide what
host really served the request.</p>
-
-
<h2>Security Considerations</h2>
@@ -198,9 +190,7 @@
if the directory where logfiles are stored is writable by
anyone other than the user that starts the server.</p>
-
-
-</summary><h2>Directives</h2><ul><li><a href="#cookielog">CookieLog</a></li><li><a href="#customlog">CustomLog</a></li><li><a href="#logformat">LogFormat</a></li><li><a href="#transferlog">TransferLog</a></li></ul><hr/><h2><a name="CookieLog">CookieLog</a> <a name="cookielog">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Sets filename for the logging of cookies</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>CookieLog <em>filename</em></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>none</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual
+ <hr/><h2><a name="CookieLog">CookieLog</a> <a name="cookielog">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Sets filename for the logging of cookies</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>CookieLog <em>filename</em></syntax></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual
host</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_log_config</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>Only available in Apache 1.2 and above</td></tr></table></td></tr></table><usage>
<p>The <code class="directive">CookieLog</code> directive sets the
@@ -210,7 +200,7 @@
and is deprecated.</p>
</usage><hr/><h2><a name="CustomLog">CustomLog</a> <a name="customlog">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Sets filename and format of log file</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>CustomLog
<em>file</em>|<em>pipe</em> <em>format</em>|<em>nickname</em>
- [env=[!]<em>environment-variable</em>]</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>none</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual
+ [env=[!]<em>environment-variable</em>]</syntax></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual
host</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_log_config</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>Nickname only available in Apache 1.3 or later.
Conditional logging available in 1.3.5 or later.</td></tr></table></td></tr></table><usage>
<p>The <code class="directive">CustomLog</code> directive is used to
@@ -276,7 +266,7 @@
CustomLog nongif-requests.log common env=!gif-image
</code></td></tr></table></blockquote>
</usage><hr/><h2><a name="LogFormat">LogFormat</a> <a name="logformat">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Describes a format for use in a log file</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>LogFormat
- <em>format</em>|<em>nickname</em> [<em>nickname</em>]</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>none</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual
+ <em>format</em>|<em>nickname</em> [<em>nickname</em>]</syntax></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual
host</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_log_config</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>Nickname only available in Apache 1.3 or later.
</td></tr></table></td></tr></table><usage>
<p>This directive specifies the format of the access log
@@ -306,7 +296,7 @@
default. Therefore, it will not affect subsequent
<code class="directive">TransferLog</code> directives.</p>
-</usage><hr/><h2><a name="TransferLog">TransferLog</a> <a name="transferlog">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Specifly location of a log file</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>TransferLog <em>file</em>|<em>pipe</em></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>none</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual
+</usage><hr/><h2><a name="TransferLog">TransferLog</a> <a name="transferlog">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Specifly location of a log file</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>TransferLog <em>file</em>|<em>pipe</em></syntax></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual
host</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_log_config</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td/></tr></table></td></tr></table><usage>
<p>This directive has exactly the same arguments and effect as
1.54 +232 -549 httpd-2.0/docs/manual/mod/mod_mime.html
Index: mod_mime.html
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_mime.html,v
retrieving revision 1.53
retrieving revision 1.54
diff -u -d -b -u -r1.53 -r1.54
--- mod_mime.html 26 Nov 2001 18:35:12 -0000 1.53
+++ mod_mime.html 9 Mar 2002 18:31:23 -0000 1.54
@@ -1,48 +1,25 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta name="generator" content="HTML Tidy, see www.w3.org" />
-
- <title>Apache module mod_mime</title>
- </head>
- <!-- Background white, links blue (unvisited), navy (visited), red (active) -->
-
- <body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
- vlink="#000080" alink="#FF0000">
- <!--#include virtual="header.html" -->
-
- <h1 align="center">Module mod_mime</h1>
-
- <p>This module associates the request filename's extensions
+<html xmlns="http://www.w3.org/TR/xhtml1/strict"><head><!--
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+--><title>mod_mime - Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img alt="[APACHE DOCUMENTATION]" src="../images/sub.gif"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_mime</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td><description>Associates the request filename's extensions
(e.g. .html) with the file's behavior (handlers and filters)
and content (mime-type, language, character set and
- encoding.)</p>
-
- <p><a href="module-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="module-dict.html#SourceFile"
- rel="Help"><strong>Source File:</strong></a> mod_mime.c<br />
- <a href="module-dict.html#ModuleIdentifier"
- rel="Help"><strong>Module Identifier:</strong></a>
- mime_module</p>
-
- <h2>Summary</h2>
- This module is used to associate various bits of "meta
+ encoding)</description></td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>mime_module</td></tr></table></td></tr></table><h2>Summary</h2><summary>
+ <p>This module is used to associate various bits of "meta
information" with files by their filename extensions. This
information relates the filename of the document to it's
mime-type, language, character set and encoding. This
information is sent to the browser, and participates in content
negotiation, so the user's preferences are respected when
- choosing one of several possible files to serve. See <a
- href="mod_negotiation">mod_negotiation</a> for more information
- about content negotiation.
+ choosing one of several possible files to serve. See
+ <code><a href="mod_negotiation.html">mod_negotiation</a></code> for more information
+ about content negotiation. </p>
- <p>The directives <a href="#addcharset">AddCharset</a>, <a
- href="#addencoding">AddEncoding</a>, <a
- href="#addlanguage">AddLanguage</a> and <a
- href="#addtype">AddType</a> are all used to map file extensions
+ <p>The directives <code class="directive">AddCharset</code>,
+ <code class="directive">AddEncoding</code>,
+ <code class="directive">AddLanguage</code> and
+ <code class="directive">AddType</code> all used to map file extensions
onto the meta-information for that file. Respectively they set
the character set, content-encoding, content-language, and
MIME-type (content-type) of documents.</p>
@@ -56,15 +33,15 @@
and POST content should be processed through (the input
filters.)</p>
- <p>The directives <a href="#addhandler">AddHandler</a>, <a
- href="#addoutputfilter">AddOutputFilter</a>, and <a
- href="#addinputfilter">AddInputFilter</a> control the modules
+ <p>The directives <code class="directive">AddHandler</code>,
+ <code class="directive">AddOutputFilter</code>, and
+ <code class="directive">AddInputFilter</code> control the modules
or scripts that serve the document. The
- <a href="#multiviewsmatch">MultiviewsMatch</a> directive allows
- <a href="mod_negotiation">mod_negotiation</a> to consider these
+ <code class="directive">MultiviewsMatch</code> directive allows
+ <code class="directive">mod_negotiation</code> to consider these
file extensions to included when testing Multiviews matches.</p>
- <p>The directive <a href="#typesconfig">TypesConfig</a> is used
+ <p>The directive <code class="directive">TypesConfig</code> is used
to specify a file which also maps extensions onto MIME types.
Most administrators use the provided mime.types file which
associates common filename extensions with IANA registered
@@ -72,21 +49,20 @@
<code>http://www.isi.edu/in-notes/iana/assignments/media-types/media-types</code>
although it may be mirrored elsewhere). This simplifies the
httpd.conf file by providing the majority of media-type
- definitions, and they may be overridden by <a
- href="#addtype">AddType</a> directives as needed.</p>
+ definitions, and they may be overridden by
+ <code class="directive">AddType</code> directives as needed.</p>
- <p><em>Please do not send requests to the Apache httpd Project
+ <blockquote><table><tr><td bgcolor="#e0e5f5">Please do not send requests to the Apache httpd Project
to add any new entries in the distributed mime.types file
unless (1) they are already registered with IANA, and (2) they
use widely accepted, non-conflicting filename extensions across
platforms. category/x-subtype requests will be automatically
rejected, as will any new two-letter extensions as they will
likely conflict later with the already crowded language and
- character set namespace.</em></p>
+ character set namespace.</td></tr></table></blockquote>
- <p>The core directives <a
- href="core.html#forcetype">ForceType</a> and <a
- href="core.html#sethandler">SetHandler</a> are used to
+ <p>The core directives <a href="core.html#forcetype" class="directive"><code class="directive">ForceType</code></a> and
+ <code class="directive">SetHandler</code> are used to
associate all the files in a given container (<em>e.g.</em>,
<location>, <directory>, or <Files>) with a
particular MIME-type or handler. These settings override any
@@ -100,50 +76,8 @@
encoding) you may need to 'touch' affected files (updating
their last modified date) to ensure that all visitors are
receive the corrected content headers.</p>
+</summary><p><strong>See also </strong></p><ul><li>See also: <a href="mod_mime_magic.html#mimemagicfile" class="directive"><code class="directive">MimeMagicFile</code></a></li></ul><h2>Directives</h2><ul><li><a href="#addcharset">AddCharset</a></li><li><a href="#addencoding">AddEncoding</a></li><li><a href="#addhandler">AddHandler</a></li><li><a href="#addinputfilter">AddInputFilter</a></li><li><a href="#addlanguage">AddLanguage</a></li><li><a href="#addoutputfilter">AddOutputFilter</a></li><li><a href="#addtype">AddType</a></li><li><a href="#defaultlanguage">DefaultLanguage</a></li><li><a href="#multiviewsmatch">MultiviewsMatch</a></li><li><a href="#removecharset">RemoveCharset</a></li><li><a href="#removeencoding">RemoveEncoding</a></li><li><a href="#removehandler">RemoveHandler</a></li><li><a href="#removeinputfilter">RemoveInputFilter</a></li><li><a href="#removelanguage">RemoveLanguage</a></li><li><a href="#removeoutputfilter">RemoveOutputFilter</a></li><li><a href="#removetype">RemoveType</a></li><li><a href="#typesconfig">TypesConfig</a></li></ul><h2><a name="multipleext">Files with Multiple Extensions</a></h2>
- <h2>Directives</h2>
-
- <ul>
- <li><a href="#addcharset">AddCharset</a></li>
-
- <li><a href="#addencoding">AddEncoding</a></li>
-
- <li><a href="#addhandler">AddHandler</a></li>
-
- <li><a href="#addinputfilter">AddInputFilter</a></li>
-
- <li><a href="#addlanguage">AddLanguage</a></li>
-
- <li><a href="#addoutputfilter">AddOutputFilter</a></li>
-
- <li><a href="#addtype">AddType</a></li>
-
- <li><a href="#defaultlanguage">DefaultLanguage</a></li>
-
- <li><a href="#multiviewsmatch">MultiviewsMatch</a></li>
-
- <li><a href="#removecharset">RemoveCharset</a></li>
-
- <li><a href="#removeencoding">RemoveEncoding</a></li>
-
- <li><a href="#removehandler">RemoveHandler</a></li>
-
- <li><a href="#removeinputfilter">RemoveInputFilter</a></li>
-
- <li><a href="#removelanguage">RemoveLanguage</a></li>
-
- <li><a href="#removeoutputfilter">RemoveOutputFilter</a></li>
-
- <li><a href="#removetype">RemoveType</a></li>
-
- <li><a href="#typesconfig">TypesConfig</a></li>
- </ul>
-
- <p>See also: <a
- href="mod_mime_magic.html#mimemagicfile">MimeMagicFile</a>.</p>
-
-<h2><a id="multipleext" name="multipleext">Files with Multiple
- Extensions</a></h2>
<p>Files can have more than one extension, and the order of the
extensions is <em>normally</em> irrelevant. For example, if the
@@ -168,20 +102,19 @@
MIME-type. When it is processed, the "imap-file" handler will
be used, and so it will be treated as a mod_imap imagemap
file.</p>
-
-<h2><a id="contentencoding" name="contentencoding">Content encoding</a></h2>
+<h2><a name="contentencoding">Content encoding</a></h2>
<p>A file of a particular MIME type can additionally be encoded a
particular way to simplify transmission over the Internet.
While this usually will refer to compression, such as
- <samp>gzip</samp>, it can also refer to encryption, such a
- <samp>pgp</samp> or to an encoding such as UUencoding, which is
+ <code>gzip</code>, it can also refer to encryption, such a
+ <code>pgp</code> or to an encoding such as UUencoding, which is
designed for transmitting a binary file in an ASCII (text)
format.</p>
<p>The MIME RFC puts it this way:</p>
- <blockquote>
+ <blockquote><table><tr><td bgcolor="#e0e5f5">
The Content-Encoding entity-header field is used as a
modifier to the media-type. When present, its value indicates
what additional content coding has been applied to the
@@ -190,29 +123,31 @@
header field. The Content-Encoding is primarily used to allow
a document to be compressed without losing the identity of
its underlying media type.
- </blockquote>
- By using more than one file extension (see <a
- href="#multipleext">section above about multiple file
+ </td></tr></table></blockquote>
+
+ <p>By using more than one file extension (see <a href="#multipleext">section above about multiple file
extensions</a>), you can indicate that a file is of a
particular <em>type</em>, and also has a particular
- <em>encoding</em>.
+ <em>encoding</em>. </p>
<p>For example, you may have a file which is a Microsoft Word
document, which is pkzipped to reduce its size. If the
- <samp>.doc</samp> extension is associated with the Microsoft
- Word file type, and the <samp>.zip</samp> extension is
+ <code>.doc</code> extension is associated with the Microsoft
+ Word file type, and the <code>.zip</code> extension is
associated with the pkzip file encoding, then the file
- <samp>Resume.doc.zip</samp>would be known to be a pkzip'ed Word
+ <code>Resume.doc.zip</code>would be known to be a pkzip'ed Word
document.</p>
- <p>Apache send a <samp>Content-encoding</samp> header with the
+ <p>Apache send a <code>Content-encoding</code> header with the
resource, in order to tell the client browser about the
encoding method.</p>
- <p><samp>Content-encoding: pkzip</samp></p>
+ <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>Content-encoding: pkzip</code></td></tr></table></blockquote>
<h2>Character sets and languages</h2>
+
+
<p>In addition to file type and the file encoding,
another important piece of information is what language a
particular document is in, and in what character set the file
@@ -222,101 +157,73 @@
HTTP headers.</p>
<p>The character set, language encoding and mime type are all
- used in the process of content negotiation (See <a
- href="mod_negotiation.html">mod_negotiation</a>) to determine
+ used in the process of content negotiation (See
+ <code><a href="mod_negotiation.html">mod_negotiation</a></code>) to determine
which document to give to the client, when there are
alternative documents in more than one character set, language,
encoding or mime type. All filename extensions associations
- created with <code>AddCharset</code>, <code>AddEncoding</code>,
- <code>AddLanguage</code> and <code>AddType</code> directives
- (and extensions listed in the <code>MimeMagicFile</code>)
+ created with <code><a href="AddCharset.html">AddCharset</a></code>, <code><a href="AddEncoding.html">AddEncoding</a></code>,
+ <code><a href="AddLanguage.html">AddLanguage</a></code> and <code><a href="AddType.html">AddType</a></code> directives
+ (and extensions listed in the <code><a href="MimeMagicFile.html">MimeMagicFile</a></code>)
participate in this select process. Filename extensions that
- are only associated using the <code>AddHandler</code>,
- <code>AddInputFilter</code> or <code>AddOutputFilter</code>
+ are only associated using the <code><a href="AddHandler.html">AddHandler</a></code>,
+ <code><a href="AddInputFilter.html">AddInputFilter</a></code> or <code><a href="AddOutputFilter.html">AddOutputFilter</a></code>
directives may be included or excluded from matching by using
- the <a href="#multiviewsmatch">MultiviewsMatch</a> directive.</p>
+ the <code class="directive">MultiviewsMatch</code> directive.</p>
+
+<h3>Charset</h3>
-Charset</p>
<p>To convey this further information, Apache optionally sends
- a <samp>Content-Language</samp> header, to specify the language
+ a <code>Content-Language</code> header, to specify the language
that the document is in, and can append additional information
- onto the <samp>Content-Type</samp> header to indicate the
+ onto the <code>Content-Type</code> header to indicate the
particular character set that should be used to correctly
render the information.</p>
-<pre>
-Content-Language: en, fr
+
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
+Content-Language: en, fr<br>
Content-Type: text/plain; charset=ISO-8859-2
-</pre>
+</code></td></tr></table></blockquote>
<p>The language specification is the two-letter abbreviation
- for the language. The <samp>charset</samp> is the name of the
+ for the language. The <code>charset</code> is the name of the
particular character set which should be used.</p>
- <hr />
- <h2><a id="addcharset" name="addcharset">AddCharset</a>
- directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> AddCharset <em>charset
- extension</em> [<em>extension</em>] ...<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config, virtual
- host, directory, .htaccess<br />
- <a href="directive-dict.html#Override"
- rel="Help"><strong>Override:</strong></a> FileInfo<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_mime <br />
- <a href="directive-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> AddCharset is
- only available in Apache 1.3.10 and later
+<hr/><h2><a name="AddCharset">AddCharset</a> <a name="addcharset">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Maps the given filename extensions
+ to the specified content charset</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>AddCharset <em>charset extension</em>
+[<em>extension</em>] ...</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td>FileInfo</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>AddCharset is only available in Apache
+1.3.10 and later</td></tr></table></td></tr></table><usage>
<p>The AddCharset directive maps the given filename extensions
- to the specified content charset. <i>charset</i> is the MIME
- charset parameter of filenames containing <i>extension</i>.
+ to the specified content charset. <em>charset</em> is the MIME
+ charset parameter of filenames containing <em>extension</em>.
This mapping is added to any already in force, overriding any
- mappings that already exist for the same <i>extension</i>.</p>
+ mappings that already exist for the same <em>extension</em>.</p>
<p>Example:</p>
-<pre>
- AddLanguage ja .ja
- AddCharset EUC-JP .euc
- AddCharset ISO-2022-JP .jis
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
+ AddLanguage ja .ja<br>
+ AddCharset EUC-JP .euc<br>
+ AddCharset ISO-2022-JP .jis<br>
AddCharset SHIFT_JIS .sjis
-</pre>
+</code></td></tr></table></blockquote>
<p>Then the document <code>xxxx.ja.jis</code> will be treated
as being a Japanese document whose charset is ISO-2022-JP (as
will the document <code>xxxx.jis.ja</code>). The AddCharset
directive is useful for both to inform the client about the
character encoding of the document so that the document can be
- interpreted and displayed appropriately, and for <a
- href="../content-negotiation.html">content negotiation</a>,
+ interpreted and displayed appropriately, and for <a href="../content-negotiation.html">content negotiation</a>,
where the server returns one from several documents based on
the client's charset preference.</p>
<p>The <em>extension</em> argument is case-insensitive, and can
be specified with or without a leading dot.</p>
- <p><strong>See also</strong>: <a
- href="mod_negotiation.html">mod_negotiation</a></p>
- <hr />
-
- <h2><a id="addencoding" name="addencoding">AddEncoding</a>
- directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> AddEncoding
- <em>MIME-enc extension</em> [<em>extension</em>] ...<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config, virtual
- host, directory, .htaccess<br />
- <a href="directive-dict.html#Override"
- rel="Help"><strong>Override:</strong></a> FileInfo<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_mime
+</usage><p><strong>See also </strong></p><ul><li><code><a href="mod_negotiation.html">mod_negotiation</a></code></li></ul><hr/><h2><a name="AddEncoding">AddEncoding</a> <a name="addencoding">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Maps the given filename extensions
+ to the specified encoding type</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>AddEncoding
+ <em>MIME-enc extension</em> [<em>extension</em>] ...</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td>FileInfo</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr></table></td></tr></table><usage>
<p>The AddEncoding directive maps the given filename extensions
to the specified encoding type. <em>MIME-enc</em> is the MIME
@@ -325,14 +232,15 @@
force, overriding any mappings that already exist for the same
<em>extension</em>. Example:</p>
- <blockquote>
- <code>AddEncoding x-gzip .gz<br />
- AddEncoding x-compress .Z</code>
- </blockquote>
- This will cause filenames containing the .gz extension to be
+ <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
+ AddEncoding x-gzip .gz<br>
+ AddEncoding x-compress .Z
+ </code></td></tr></table></blockquote>
+
+ <p>This will cause filenames containing the .gz extension to be
marked as encoded using the x-gzip encoding, and filenames
containing the .Z extension to be marked as encoded with
- x-compress.
+ x-compress. </p>
<p>Old clients expect <code>x-gzip</code> and
<code>x-compress</code>, however the standard dictates that
@@ -352,37 +260,19 @@
<p>The <em>extension</em> argument is case-insensitive, and can
be specified with or without a leading dot.</p>
- <p><strong>See also</strong>: <a href="#multipleext">Files with
- multiple extensions</a></p>
- <hr />
-
- <h2><a id="addhandler" name="addhandler">AddHandler</a>
- directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> AddHandler
- <em>handler-name extension</em> [<em>extension</em>] ...<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config, virtual
- host, directory, .htaccess<br />
- <a href="directive-dict.html#Override"
- rel="Help"><strong>Override:</strong></a> FileInfo<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_mime<br />
- <a href="directive-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> AddHandler is
- only available in Apache 1.1 and later
-
- <p>AddHandler maps the filename extensions <em>extension</em>
- to the <a href="../handler.html">handler</a>
- <em>handler-name</em>. This mapping is added to any already in
+</usage><p><strong>See also </strong></p><ul><li><a href="#multipleext">Files with
+ multiple extensions</a></li></ul><hr/><h2><a name="AddHandler">AddHandler</a> <a name="addhandler">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>AddHandler maps the filename extensions
+to the handler
+handler-name</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>AddHandler
+ <em>handler-name extension</em> [<em>extension</em>] ...</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td>FileInfo</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td/></tr></table></td></tr></table><usage>
+<p>This mapping is added to any already in
force, overriding any mappings that already exist for the same
<em>extension</em>. For example, to activate CGI scripts with
the file extension "<code>.cgi</code>", you might use:</p>
-<pre>
+
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
AddHandler cgi-script .cgi
-</pre>
+</code></td></tr></table></blockquote>
<p>Once that has been put into your srm.conf or httpd.conf
file, any file containing the "<code>.cgi</code>" extension
@@ -391,34 +281,19 @@
<p>The <em>extension</em> argument is case-insensitive, and can
be specified with or without a leading dot.</p>
- <p><strong>See also</strong>: <a href="#multipleext">Files with
- multiple extensions</a></p>
- <hr />
-
- <h2><a id="addinputfilter" name="addinputfilter">AddInputFilter
- directive</a></h2>
-
- <p><a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> AddInputFilter
+</usage><p><strong>See also </strong></p><ul><li><a href="#multipleext">Files with
+ multiple extensions</a></li></ul><hr/><h2><a name="AddInputFilter">AddInputFilter</a> <a name="addinputfilter">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Maps the filename extensions
+ to the filter or filters which will process
+ client requests</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>AddInputFilter
<em>filter</em>[<em>;filter</em>...] extension
- [<em>extension</em> ...]<br />
- <a href="directive-dict.html#Default"
- rel="Help"><strong>Default:</strong></a> none<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> directory, files,
- location, .htaccess<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> mod_mime<br />
- <a href="directive-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> AddInputFilter
- is only available in Apache 2.0.26 and later.</p>
+ [<em>extension</em> ...]</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>AddInputFilter
+ is only available in Apache 2.0.26 and later.</td></tr></table></td></tr></table><usage>
<p>AddInputFilter maps the filename extensions
<em>extension</em> to the filter or filters which will process
client requests and POST input when they are received by the
server. This is in addition to any filters defined elsewhere,
- including the <a
- href="core.html#setinputfilter">SetInputFilter</a> directive.
+ including the <a href="core.html#setinputfilter">SetInputFilter</a> directive.
This mapping is merged over any already in force, overriding
any mappings that already exist for the same
<em>extension</em>.</p>
@@ -429,24 +304,10 @@
case-insensitive, and the extension may be specified with or
without a leading dot.</p>
- <p>See also the <a href="../filter.html">Filters</a>
- documentation.</p>
- <hr />
-
- <h2><a id="addlanguage" name="addlanguage">AddLanguage</a>
- directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> AddLanguage
- <em>MIME-lang extension</em> [<em>extension</em>] ...<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config, virtual
- host, directory, .htaccess<br />
- <a href="directive-dict.html#Override"
- rel="Help"><strong>Override:</strong></a> FileInfo<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_mime
+</usage><p><strong>See also </strong></p><ul><li><a href="../filter.html">Filters</a>
+ documentation.</li></ul><hr/><h2><a name="AddLanguage">AddLanguage</a> <a name="addlanguage">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Maps the given filename extension
+to the specified content language</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>AddLanguage
+ <em>MIME-lang extension</em> [<em>extension</em>] ...</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td>FileInfo</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr></table></td></tr></table><usage>
<p>The AddLanguage directive maps the given filename extension
to the specified content language. <em>MIME-lang</em> is the
@@ -457,30 +318,29 @@
<p>Example:</p>
- <blockquote>
- <code>AddEncoding x-compress .Z<br />
- AddLanguage en .en<br />
- AddLanguage fr .fr<br />
- </code>
- </blockquote>
+ <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
+ AddEncoding x-compress .Z<br>
+ AddLanguage en .en<br>
+ AddLanguage fr .fr
+ </code></td></tr></table></blockquote>
<p>Then the document <code>xxxx.en.Z</code> will be treated as
being a compressed English document (as will the document
<code>xxxx.Z.en</code>). Although the content language is
reported to the client, the browser is unlikely to use this
- information. The AddLanguage directive is more useful for <a
- href="../content-negotiation.html">content negotiation</a>,
+ information. The AddLanguage directive is more useful for <a href="../content-negotiation.html">content negotiation</a>,
where the server returns one from several documents based on
the client's language preference.</p>
<p>If multiple language assignments are made for the same
extension, the last one encountered is the one that is used.
That is, for the case of:</p>
-<pre>
- AddLanguage en .en
- AddLanguage en-uk .en
+
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
+ AddLanguage en .en<br>
+ AddLanguage en-uk .en<br>
AddLanguage en-us .en
-</pre>
+</code></td></tr></table></blockquote>
<p>documents with the extension "<code>.en</code>" would be
treated as being "<code>en-us</code>".</p>
@@ -488,46 +348,30 @@
<p>The <em>extension</em> argument is case-insensitive, and can
be specified with or without a leading dot.</p>
- <p><strong>See also</strong>: <a href="#multipleext">Files with
- multiple extensions</a>, <a
- href="./mod_negotiation.html">mod_negotiation</a></p>
- <hr />
-
- <h2><a id="addoutputfilter"
- name="addoutputfilter">AddOutputFilter directive</a></h2>
-
- <p><a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> AddOutputFilter
+</usage><p><strong>See also </strong></p><ul><li><a href="#multipleext">Files with
+ multiple extensions</a></li><li><code><a href="mod_negotiation.html">mod_negotiation</a></code></li></ul><hr/><h2><a name="AddOutputFilter">AddOutputFilter</a> <a name="addoutputfilter">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>maps the filename
+extensions to the filters that will process
+responses from the server</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>AddOutputFilter
<em>filter</em>[<em>;filter</em>...] extension
- [<em>extension</em> ...]<br />
- <a href="directive-dict.html#Default"
- rel="Help"><strong>Default:</strong></a> none<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> directory, files,
- location, .htaccess<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> mod_mime<br />
- <a href="directive-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> AddOutputFilter
- is only available in Apache 2.0.26 and later.</p>
+ [<em>extension</em> ...]</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td/></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>AddOutputFilter
+ is only available in Apache 2.0.26 and later.</td></tr></table></td></tr></table><usage>
- <p>The <code>AddOutputFilter</code> directive maps the filename
+ <p>The <code class="directive">AddOutputFilter</code> directive maps the filename
extensions <em>extension</em> to the filters which will process
responses from the server before they are sent to the client.
This is in addition to any filters defined elsewhere, including
- the <a href="core.html#setoutputfilter">SetOutputFilter</a>
+ the <a href="core.html#setoutputfilter" class="directive"><code class="directive">SetOutputFilter</code></a>
directive. This mapping is merged over any already in force,
overriding any mappings that already exist for the same
<em>extension</em>.</p>
- For example, the following configuration will process all
- .shtml files for server-side includes.<br />
- <br />
+ <p>For example, the following configuration will process all
+ .shtml files for server-side includes.</p>
- <blockquote>
- <code> AddOutputFilter INCLUDES shtml<br />
- </code>
- </blockquote>
+
+ <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
+ AddOutputFilter INCLUDES shtml
+ </code></td></tr></table></blockquote>
<p>If more than one filter is specified, they must be separated
by semicolons in the order in which they should process the
@@ -535,23 +379,9 @@
case-insensitive, and the extension may be specified with or
without a leading dot.</p>
- <p>See also the <a href="../filter.html">Filters</a>
- documentation.</p>
- <hr />
-
- <h2><a id="addtype" name="addtype">AddType</a> directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> AddType <em>MIME-type
- extension</em> [<em>extension</em>] ...<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config, virtual
- host, directory, .htaccess<br />
- <a href="directive-dict.html#Override"
- rel="Help"><strong>Override:</strong></a> FileInfo<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_mime
+</usage><p><strong>See also </strong></p><ul><li><a href="../filter.html">Filters</a> documentation</li></ul><hr/><h2><a name="AddType">AddType</a> <a name="addtype">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Maps the given filename extensions
+onto the specified content type</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>AddType <em>MIME-type
+ extension</em> [<em>extension</em>] ...</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td>FileInfo</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr></table></td></tr></table><usage>
<p>The AddType directive maps the given filename extensions
onto the specified content type. <em>MIME-type</em> is the MIME
@@ -559,44 +389,52 @@
mapping is added to any already in force, overriding any
mappings that already exist for the same <em>extension</em>.
This directive can be used to add mappings not listed in the
- MIME types file (see the <code><a
- href="#typesconfig">TypesConfig</a></code> directive).
- Example:</p>
+ MIME types file (see the <code class="directive">TypesConfig</code>
+ directive).</p>
- <blockquote>
- <code>AddType image/gif .gif</code>
- </blockquote>
- It is recommended that new MIME types be added using the
- AddType directive rather than changing the <a
- href="#typesconfig">TypesConfig</a> file.
+ <p>Example:</p>
- <p>Note that, unlike the NCSA httpd, this directive cannot be
- used to set the type of particular files.</p>
+ <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
+ AddType image/gif .gif
+ </code></td></tr></table></blockquote>
+
+ <blockquote><table><tr><td bgcolor="#e0e5f5">It is recommended that new MIME types be added using the
+ AddType directive rather than changing the
+ <code class="directive">TypesConfig</code> file. </td></tr></table></blockquote>
+
+ <blockquote><table><tr><td bgcolor="#e0e5f5">Note that, unlike the NCSA httpd, this directive cannot be
+ used to set the type of particular files.</td></tr></table></blockquote>
<p>The <em>extension</em> argument is case-insensitive, and can
be specified with or without a leading dot.</p>
- <p><strong>See also</strong>: <a href="#multipleext">Files with
- multiple extensions</a></p>
- <hr />
+</usage><p><strong>See also </strong></p><ul><li><a href="#multipleext">Files with
+ multiple extensions</a></li></ul><hr/><h2><a name="DefaultLanguage">DefaultLanguage</a> <a name="defaultlanguage">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Sets all files in the given scope to the
+specified language</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>DefaultLanguage
+ <em>MIME-lang</em></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td>FileInfo</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>DefaultLanguage
+ is only available in Apache 1.3.4 and later.</td></tr></table></td></tr></table><usage>
- <h2><a id="multiviewsmatch"
- name="multiviewsmatch">MultiviewsMatch</a> directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> MultiviewsMatch
- <em>[NegotiatedOnly] [Handlers] [Filters] [Any]</em><br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config, virtual
- host, directory, .htaccess<br />
- <a href="directive-dict.html#Override"
- rel="Help"><strong>Override:</strong></a> FileInfo<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_mime<br />
- <a href="directive-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> only available
- in Apache 2.0.26 and later.
+ <p>The DefaultLanguage directive tells Apache that all files in
+ the directive's scope (<em>e.g.</em>, all files covered by the
+ current <code><Directory></code> container) that don't
+ have an explicit language extension (such as <code>.fr</code>
+ or <code>.de</code> as configured by <code>AddLanguage</code>)
+ should be considered to be in the specified <em>MIME-lang</em>
+ language. This allows entire directories to be marked as
+ containing Dutch content, for instance, without having to
+ rename each file. Note that unlike using extensions to specify
+ languages, <code>DefaultLanguage</code> can only specify a
+ single language.</p>
+
+ <p>If no <code>DefaultLanguage</code> directive is in force,
+ and a file does not have any language extensions as configured
+ by <code>AddLanguage</code>, then that file will be considered
+ to have no language attribute.</p>
+
+</usage><p><strong>See also </strong></p><ul><li><a href="#multipleext">Files with
+ multiple extensions</a></li><li><code><a href="mod_negotiation.html">mod_negotiation</a></code></li></ul><hr/><h2><a name="MultiviewsMatch">MultiviewsMatch</a> <a name="multiviewsmatch">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>MultiviewsMatch
+ <em>[NegotiatedOnly] [Handlers] [Filters] [Any]</em></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td>FileInfo</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>only available
+ in Apache 2.0.26 and later.</td></tr></table></td></tr></table><usage>
<p>MultiviewsMatch permits three different behaviors for
<a href="mod_negotiation.html">mod_negotiation</a>'s Multiviews
@@ -622,65 +460,10 @@
doesn't recognize the extension. This was the behavior in Apache 1.3,
and can cause unpredicatable results, such as serving .old or .bak
files the webmaster never expected to be served.</p>
- <hr />
-
- <h2><a id="defaultlanguage"
- name="defaultlanguage">DefaultLanguage</a> directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> DefaultLanguage
- <em>MIME-lang</em><br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config, virtual
- host, directory, .htaccess<br />
- <a href="directive-dict.html#Override"
- rel="Help"><strong>Override:</strong></a> FileInfo<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_mime<br />
- <a href="directive-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> DefaultLanguage
- is only available in Apache 1.3.4 and later.
-
- <p>The DefaultLanguage directive tells Apache that all files in
- the directive's scope (<em>e.g.</em>, all files covered by the
- current <code><Directory></code> container) that don't
- have an explicit language extension (such as <samp>.fr</samp>
- or <samp>.de</samp> as configured by <samp>AddLanguage</samp>)
- should be considered to be in the specified <em>MIME-lang</em>
- language. This allows entire directories to be marked as
- containing Dutch content, for instance, without having to
- rename each file. Note that unlike using extensions to specify
- languages, <samp>DefaultLanguage</samp> can only specify a
- single language.</p>
-
- <p>If no <samp>DefaultLanguage</samp> directive is in force,
- and a file does not have any language extensions as configured
- by <samp>AddLanguage</samp>, then that file will be considered
- to have no language attribute.</p>
-
- <p><strong>See also</strong>: <a href="#multipleext">Files with
- multiple extensions</a>, <a
- href="./mod_negotiation.html">mod_negotiation</a></p>
- <hr />
-
- <h2><a id="removecharset"
- name="removecharset">RemoveCharset</a> directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> RemoveCharset
- <em>extension</em> [<em>extension</em>] ...<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> directory,
- .htaccess<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_mime<br />
- <a href="directive-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> RemoveCharset is
- only available in Apache 2.0.24 and later.
-
- <p>The <samp>RemoveCharset</samp> directive removes any
+</usage><hr/><h2><a name="RemoveCharset">RemoveCharset</a> <a name="removecharset">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>RemoveCharset
+ <em>extension</em> [<em>extension</em>] ...</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>RemoveCharset is
+ only available in Apache 2.0.24 and later.</td></tr></table></td></tr></table><usage>
+ <p>The <code>RemoveCharset</code> directive removes any
character set associations for files with the given extensions.
This allows <code>.htaccess</code> files in subdirectories to
undo any associations inherited from parent directories or the
@@ -688,76 +471,51 @@
<p>The <em>extension</em> argument is case-insensitive, and can
be specified with or without a leading dot.</p>
- <hr />
-
- <h2><a id="removeencoding"
- name="removeencoding">RemoveEncoding</a> directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> RemoveEncoding
- <em>extension</em> [<em>extension</em>] ...<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> directory,
- .htaccess<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_mime<br />
- <a href="directive-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> RemoveEncoding
- is only available in Apache 1.3.13 and later.
+</usage><hr/><h2><a name="RemoveEncoding">RemoveEncoding</a> <a name="removeencoding">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>RemoveEncoding
+ <em>extension</em> [<em>extension</em>] ...</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>RemoveEncoding
+ is only available in Apache 1.3.13 and later.</td></tr></table></td></tr></table><usage>
- <p>The <samp>RemoveEncoding</samp> directive removes any
+ <p>The <code>RemoveEncoding</code> directive removes any
encoding associations for files with the given extensions. This
allows <code>.htaccess</code> files in subdirectories to undo
any associations inherited from parent directories or the
server config files. An example of its use might be:</p>
+
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
<dl>
<dt><code>/foo/.htaccess:</code></dt>
-
- <dd><code>AddEncoding x-gzip .gz</code><br />
- <code>AddType text/plain .asc</code><br />
- <code><Files *.gz.asc></code><br />
+ <dd><code>AddEncoding x-gzip .gz</code><br>
+ <code>AddType text/plain .asc</code><br>
+ <code><Files *.gz.asc></code><br>
<code> RemoveEncoding
- .gz</code><br />
+ .gz</code><br>
<code></Files></code></dd>
</dl>
+</code></td></tr></table></blockquote>
<p>This will cause <code>foo.gz</code> to be marked as being
encoded with the gzip method, but <code>foo.gz.asc</code> as an
unencoded plaintext file.</p>
- <p><b>Note:</b>RemoveEncoding directives are processed
- <i>after</i> any AddEncoding directives, so it is possible they
+ <p><strong>Note:</strong>RemoveEncoding directives are processed
+ <em>after</em> any AddEncoding directives, so it is possible they
may undo the effects of the latter if both occur within the
same directory configuration.</p>
<p>The <em>extension</em> argument is case-insensitive, and can
be specified with or without a leading dot.</p>
- <hr />
-
- <h2><a id="removehandler"
- name="removehandler">RemoveHandler</a> directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> RemoveHandler
- <em>extension</em> [<em>extension</em>] ...<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> directory,
- .htaccess<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_mime<br />
- <a href="directive-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> RemoveHandler is
- only available in Apache 1.3.4 and later.
+</usage><hr/><h2><a name="RemoveHandler">RemoveHandler</a> <a name="removehandler">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>RemoveHandler
+ <em>extension</em> [<em>extension</em>] ...</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>RemoveHandler is
+ only available in Apache 1.3.4 and later.</td></tr></table></td></tr></table><usage>
- <p>The <samp>RemoveHandler</samp> directive removes any handler
+ <p>The <code>RemoveHandler</code> directive removes any handler
associations for files with the given extensions. This allows
<code>.htaccess</code> files in subdirectories to undo any
associations inherited from parent directories or the server
config files. An example of its use might be:</p>
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
<dl>
<dt><code>/foo/.htaccess:</code></dt>
@@ -767,35 +525,20 @@
<dd><code>RemoveHandler .html</code></dd>
</dl>
+</code></td></tr></table></blockquote>
- <p>This has the effect of returning <samp>.html</samp> files in
- the <samp>/foo/bar</samp> directory to being treated as normal
- files, rather than as candidates for parsing (see the <a
- href="mod_include.html"><samp>mod_include</samp></a>
+ <p>This has the effect of returning <code>.html</code> files in
+ the <code>/foo/bar</code> directory to being treated as normal
+ files, rather than as candidates for parsing (see the <a href="mod_include.html"><code>mod_include</code></a>
module).</p>
<p>The <em>extension</em> argument is case-insensitive, and can
be specified with or without a leading dot.</p>
- <hr />
-
- <h2><a id="removeinputfilter"
- name="removeinputfilter">RemoveInputFilter</a> directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> RemoveInputFilter
- <em>extension</em> [<em>extension</em>] ...<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> directory,
- .htaccess<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_mime<br />
- <a href="directive-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a>
- RemoveInputFilter is only available in Apache 2.0.26 and later.
-
+</usage><hr/><h2><a name="RemoveInputFilter">RemoveInputFilter</a> <a name="removeinputfilter">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>RemoveInputFilter
+ <em>extension</em> [<em>extension</em>] ...</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>RemoveInputFilter is only available in Apache
+2.0.26 and later.</td></tr></table></td></tr></table><usage>
- <p>The <samp>RemoveInputFilter</samp> directive removes any
+ <p>The <code>RemoveInputFilter</code> directive removes any
input filter associations for files with the given extensions.
This allows <code>.htaccess</code> files in subdirectories to
undo any associations inherited from parent directories or the
@@ -803,25 +546,11 @@
<p>The <em>extension</em> argument is case-insensitive, and can
be specified with or without a leading dot.</p>
- <hr />
-
- <h2><a id="removelanguage"
- name="removelanguage">RemoveLanguage</a> directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> RemoveLanguage
- <em>extension</em> [<em>extension</em>] ...<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> directory,
- .htaccess<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_mime<br />
- <a href="directive-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> RemoveLanguage
- is only available in Apache 2.0.24 and later.
+</usage><hr/><h2><a name="RemoveLanguage">RemoveLanguage</a> <a name="removelanguage">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>RemoveLanguage
+ <em>extension</em> [<em>extension</em>] ...</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>RemoveLanguage
+ is only available in Apache 2.0.24 and later.</td></tr></table></td></tr></table><usage>
- <p>The <samp>RemoveLanguage</samp> directive removes any
+ <p>The <code>RemoveLanguage</code> directive removes any
language associations for files with the given extensions. This
allows <code>.htaccess</code> files in subdirectories to undo
any associations inherited from parent directories or the
@@ -829,26 +558,11 @@
<p>The <em>extension</em> argument is case-insensitive, and can
be specified with or without a leading dot.</p>
- <hr />
-
- <h2><a id="removeoutputfilter"
- name="removeoutputfilter">RemoveOutputFilter</a> directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> RemoveOutputFilter
- <em>extension</em> [<em>extension</em>] ...<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> directory,
- .htaccess<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_mime<br />
- <a href="directive-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a>
- RemoveOutputFilter is only available in Apache 2.0.26 and
- later.
+</usage><hr/><h2><a name="RemoveOutputFilter">RemoveOutputFilter</a> <a name="removeoutputfilter">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>RemoveOutputFilter
+ <em>extension</em> [<em>extension</em>] ...</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code/></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td/></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>RemoveOutputFilter is only available in Apache
+2.0.26 and later.</td></tr></table></td></tr></table><usage>
- <p>The <samp>RemoveOutputFilter</samp> directive removes any
+ <p>The <code>RemoveOutputFilter</code> directive removes any
output filter associations for files with the given extensions.
This allows <code>.htaccess</code> files in subdirectories to
undo any associations inherited from parent directories or the
@@ -856,64 +570,36 @@
<p>The <em>extension</em> argument is case-insensitive, and can
be specified with or without a leading dot.</p>
- <hr />
-
- <h2><a id="removetype" name="removetype">RemoveType</a>
- directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> RemoveType
- <em>extension</em> [<em>extension</em>] ...<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> directory,
- .htaccess<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_mime<br />
- <a href="directive-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> RemoveType is
- only available in Apache 1.3.13 and later.
-
- <p>The <samp>RemoveType</samp> directive removes any MIME type
+</usage><hr/><h2><a name="RemoveType">RemoveType</a> <a name="removetype">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>RemoveType
+ <em>extension</em> [<em>extension</em>] ...</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code/></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td/></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>RemoveType is
+ only available in Apache 1.3.13 and later.</td></tr></table></td></tr></table><usage>
+ <p>The <code class="directive">RemoveType</code> directive removes any MIME type
associations for files with the given extensions. This allows
<code>.htaccess</code> files in subdirectories to undo any
associations inherited from parent directories or the server
config files. An example of its use might be:</p>
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
<dl>
<dt><code>/foo/.htaccess:</code></dt>
<dd><code>RemoveType .cgi</code></dd>
</dl>
+</code></td></tr></table></blockquote>
<p>This will remove any special handling of <code>.cgi</code>
files in the <code>/foo/</code> directory and any beneath it,
- causing the files to be treated as being of the <a
- href="core.html#defaulttype">default type</a>.</p>
+ causing the files to be treated as being of the <a href="core.html#defaulttype">default type</a>.</p>
- <p><b>Note:</b><code>RemoveType</code> directives are processed
- <i>after</i> any <code>AddType</code> directives, so it is
- possible they may undo the effects of the latter if both occur
- within the same directory configuration.</p>
+ <blockquote><table><tr><td bgcolor="#e0e5f5"><strong>Note:</strong><code><a href="RemoveType.html">RemoveType</a></code> directives
+ are processed <em>after</em> any <code><a href="AddType.html">AddType</a></code>
+ directives, so it is possible they may undo the effects of the
+ latter if both occur within the same directory
+ configuration.</td></tr></table></blockquote>
<p>The <em>extension</em> argument is case-insensitive, and can
be specified with or without a leading dot.</p>
- <hr />
-
- <h2><a id="typesconfig" name="typesconfig">TypesConfig</a>
- directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> TypesConfig
- <em>file-path</em><br />
- <a href="directive-dict.html#Default"
- rel="Help"><strong>Default:</strong></a> <code>TypesConfig
- conf/mime.types</code><br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_mime
+</usage><hr/><h2><a name="TypesConfig">TypesConfig</a> <a name="typesconfig">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>TypesConfig <em>file-path</em></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>TypesConfig conf/mime.types</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime</td></tr></table></td></tr></table><usage>
<p>The TypesConfig directive sets the location of the MIME
types configuration file. <em>Filename</em> is relative to the
@@ -924,14 +610,11 @@
contains lines in the format of the arguments to an AddType
command:</p>
- <blockquote>
- <em>MIME-type extension extension ...</em>
- </blockquote>
- The extensions are lower-cased. Blank lines, and lines
- beginning with a hash character (`#') are ignored.
-
- <p><!--#include virtual="footer.html" -->
- </p>
- </body>
-</html>
+ <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
+ MIME-type extension extension ...
+ </code></td></tr></table></blockquote>
+ <p>
+ The extensions are lower-cased. Blank lines, and lines
+ beginning with a hash character (`#') are ignored. </p>
+</usage><hr/><h3 align="center">Apache HTTP Server Version 2.0</h3><a href="./"><img alt="Index" src="../images/index.gif"/></a><a href="../"><img alt="Home" src="../images/home.gif"/></a></blockquote></body></html>
\ No newline at end of file
1.14 +31 -82 httpd-2.0/docs/manual/mod/mod_mime_magic.html
Index: mod_mime_magic.html
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_mime_magic.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -b -u -r1.13 -r1.14
--- mod_mime_magic.html 22 Sep 2001 19:36:01 -0000 1.13
+++ mod_mime_magic.html 9 Mar 2002 18:31:23 -0000 1.14
@@ -1,40 +1,13 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta name="generator" content="HTML Tidy, see www.w3.org" />
-
- <title>Apache module mod_mime_magic</title>
- </head>
- <!-- Background white, links blue (unvisited), navy (visited), red (active) -->
-
- <body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
- vlink="#000080" alink="#FF0000">
- <div align="CENTER">
- <img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]" />
- </div>
-
- <h1 align="CENTER">Module mod_mime_magic</h1>
-
- <p>This module provides for determining the MIME type of a file
- by looking at a few bytes of its contents.</p>
-
- <p><a href="module-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Extension<br />
- <a href="module-dict.html#SourceFile"
- rel="Help"><strong>Source File:</strong></a>
- mod_mime_magic.c<br />
- <a href="module-dict.html#ModuleIdentifier"
- rel="Help"><strong>Module Identifier:</strong></a>
- mime_magic_module</p>
-
- <h2>Summary</h2>
-
+<html xmlns="http://www.w3.org/TR/xhtml1/strict"><head><!--
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+--><title>mod_mime_magic - Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img alt="[APACHE DOCUMENTATION]" src="../images/sub.gif"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_mime_magic</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td><description>Determines the MIME type of a file
+ by looking at a few bytes of its contents</description></td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>mime_magic_module</td></tr></table></td></tr></table><h2>Summary</h2><summary>
<p>This module determines the MIME type of files in the same
way the Unix file(1) command works: it looks at the first few
bytes of the file. It is intended as a "second line of defense"
- for cases that <a href="mod_mime.html">mod_mime</a> can't
+ for cases that <code><a href="mod_mime.html">mod_mime</a></code> can't
resolve. To assure that mod_mime gets first try at determining
a file's MIME type, be sure to list mod_mime_magic
<strong>before</strong> mod_mime in the configuration.</p>
@@ -43,20 +16,8 @@
<code>file(1)</code> command for Unix, which uses "magic
numbers" and other hints from a file's contents to figure out
what the contents are. This module is active only if the magic
- file is specified by the <a
- href="#mimemagicfile"><code>MimeMagicFile</code></a>
- directive.</p>
-
- <h2>Directives</h2>
-
- <ul>
- <li><a href="#mimemagicfile">MimeMagicFile</a></li>
- </ul>
- <br />
- <br />
-
-
- <h2>Format of the Magic File</h2>
+ file is specified by the <a href="#mimemagicfile" class="directive"><code class="directive">MimeMagicFile</code></a> directive.</p>
+</summary><h2>Directives</h2><ul><li><a href="#mimemagicfile">MimeMagicFile</a></li></ul><h2>Format of the Magic File</h2>
<p>The contents of the file are plain ASCII text in 4-5
columns. Blank lines are allowed but ignored. Commented lines
@@ -73,7 +34,7 @@
<tr valign="top">
<td>1</td>
- <td>byte number to begin checking from<br />
+ <td>byte number to begin checking from<br>
">" indicates a dependency upon the previous non-">"
line</td>
</tr>
@@ -176,6 +137,7 @@
<p>For example, the following magic file lines would recognize
some audio formats.</p>
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
<pre>
# Sun/NeXT audio data
0 string .snd
@@ -188,9 +150,11 @@
>12 belong 7 audio/basic
>12 belong 23 audio/x-adpcm
</pre>
- Or these would recognize the difference between "*.doc" files
+</code></td></tr></table></blockquote>
+ <p>Or these would recognize the difference between "*.doc" files
containing Microsoft Word or FrameMaker documents. (These are
- incompatible file formats which use the same file suffix.)
+ incompatible file formats which use the same file suffix.)</p>
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
<pre>
# Frame
0 string \<MakerFile application/x-frame
@@ -206,19 +170,21 @@
0 string \320\317\021\340\241\261 application/msword
0 string \333\245-\0\0\0 application/msword
</pre>
- An optional MIME encoding can be included as a fifth column.
+</code></td></tr></table></blockquote>
+ <p>An optional MIME encoding can be included as a fifth column.
For example, this can recognize gzipped files and set the
- encoding for them.
+ encoding for them.</p>
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
<pre>
# gzip (GNU zip, not to be confused with [Info-ZIP/PKWARE] zip archiver)
0 string \037\213 application/octet-stream x-gzip
</pre>
-
- <h2>Performance Issues</h2>
- This module is not for every system. If your system is barely
+</code></td></tr></table></blockquote>
+<h2>Performance Issues</h2>
+ <p>This module is not for every system. If your system is barely
keeping up with its load or if you're performing a web server
benchmark, you may not want to enable this because the
- processing is not free.
+ processing is not free.</p>
<p>However, an effort was made to improve the performance of
the original file(1) code to make it fit in a busy web server.
@@ -237,10 +203,11 @@
this one is used only as a last resort, just like it was
designed to.</p>
- <h2><a id="notes" name="notes">Notes</a></h2>
- The following notes apply to the mod_mime_magic module and are
+<h2><a name="notes">Notes</a></h2>
+
+ <p>The following notes apply to the mod_mime_magic module and are
included here for compliance with contributors' copyright
- restrictions that require their acknowledgment.
+ restrictions that require their acknowledgment. </p>
<pre>
/*
* mod_mime_magic: MIME type lookup via file magic numbers
@@ -300,30 +267,12 @@
*
*/
</pre>
- <hr />
-
- <h2><a id="mimemagicfile"
- name="mimemagicfile">MimeMagicFile</a></h2>
-
- <p><a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> MimeMagicFile
- <em>file-path</em><br />
- <a href="directive-dict.html#Default"
- rel="Help"><strong>Default:</strong></a> none<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config, virtual
- host<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Extension<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_mime_magic</p>
-
- <p>The <code>MimeMagicFile</code> directive can be used to
+<hr/><h2><a name="MimeMagicFile">MimeMagicFile</a> <a name="mimemagicfile">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Enable MIME-type determination based on file contents
+using the specified magic file</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>MimeMagicFile <em>file-path</em></syntax></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_mime_magic</td></tr></table></td></tr></table><usage>
+ <p>The <code class="directive">MimeMagicFile</code> directive can be used to
enable this module, the default file is distributed at
<code>conf/magic</code>. Non-rooted paths are relative to the
ServerRoot. Virtual hosts will use the same file as the main
server unless a more specific setting is used, in which case
the more specific setting overrides the main server's file.</p>
- </body>
-</html>
-
+</usage><hr/><h3 align="center">Apache HTTP Server Version 2.0</h3><a href="./"><img alt="Index" src="../images/index.gif"/></a><a href="../"><img alt="Home" src="../images/home.gif"/></a></blockquote></body></html>
\ No newline at end of file
1.23 +41 -152 httpd-2.0/docs/manual/mod/mod_negotiation.html
Index: mod_negotiation.html
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_negotiation.html,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -d -b -u -r1.22 -r1.23
--- mod_negotiation.html 30 Dec 2001 16:07:09 -0000 1.22
+++ mod_negotiation.html 9 Mar 2002 18:31:23 -0000 1.23
@@ -1,65 +1,24 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta name="generator" content="HTML Tidy, see www.w3.org" />
-
- <title>Apache module mod_negotiation</title>
- </head>
- <!-- Background white, links blue (unvisited), navy (visited), red (active) -->
-
- <body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
- vlink="#000080" alink="#FF0000">
- <!--#include virtual="header.html" -->
-
- <h1 align="CENTER">Module mod_negotiation</h1>
-
- <p>This module provides for <a
- href="../content-negotiation.html">content negotiation</a>.</p>
-
- <p><a href="module-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="module-dict.html#SourceFile"
- rel="Help"><strong>Source File:</strong></a>
- mod_negotiation.c<br />
- <a href="module-dict.html#ModuleIdentifier"
- rel="Help"><strong>Module Identifier:</strong></a>
- negotiation_module</p>
-
- <h2>Summary</h2>
- Content negotiation, or more accurately content selection, is
+<html xmlns="http://www.w3.org/TR/xhtml1/strict"><head><!--
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+--><title>mod_negotiation - Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img alt="[APACHE DOCUMENTATION]" src="../images/sub.gif"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_negotiation</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td><description>Provides for <a href="../content-negotiation.html">content negotiation</a></description></td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>negotiation_module</td></tr></table></td></tr></table><h2>Summary</h2><summary>
+ <p>Content negotiation, or more accurately content selection, is
the selection of the document that best matches the clients
capabilities, from one of several available documents. There
- are two implementations of this.
+ are two implementations of this.</p>
<ul>
<li>A type map (a file with the handler
<code>type-map</code>) which explicitly lists the files
containing the variants.</li>
- <li>A MultiViews search (enabled by the MultiViews <a
- href="core.html#options">Option</a>, where the server does an
+ <li>A MultiViews search (enabled by the MultiViews <a href="core.html.html#options" class="directive"><code class="directive">Options</code></a>, where the server does an
implicit filename pattern match, and choose from amongst the
results.</li>
</ul>
-
- <h2>Directives</h2>
-
- <ul>
- <li><a href="#cachenegotiateddocs">CacheNegotiatedDocs</a></li>
- <li><a href="#forcelanguagepriority">ForceLanguagePriority</a></li>
- <li><a href="#languagepriority">LanguagePriority</a></li>
- </ul>
- <strong>See also</strong>: <a
- href="./mod_mime.html#defaultlanguage">DefaultLanguage</a>, <a
- href="./mod_mime.html#addencoding">AddEncoding</a>, <a
- href="./mod_mime.html#addlanguage">AddLanguage</a>, <a
- href="./mod_mime.html#addtype">AddType</a>, and <a
- href="core.html#options">Options</a>.
-
- <h2>Type maps</h2>
- A type map has the same format as RFC822 mail headers. It
+</summary><p><strong>See also </strong></p><ul><li><a href="mod_mime.html#defaultlangauge" class="directive"><code class="directive">DefaultLangauge</code></a></li><li><a href="mod_mime.html#addencoding" class="directive"><code class="directive">AddEncoding</code></a></li><li><a href="mod_mime.html#addlanguage" class="directive"><code class="directive">AddLanguage</code></a></li><li><a href="mod_mime.html#addtype" class="directive"><code class="directive">AddType</code></a></li></ul><h2>Directives</h2><ul><li><a href="#cachenegotiateddocs">CacheNegotiatedDocs</a></li><li><a href="#forcelangaugepriority">ForceLangaugePriority</a></li><li><a href="#languagepriority">LanguagePriority</a></li></ul><h2>Type maps</h2>
+ <p>A type map has the same format as RFC822 mail headers. It
contains document descriptions separated by blank lines, with
lines beginning with a hash character ('#') treated as
comments. A document description consists of several header
@@ -68,14 +27,13 @@
deleted and the lines concatenated. A header record consists of
a keyword name, which always ends in a colon, followed by a
value. Whitespace is allowed between the header name and value,
- and between the tokens of value. The headers allowed are:
+ and between the tokens of value. The headers allowed are: </p>
<dl>
<dt>Content-Encoding:</dt>
<dd>The encoding of the file. Apache only recognizes
- encodings that are defined by an <a
- href="mod_mime.html#addencoding">AddEncoding</a> directive.
+ encodings that are defined by an <a href="mod_mime.html#addencoding" class="directive"><code class="directive">AddEncoding</code></a> directive.
This normally includes the encodings <code>x-compress</code>
for compress'd files, and <code>x-gzip</code> for gzip'd
files. The <code>x-</code> prefix is ignored for encoding
@@ -132,10 +90,9 @@
<dd>The path to the file containing this variant, relative to
the map file.</dd>
</dl>
+<h2>MultiViews</h2>
- <h2>MultiViews</h2>
- A MultiViews search is enabled by the MultiViews <a
- href="core.html#options">Option</a>. If the server receives a
+ <p>A MultiViews search is enabled by the MultiViews <a href="core.html#options" class="directive"><code class="directive">Options</code></a>. If the server receives a
request for <code>/some/dir/foo</code> and
<code>/some/dir/foo</code> does <em>not</em> exist, then the
server reads the directory looking for all files named
@@ -143,29 +100,9 @@
names all those files, assigning them the same media types and
content-encodings it would have if the client had asked for one
of them by name. It then chooses the best match to the client's
- requirements, and returns that document.
- <hr />
-
- <h2><a id="cachenegotiateddocs"
- name="cachenegotiateddocs">CacheNegotiatedDocs</a>
- directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> CacheNegotiatedDocs
- on|off<br />
- <a href="directive-dict.html#Default"
- rel="Help"><strong>Default:</strong></a>
- <code>CacheNegotiatedDocs off</code><br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_negotiation<br />
- <a href="directive-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a>
- CacheNegotiatedDocs is only available in Apache 1.1 and later.
- The syntax changed in version 2.0.
-
+ requirements, and returns that document.</p>
+<hr/><h2><a name="CacheNegotiatedDocs">CacheNegotiatedDocs</a> <a name="cachenegotiateddocs">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Allows content-negotiated documents to be
+cached by proxy servers</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>CacheNegotiatedDocs on|off</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>CacheNegotiatedDocs off</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_negotiation</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>The syntax changed in version 2.0.</td></tr></table></td></tr></table><usage>
<p>If set, this directive allows content-negotiated documents
to be cached by proxy servers. This could mean that clients
behind those proxys could retrieve versions of the documents
@@ -177,34 +114,14 @@
the caching of negotiated documents, and this directive has no
effect in responses to HTTP/1.1 requests.</p>
- <p>Prior to version 2.0, CacheNegotiatedDocs did not take an
+ <p>Prior to version 2.0,
+ <code class="directive">CacheNegotiatedDocs</code> did not take an
argument; it was turned on by the presence of the directive by
itself.</p>
- <hr />
-
- <h2><a id="forcelanguagepriority"
- name="forcelanguagepriority">ForceLanguagePriority</a> directive</h2>
- <p><a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> ForceLanguagePriority
- None|Prefer|Fallback [Prefer|Fallback]<br />
- <a href="directive-dict.html#Default"
- rel="Help"><strong>Default:</strong></a>
- <code>ForceLanguagePriority None</code><br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config, virtual
- host, directory, .htaccess<br />
- <a href="directive-dict.html#Override"
- rel="Help"><strong>Override:</strong></a> FileInfo<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_negotiation<br />
- <a href="directive-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a>
- Available in version 2.0.30 and later.</p>
-
- <p>The <code>ForceLanguagePriority</code> directive uses the given
- <a href="#languagepriority">LanguagePriority</a> to satisfy
+</usage><hr/><h2><a name="ForceLangaugePriority">ForceLangaugePriority</a> <a name="forcelangaugepriority">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Action to take if a single acceptable document is not
+found</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback]</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>ForceLangaugePriority None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td>FileInfo</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_negotiation</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>Available in version 2.0.30 and later</td></tr></table></td></tr></table><usage>
+ <p>The <code class="directive">ForceLanguagePriority</code> directive uses
+ the given <a href="#languagepriority" class="directive"><code class="directive">LanguagePriority</code></a> to satisfy
negotation where the server could otherwise not return a single
matching document.</p>
@@ -216,10 +133,10 @@
each as quality .500 (equally acceptable) then then first matching
variant, en, will be served.</p>
- <blockquote><code>
- LanguagePriority en fr de<br />
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
+ LanguagePriority en fr de<br>
ForceLanguagePriority Prefer
- </code></blockquote>
+</code></td></tr></table></blockquote>
<p><code>ForceLanguagePriority Fallback</code> uses
<code>LanguagePriority</code> to serve a valid result, rather than
@@ -229,61 +146,33 @@
first variant from the LanguagePriority list below will be
served.</p>
- <blockquote><code>
- LanguagePriority en fr de<br />
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
+ LanguagePriority en fr de<br>
ForceLanguagePriority Fallback
- </code></blockquote>
+</code></td></tr></table></blockquote>
<p>Both options, Prefer and Fallback, may be specified, so either the
first matching variant from LanguagePriority will be served if more
that one variant is acceptable, or first available document will be
served if none of the variants matched the client's acceptable list of
languages.</p>
-
- <hr />
-
- <h2><a id="languagepriority"
- name="languagepriority">LanguagePriority</a> directive</h2>
- <!--%plaintext <?INDEX {\tt LanguagePriority} directive> -->
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> LanguagePriority
- <em>MIME-lang</em> [<em>MIME-lang</em>] ...<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config, virtual
- host, directory, .htaccess<br />
- <a href="directive-dict.html#Override"
- rel="Help"><strong>Override:</strong></a> FileInfo<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Base<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_negotiation
-
- <p>The LanguagePriority sets the precedence of language
- variants for the case where the client does not express a
- preference, when handling a MultiViews request. The list of
- <em>MIME-lang</em> are in order of decreasing preference.
+</usage><hr/><h2><a name="LanguagePriority">LanguagePriority</a> <a name="languagepriority">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>The precendence of language variants for cases where
+the client does not express a preference</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>LanguagePriority <em>MIME-lang</em> [<em>MIME-lang</em>] ...</syntax></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td>FileInfo</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Base</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_negotiation</td></tr></table></td></tr></table><usage>
+ <p>The <code class="directive">LanguagePriority</code> sets the precedence
+ of language variants for the case where the client does not
+ express a preference, when handling a MultiViews request. The list
+ of <em>MIME-lang</em> are in order of decreasing preference.
Example:</p>
- <blockquote>
- <code>LanguagePriority en fr de</code>
- </blockquote>
- For a request for <code>foo.html</code>, where
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>LanguagePriority en fr de</code></td></tr></table></blockquote>
+
+ <p>For a request for <code>foo.html</code>, where
<code>foo.html.fr</code> and <code>foo.html.de</code> both
existed, but the browser did not express a language preference,
- then <code>foo.html.fr</code> would be returned.
+ then <code>foo.html.fr</code> would be returned.</p>
<p>Note that this directive only has an effect if a 'best'
- language cannot be determined by any other means or the <a
- href="#forcelanguagepriority">ForceLanguagePriority</a> directive
+ language cannot be determined by any other means or the <a href="#forcelanguagepriority" class="directive"><code class="directive">ForceLanguagePriority</code></a> directive
is not <code>None</code>. Correctly implemented HTTP/1.1 requests
will mean this directive has no effect.</p>
-
- <p><strong>See also</strong>: <a
- href="./mod_mime.html#defaultlanguage">DefaultLanguage</a>,
- <a href="./mod_mime.html#addlanguage">AddLanguage</a> and
- <a href="#forcelanguagepriority">ForceLanguagePriority</a>.
- <!--#include virtual="footer.html" -->
- </p>
- </body>
-</html>
-
+</usage><hr/><h3 align="center">Apache HTTP Server Version 2.0</h3><a href="./"><img alt="Index" src="../images/index.gif"/></a><a href="../"><img alt="Home" src="../images/home.gif"/></a></blockquote></body></html>
\ No newline at end of file
1.24 +29 -138 httpd-2.0/docs/manual/mod/mod_usertrack.html
Index: mod_usertrack.html
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_usertrack.html,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -d -b -u -r1.23 -r1.24
--- mod_usertrack.html 22 Sep 2001 19:36:01 -0000 1.23
+++ mod_usertrack.html 9 Mar 2002 18:31:23 -0000 1.24
@@ -1,34 +1,11 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta name="generator" content="HTML Tidy, see www.w3.org" />
-
- <title>Apache module mod_usertrack</title>
- </head>
- <!-- Background white, links blue (unvisited), navy (visited), red (active) -->
-
- <body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
- vlink="#000080" alink="#FF0000">
- <!--#include virtual="header.html" -->
-
- <h1 align="CENTER">Module mod_usertrack</h1>
-
- <p>This module uses cookies to provide for a
- <em>clickstream</em> log of user activity on a site.</p>
-
- <p><a href="module-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> Extension<br />
- <a href="module-dict.html#SourceFile"
- rel="Help"><strong>Source File:</strong></a>
- mod_usertrack.c<br />
- <a href="module-dict.html#ModuleIdentifier"
- rel="Help"><strong>Module Identifier:</strong></a>
- usertrack_module<br />
- <a href="module-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> Known as
- mod_cookies prior to Apache 1.3.</p>
+<html xmlns="http://www.w3.org/TR/xhtml1/strict"><head><!--
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+--><title>mod_usertrack - Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img alt="[APACHE DOCUMENTATION]" src="../images/sub.gif"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_usertrack</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td><description>
+ This module uses cookies to provide for a
+ <em>clickstream</em> log of user activity on a site.
+</description></td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>usertrack_module</td></tr><tr><td align="left" valign="top"><a href="module-dict.html#Compatibility" class="help">Compatibility:</a></td><td><compatibility>Known as mod_cookies prior to Apache 1.3.</compatibility></td></tr></table></td></tr></table><h2>Summary</h2><summary>
<h2>Summary</h2>
@@ -38,22 +15,8 @@
Apache 1.2 and later this module has been renamed the "user
tracking" module, mod_usertrack. This module has been
simplified and new directives added.</p>
+</summary><h2>Directives</h2><ul><li><a href="#cookiedomain">CookieDomain</a></li><li><a href="#cookieexpires">CookieExpires</a></li><li><a href="#cookiename">CookieName</a></li><li><a href="#cookiestyle">CookieStyle</a></li><li><a href="#cookietracking">CookieTracking</a></li></ul><h2>Logging</h2>
- <h2>Directives</h2>
-
- <ul>
- <li><a href="#cookiedomain">CookieDomain</a></li>
-
- <li><a href="#cookieexpires">CookieExpires</a></li>
-
- <li><a href="#cookiename">CookieName</a></li>
-
- <li><a href="#cookiestyle">CookieStyle</a></li>
-
- <li><a href="#cookietracking">CookieTracking</a></li>
- </ul>
-
- <h2>Logging</h2>
<p>Previously, the cookies module (now the user tracking
module) did its own logging, using the <tt>CookieLog</tt>
@@ -63,15 +26,17 @@
now allows multiple log files. The cookie itself is logged by
using the text <tt>%{cookie}n</tt> in the log file format. For
example:</p>
-<pre>
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
CustomLog logs/clickstream "%{cookie}n %r %t"
-</pre>
- For backward compatibility the configurable log module
+</code></td></tr></table></blockquote>
+
+ <p>For backward compatibility the configurable log module
implements the old <tt>CookieLog</tt> directive, but this
- should be upgraded to the above <tt>CustomLog</tt> directive.
+ should be upgraded to the above <tt>CustomLog</tt> directive. </p>
+<h2>2-digit or 4-digit dates for cookies?</h2>
- <h2>2-digit or 4-digit dates for cookies?</h2>
- (the following is from message
+
+ <p>(the following is from message
<022701bda43d$9d32bbb0$1201a8c0@christian.office.sane.com>
in the new-httpd archives)
<pre>
@@ -106,19 +71,9 @@
9999. Your best bet for sending a long-life cookie is to send it for some
time late in the year "37".
</pre>
- <hr />
-
- <h2><a id="cookiedomain" name="cookiedomain">CookieDomain</a>
- directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><b>Syntax:</b></a> CookieDomain <i>domain</i><br />
- <a href="directive-dict.html#Context"
- rel="Help"><b>Context:</b></a> server config, virtual host,
- directory, .htaccess<br />
- <a href="directive-dict.html#Status"
- rel="Help"><b>Status:</b></a> optional<br />
- <a href="directive-dict.html#Module"
- rel="Help"><b>Module:</b></a> mod_usertrack
+</p>
+<hr/><h2><a name="CookieDomain">CookieDomain</a> <a name="cookiedomain">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>controls the setting of the domain to which
+ the tracking cookie applies.</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>CookieDomain <i>domain</i></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_usertrack</td></tr></table></td></tr></table><usage>
<p>This directive controls the setting of the domain to which
the tracking cookie applies. If not present, no domain is
@@ -127,23 +82,8 @@
<p>The domain string <b>must</b> begin with a dot, and
<b>must</b> include at least one embedded dot. That is,
".foo.com" is legal, but "foo.bar.com" and ".com" are not.</p>
- <hr />
-
- <h2><a id="cookieexpires"
- name="cookieexpires">CookieExpires</a> directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> CookieExpires
- <em>expiry-period</em><br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> <b>1.3.20 and
- earlier:</b> server config, virtual host; <b>1.3.21 and
- later:</b> server config, virtual host, directory,
- .htaccess<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> optional<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_usertrack
-
+</usage><hr/><h2><a name="CookieExpires">CookieExpires</a> <a name="cookieexpires">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>CookieExpires <em>expiry-period</em></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code/></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td/></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_usertrack</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>In 1.3.20 and earlier, not usable in directory and
+.htaccess</td></tr></table></td></tr></table><usage>
<p>When used, this directive sets an expiry time on the cookie
generated by the usertrack module. The <em>expiry-period</em>
can be given either as a number of seconds, or in the format
@@ -154,26 +94,7 @@
<p>If this directive is not used, cookies last only for the
current browser session.</p>
- <hr />
-
- <h2><a id="cookiename" name="cookiename">CookieName</a>
- directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> CookieName
- <em>token</em> <br />
- <a href="directive-dict.html#Default"
- rel="Help"><strong>Default:</strong></a> <em>Apache</em> <br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config, virtual
- host, directory, .htaccess<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> optional<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_usertrack <br />
- <a href="directive-dict.html#Compatibility"
- rel="Help"><strong>Compatibility:</strong></a> Apache 1.3.7 and
- later
-
+</usage><hr/><h2><a name="CookieName">CookieName</a> <a name="cookiename">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>CookieName <em>token</em></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>Apache</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_usertrack</td></tr></table></td></tr></table><usage>
<p>This directive allows you to change the name of the cookie
this module uses for its tracking purposes. By default the
cookie is named "<code>Apache</code>".</p>
@@ -181,21 +102,9 @@
<p>You must specify a valid cookie name; results are
unpredictable if you use a name containing unusual characters.
Valid characters include A-Z, a-z, 0-9, "_", and "-".</p>
- <hr />
-
- <h2><a id="cookiestyle" name="cookiestyle">CookieStyle</a>
- directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><b>Syntax:</b></a> CookieStyle
- <i>Netscape|Cookie|Cookie2|RFC2109|RFC2965</i><br />
- <a href="directive-dict.html#Context"
- rel="Help"><b>Context:</b></a> server config, virtual host,
- directory, .htaccess<br />
- <a href="directive-dict.html#Status"
- rel="Help"><b>Status:</b></a> optional<br />
- <a href="directive-dict.html#Module"
- rel="Help"><b>Module:</b></a> mod_usertrack
-
+</usage><hr/><h2><a name="CookieStyle">CookieStyle</a> <a name="cookiestyle">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Controls the format of the cookie header
+ field</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>CookieStyle
+ <i>Netscape|Cookie|Cookie2|RFC2109|RFC2965</i></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code/></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_usertrack</td></tr></table></td></tr></table><usage>
<p>This directive controls the format of the cookie header
field. The three formats allowed are:</p>
@@ -214,30 +123,12 @@
<p>Not all clients can understand all of these formats. but you
should use the newest one that is generally acceptable to your
users' browsers.</p>
- <hr />
-
- <h2><a id="cookietracking"
- name="cookietracking">CookieTracking</a> directive</h2>
- <a href="directive-dict.html#Syntax"
- rel="Help"><strong>Syntax:</strong></a> CookieTracking
- on|off<br />
- <a href="directive-dict.html#Context"
- rel="Help"><strong>Context:</strong></a> server config, virtual
- host, directory, .htaccess<br />
- <a href="directive-dict.html#Override"
- rel="Help"><strong>Override:</strong></a> FileInfo<br />
- <a href="directive-dict.html#Status"
- rel="Help"><strong>Status:</strong></a> optional<br />
- <a href="directive-dict.html#Module"
- rel="Help"><strong>Module:</strong></a> mod_usertrack
-
+</usage><hr/><h2><a name="CookieTracking">CookieTracking</a> <a name="cookietracking">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>CookieTracking on|off</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code/></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td>FileInfo</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_usertrack</td></tr></table></td></tr></table><usage>
<p>When the user track module is compiled in, and
"CookieTracking on" is set, Apache will start sending a
user-tracking cookie for all new requests. This directive can
be used to turn this behavior on or off on a per-server or
per-directory basis. By default, compiling mod_usertrack will
- not activate cookies. <!--#include virtual="footer.html" -->
- </p>
- </body>
-</html>
+ not activate cookies. </p>
+</usage><hr/><h3 align="center">Apache HTTP Server Version 2.0</h3><a href="./"><img alt="Index" src="../images/index.gif"/></a><a href="../"><img alt="Home" src="../images/home.gif"/></a></blockquote></body></html>
\ No newline at end of file