home *** CD-ROM | disk | FTP | other *** search
- <?xml version="1.0"?>
- <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
- <?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
- <!-- $Revision: 1.8.2.4 $ -->
-
- <!--
- Copyright 2002-2004 The Apache Software Foundation
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- -->
-
- <modulesynopsis metafile="mod_cern_meta.xml.meta">
-
- <name>mod_cern_meta</name>
- <description>CERN httpd metafile semantics</description>
- <status>Extension</status>
- <sourcefile>mod_cern_meta.c</sourcefile>
- <identifier>cern_meta_module</identifier>
-
- <summary>
- <p>Emulate the CERN HTTPD Meta file semantics. Meta files are HTTP
- headers that can be output in addition to the normal range of
- headers for each file accessed. They appear rather like the
- Apache .asis files, and are able to provide a crude way of
- influencing the Expires: header, as well as providing other
- curiosities. There are many ways to manage meta information,
- this one was chosen because there is already a large number of
- CERN users who can exploit this module.</p>
-
- <p>More information on the <a
- href="http://www.w3.org/pub/WWW/Daemon/User/Config/General.html#MetaDir"
- >CERN metafile semantics</a> is available.</p>
- </summary>
-
- <seealso><module>mod_headers</module></seealso>
- <seealso><module>mod_asis</module></seealso>
-
- <directivesynopsis>
- <name>MetaFiles</name>
- <description>Activates CERN meta-file processing</description>
- <syntax>MetaFiles on|off</syntax>
- <default>MetaFiles off</default>
- <contextlist><context>server config</context>
- <context>virtual host</context>
- <context>directory</context>
- <context>.htaccess</context></contextlist>
- <override>Indexes</override>
-
- <usage>
- <p>Turns on/off Meta file processing on a per-directory basis.</p>
- </usage>
- </directivesynopsis>
-
- <directivesynopsis>
- <name>MetaDir</name>
- <description>Name of the directory to find CERN-style meta information
- files</description>
- <syntax>MetaDir <var>directory</var></syntax>
- <default>MetaDir .web</default>
- <contextlist><context>server config</context>
- <context>virtual host</context>
- <context>directory</context>
- <context>.htaccess</context></contextlist>
- <override>Indexes</override>
-
- <usage>
- <p>Specifies the name of the directory in which Apache can find
- meta information files. The directory is usually a 'hidden'
- subdirectory of the directory that contains the file being
- accessed. Set to "<code>.</code>" to look in the same directory
- as the file:</p>
-
- <example>MetaDir .</example>
-
- <p>Or, to set it to a subdirectory of the directory containing the
- files:</p>
-
- <example>MetaDir .meta</example>
- </usage>
- </directivesynopsis>
-
- <directivesynopsis>
- <name>MetaSuffix</name>
- <description>File name suffix for the file containg CERN-style
- meta information</description>
- <syntax>MetaSuffix <var>suffix</var></syntax>
- <default>MetaSuffix .meta</default>
- <contextlist><context>server config</context>
- <context>virtual host</context>
- <context>directory</context>
- <context>.htaccess</context></contextlist>
- <override>Indexes</override>
-
- <usage>
- <p>Specifies the file name suffix for the file containing the
- meta information. For example, the default values for the two
- directives will cause a request to
- <code>DOCUMENT_ROOT/somedir/index.html</code> to look in
- <code>DOCUMENT_ROOT/somedir/.web/index.html.meta</code> and
- will use its contents to generate additional MIME header
- information.</p>
-
- <example><title>Example:</title>
- MetaSuffix .meta
- </example>
- </usage>
- </directivesynopsis>
-
- </modulesynopsis>
-