Automatic indexes moved from mod_dir into mod_autoindex. The mod_autoindex

CVS files are copies of the mod_dir files so that we retain history in
both places.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@78566 13f79535-47bb-0310-9956-ffa450edef68

4 files changed, 43 insertions, 376 deletions

diff --git a/docs/manual/mod/directives.html b/docs/manual/mod/directives.html
index 3667159927..32e7642d61 100644
--- a/docs/manual/mod/directives.html
+++ b/docs/manual/mod/directives.html
@@ -19,15 +19,15 @@
 <li><A HREF="core.html#accessconfig">AccessConfig</A>
 <li><A HREF="core.html#accessfilename">AccessFileName</A>
 <li><A HREF="mod_actions.html#action">Action</A>
-<li><A HREF="mod_dir.html#addalt">AddAlt</A>
-<li><A HREF="mod_dir.html#addaltbyencoding">AddAltByEncoding</A>
-<li><A HREF="mod_dir.html#addaltbytype">AddAltByType</A>
-<li><A HREF="mod_dir.html#adddescription">AddDescription</A>
+<li><A HREF="mod_autoindex.html#addalt">AddAlt</A>
+<li><A HREF="mod_autoindex.html#addaltbyencoding">AddAltByEncoding</A>
+<li><A HREF="mod_autoindex.html#addaltbytype">AddAltByType</A>
+<li><A HREF="mod_autoindex.html#adddescription">AddDescription</A>
 <li><A HREF="mod_mime.html#addencoding">AddEncoding</A>
 <li><A HREF="mod_mime.html#addhandler">AddHandler</A>
-<li><A HREF="mod_dir.html#addicon">AddIcon</A>
-<li><A HREF="mod_dir.html#addiconbyencoding">AddIconByEncoding</A>
-<li><A HREF="mod_dir.html#addiconbytype">AddIconByType</A>
+<li><A HREF="mod_autoindex.html#addicon">AddIcon</A>
+<li><A HREF="mod_autoindex.html#addiconbyencoding">AddIconByEncoding</A>
+<li><A HREF="mod_autoindex.html#addiconbytype">AddIconByType</A>
 <li><A HREF="mod_mime.html#addlanguage">AddLanguage</A>
 <li><A HREF="core.html#addmodule">AddModule</A>
 <li><A HREF="mod_mime.html#addtype">AddType</A>
@@ -73,7 +73,7 @@
 <li><A HREF="mod_log_config.html#cookielog">CookieLog</A> (mod_log_config)
 <li><A HREF="mod_usertrack.html#cookietracking">CookieTracking</A>
 <li><A HREF="mod_log_config.html#customlog">CustomLog</A>
-<li><A HREF="mod_dir.html#defaulticon">DefaultIcon</A>
+<li><A HREF="mod_autoindex.html#defaulticon">DefaultIcon</A>
 <li><A HREF="core.html#defaulttype">DefaultType</A>
 <li><A HREF="mod_access.html#deny">deny</A>
 <li><A HREF="core.html#directory">&lt;Directory&gt;</A>
@@ -86,21 +86,21 @@
 <li><A HREF="mod_expires.html#expiresactive">ExpiresActive</A>
 <li><A HREF="mod_expires.html#expiresbytype">ExpiresByType</A>
 <li><A HREF="mod_expires.html#expiresdefault">ExpiresDefault</A>
-<li><A HREF="mod_dir.html#fancyindexing">FancyIndexing</A>
+<li><A HREF="mod_autoindex.html#fancyindexing">FancyIndexing</A>
 <li><A HREF="core.html#files">&lt;Files&gt;</A>
 <li><A HREF="core.html#filesmatch">&lt;FilesMatch&gt;</A>
 <li><A HREF="mod_mime.html#forcetype">ForceType</A>
 <li><A HREF="core.html#group">Group</A>
 <li><A HREF="mod_headers.html#header">Header</A>
-<li><A HREF="mod_dir.html#headername">HeaderName</A>
+<li><A HREF="mod_autoindex.html#headername">HeaderName</A>
 <li><A HREF="core.html#hostnamelookups">HostNameLookups</A>
 <li><A HREF="core.html#identitycheck">IdentityCheck</A>
 <li><A HREF="core.html#ifmodule">&lt;IfModule&gt;</A>
 <li><A HREF="mod_imap.html#imapbase">ImapBase</A>
 <li><A HREF="mod_imap.html#imapdefault">ImapDefault</A>
 <li><A HREF="mod_imap.html#imapmenu">ImapMenu</A>
-<li><A HREF="mod_dir.html#indexignore">IndexIgnore</A>
-<li><A HREF="mod_dir.html#indexoptions">IndexOptions</A>
+<li><A HREF="mod_autoindex.html#indexignore">IndexIgnore</A>
+<li><A HREF="mod_autoindex.html#indexoptions">IndexOptions</A>
 <li><A HREF="core.html#keepalive">KeepAlive</A>
 <li><A HREF="core.html#keepalivetimeout">KeepAliveTimeout</A>
 <li><A HREF="mod_negotiation.html#languagepriority">LanguagePriority</A>
@@ -131,7 +131,7 @@
 <li><A HREF="mod_proxy.html#proxypass">ProxyPass</A>
 <li><A HREF="mod_proxy.html#proxyremote">ProxyRemote</A>
 <li><A HREF="mod_proxy.html#proxyrequests">ProxyRequests</A>
-<li><A HREF="mod_dir.html#readmename">ReadmeName</A>
+<li><A HREF="mod_autoindex.html#readmename">ReadmeName</A>
 <li><A HREF="mod_alias.html#redirect">Redirect</A>
 <li><A HREF="mod_alias.html#redirectmatch">RedirectMatch</A>
 <li><A HREF="mod_alias.html#redirectperm">RedirectPermanent</A>
diff --git a/docs/manual/mod/index.html b/docs/manual/mod/index.html
index 98c48cb03f..a2ee08f3db 100644
--- a/docs/manual/mod/index.html
+++ b/docs/manual/mod/index.html
@@ -44,6 +44,8 @@ Apache distribution.  See also the complete alphabetical list of
 <dd>User authentication using DBM files.
 <dt><A HREF="mod_auth_msql.html">mod_auth_msql</A>
 <dd>User authentication using mSQL files.
+<dt><A HREF="mod_autoindex.html">mod_autoindex</A>
+<dd>Automatic directory listings.
 <dt><A HREF="mod_browser.html">mod_browser</A> Apache 1.2 and up
 <dd>Set environment variables based on User-Agent strings
 <dt><A HREF="mod_cern_meta.html">mod_cern_meta</a>
@@ -56,7 +58,7 @@ mod_usertrack
 <dt><A HREF="mod_digest.html">mod_digest</A>
 <dd>MD5 authentication
 <dt><A HREF="mod_dir.html">mod_dir</A>
-<dd>Automatic directory listings.
+<dd>Basic directory handling.
 <dt><A HREF="mod_dld.html">mod_dld</A>
 <dd>Start-time linking with the GNU libdld.
 <dt><A HREF="mod_env.html">mod_env</A>
diff --git a/docs/manual/mod/mod_autoindex.html b/docs/manual/mod/mod_autoindex.html
index bd255fb6c5..82ebd0db09 100644
--- a/docs/manual/mod/mod_autoindex.html
+++ b/docs/manual/mod/mod_autoindex.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
 <HTML>
 <HEAD>
-<TITLE>Apache module mod_dir</TITLE>
+<TITLE>Apache module mod_autoindex</TITLE>
 </HEAD>
 
 <!-- Background white, links blue (unvisited), navy (visited), red (active) -->
@@ -13,25 +13,28 @@
  ALINK="#FF0000"
 >
 <!--#include virtual="header.html" -->
-<H1 ALIGN="CENTER">Module mod_dir</H1>
+<H1 ALIGN="CENTER">Module mod_autoindex</H1>
 
-This module is contained in the <code>mod_dir.c</code> file, and
-is compiled in by default. It provides for directory indexing.
+This module is contained in the <code>mod_autoindex.c</code> file, and
+is compiled in by default. It provides for automatic directory indexing.
 
 <h2>Summary</h2>
-This module controls the directory indexing. The index of a directory
-can come from one of two sources:
+The index of a directory can come from one of two sources:
 <ul>
 <li>A file written by the user, typically called <code>index.html</code>.
-The <A HREF="#directoryindex">DirectoryIndex</A> directive sets the name
-of this file.
+The <A HREF="mod_dir.html#directoryindex">DirectoryIndex</A> directive sets
+the name of this file.
+This is controlled by <a href="mod_dir.html"><code>mod_dir</code></a>.
 <li>Otherwise, a listing generated by the server. The other directives
 control the format of this listing. The <A HREF="#addicon">AddIcon</A>,
 <A HREF="#addiconbyencoding">AddIconByEncoding</A> and
 <A HREF="#addiconbytype">AddIconByType</A> are used to set a list of
 icons to display for various file types; for each file listed, the
-first icon listed that matches the file is displayed.
+first icon listed that matches the file is displayed.  These
+are controlled by <code>mod_autoindex</code>.
 </ul>
+The two functions are separated so that you can completely remove
+(or replace) automatic index generation should you want to.
 
 
 <h2>Directives</h2>
@@ -45,7 +48,6 @@ first icon listed that matches the file is displayed.
 <li><A HREF="#addiconbyencoding">AddIconByEncoding</A>
 <li><A HREF="#addiconbytype">AddIconByType</A>
 <li><A HREF="#defaulticon">DefaultIcon</A>
-<li><A HREF="#directoryindex">DirectoryIndex</A>
 <li><A HREF="#fancyindexing">FancyIndexing</A>
 <li><A HREF="#headername">HeaderName</A>
 <li><A HREF="#indexignore">IndexIgnore</A>
@@ -200,41 +202,6 @@ specific icon is known, for <A HREF="#fancyindexing">FancyIndexing</A>.
 DefaultIcon /icon/unknown.xbm
 </code></blockquote><p><hr>
 
-<A name="directoryindex"><h2>DirectoryIndex</h2></A>
-<!--%plaintext &lt;?INDEX {\tt DirectoryIndex} directive&gt; -->
-<strong>Syntax:</strong> DirectoryIndex <em>local-url local-url ...</em><br>
-<strong>Default:</strong> <code>DirectoryIndex index.html</code><br>
-<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
-<Strong>Override:</strong> Indexes<br>
-<strong>Status:</strong> Base<br>
-<strong>Module:</strong> mod_dir<p>
-
-The DirectoryIndex directive sets the list of resources to look for,
-when the client requests an index of the directory by specifying a /
-at the end of the a directory name. <em>Local-url</em> is the
-(%-encoded) URL of a document on the server relative to the requested
-directory; it is usually the name of a file in the directory. Several
-URLs may be given, in which case the server will return the first one
-that it finds. If none of the resources exist and the
-<CODE>Indexes</CODE> option is set, the server will generate its own
-listing of the directory.
-<P>
-
-Example:
-<blockquote><code>
-DirectoryIndex index.html
-</code></blockquote>
-then a request for <code>http://myserver/docs/</code> would return
-<code>http://myserver/docs/index.html</code> if it exists, or would list
-the directory if it did not. <p>
-
-Note that the documents do not need to be relative to the directory;
-<blockquote><code>
-DirectoryIndex index.html index.txt /cgi-bin/index.pl</code></blockquote>
-would cause the CGI script <code>/cgi-bin/index.pl</code> to be executed
-if neither <code>index.html</code> or <code>index.txt</code> existed in
-a directory.<p><hr>
-
 <A name="fancyindexing"><h2>FancyIndexing</h2></A>
 <!--%plaintext &lt;?INDEX {\tt FancyIndexing} directive&gt; -->
 <strong>Syntax:</strong> FancyIndexing <em>boolean</em><br>
diff --git a/docs/manual/mod/mod_dir.html b/docs/manual/mod/mod_dir.html
index bd255fb6c5..4d1c461d80 100644
--- a/docs/manual/mod/mod_dir.html
+++ b/docs/manual/mod/mod_dir.html
@@ -16,190 +16,34 @@
 <H1 ALIGN="CENTER">Module mod_dir</H1>
 
 This module is contained in the <code>mod_dir.c</code> file, and
-is compiled in by default. It provides for directory indexing.
+is compiled in by default.  It provides for "trailing slash" redirects and
+serving directory index files.
 
 <h2>Summary</h2>
-This module controls the directory indexing. The index of a directory
-can come from one of two sources:
+The index of a directory can come from one of two sources:
 <ul>
 <li>A file written by the user, typically called <code>index.html</code>.
-The <A HREF="#directoryindex">DirectoryIndex</A> directive sets the name
-of this file.
-<li>Otherwise, a listing generated by the server. The other directives
-control the format of this listing. The <A HREF="#addicon">AddIcon</A>,
-<A HREF="#addiconbyencoding">AddIconByEncoding</A> and
-<A HREF="#addiconbytype">AddIconByType</A> are used to set a list of
-icons to display for various file types; for each file listed, the
-first icon listed that matches the file is displayed.
+The <A HREF="#directoryindex">DirectoryIndex</A> directive sets
+the name of this file.
+This is controlled by <code>mod_dir</code>.
+<li>Otherwise, a listing generated by the server.  This is provided by
+<a href="mod_autoindex.html"><code>mod_autoindex</code></a>.
 </ul>
-
+The two functions are separated so that you can completely remove
+(or replace) automatic index generation should you want to.
+<p>A "trailing slash" redirect is issued when the server receives a
+request for a URL <SAMP>http://servername/foo/dirname</SAMP> where
+<SAMP>dirname</SAMP> is a directory.  Directories require a trailing
+slash, so <code>mod_dir</code> issues a redirect to
+<SAMP>http://servername/foo/dirname/</SAMP>.
 
 <h2>Directives</h2>
 
 <menu>
-<li><A HREF="#addalt">AddAlt</A>
-<li><A HREF="#addaltbyencoding">AddAltByEncoding</A>
-<li><A HREF="#addaltbytype">AddAltByType</A>
-<li><A HREF="#adddescription">AddDescription</A>
-<li><A HREF="#addicon">AddIcon</A>
-<li><A HREF="#addiconbyencoding">AddIconByEncoding</A>
-<li><A HREF="#addiconbytype">AddIconByType</A>
-<li><A HREF="#defaulticon">DefaultIcon</A>
 <li><A HREF="#directoryindex">DirectoryIndex</A>
-<li><A HREF="#fancyindexing">FancyIndexing</A>
-<li><A HREF="#headername">HeaderName</A>
-<li><A HREF="#indexignore">IndexIgnore</A>
-<li><A HREF="#indexoptions">IndexOptions</A>
-<li><A HREF="#readmename">ReadmeName</A>
 </menu>
 <hr>
 
-<A name="addalt"><h2>AddAlt</h2></A>
-<!--%plaintext &lt;?INDEX {\tt AddAlt} directive&gt; -->
-<strong>Syntax:</strong> AddAlt <em>string file file...</em><br>
-<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
-<Strong>Override:</strong> Indexes<br>
-<strong>Status:</strong> Base<br>
-<strong>Module:</strong> mod_dir<p>
-
-This sets the alternate text to display for a file, instead of an icon, for
-<A HREF="#fancyindexing">FancyIndexing</A>. <em>File</em> is a file
-extension, partial filename, wild-card expression or full filename for files
-to describe. <em>String</em> is enclosed in double quotes
-(<code>&quot;</code>).  This alternate text is displayed if the client is
-image-incapable or has image loading disabled.
-
-<HR>
-<A name="addaltbyencoding"><h2>AddAltByEncoding</h2></A>
-<!--%plaintext &lt;?INDEX {\tt AddAltByEncoding} directive&gt; -->
-<strong>Syntax:</strong> AddAltByEncoding <em>string MIME-encoding
-    MIME-encoding...</em><br>
-<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
-<Strong>Override:</strong> Indexes<br>
-<strong>Status:</strong> Base<br>
-<strong>Module:</strong> mod_dir<p>
-
-This sets the alternate text to display for a file, instead of an icon, for
-<A HREF="#fancyindexing">FancyIndexing</A>. <em>MIME-encoding</em> is a
-valid content-encoding, such as <SAMP>x-compress</SAMP>.
-<em>String</em> is enclosed in double quotes
-(<code>&quot;</code>).  This alternate text is displayed if the client is
-image-incapable or has image loading disabled.
-
-<HR>
-<A name="addaltbytype"><h2>AddAltByType</h2></A>
-<!--%plaintext &lt;?INDEX {\tt AddAltByType} directive&gt; -->
-<strong>Syntax:</strong> AddAltByType <em>string MIME-type MIME-type...</em><br>
-<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
-<Strong>Override:</strong> Indexes<br>
-<strong>Status:</strong> Base<br>
-<strong>Module:</strong> mod_dir<p>
-
-This sets the alternate text to display for a file, instead of an icon, for
-<A HREF="#fancyindexing">FancyIndexing</A>. <em>MIME-type</em> is a
-valid content-type, such as <SAMP>text/html</SAMP>.
-<em>String</em> is enclosed in double quotes
-(<code>&quot;</code>).  This alternate text is displayed if the client is
-image-incapable or has image loading disabled.
-
-<HR>
-
-<A name="adddescription"><h2>AddDescription</h2></A>
-<!--%plaintext &lt;?INDEX {\tt AddDescription} directive&gt; -->
-<strong>Syntax:</strong> AddDescription <em>string file file...</em><br>
-<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
-<Strong>Override:</strong> Indexes<br>
-<strong>Status:</strong> Base<br>
-<strong>Module:</strong> mod_dir<p>
-
-This sets the description to display for a file, for
-<A HREF="#fancyindexing">FancyIndexing</A>. <em>File</em> is a file
-extension, partial filename, wild-card expression or full filename for files
-to describe. <em>String</em> is enclosed in double quotes
-(<code>&quot;</code>). Example:
-<blockquote><code>AddDescription "The planet Mars" /web/pics/mars.gif
-</code></blockquote><p><hr>
-
-<A name="addicon"><h2>AddIcon</h2></A>
-<!--%plaintext &lt;?INDEX {\tt AddIcon} directive&gt; -->
-<strong>Syntax:</strong> AddIcon <em>icon name name ...</em><br>
-<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
-<Strong>Override:</strong> Indexes<br>
-<strong>Status:</strong> Base<br>
-<strong>Module:</strong> mod_dir<p>
-
-This sets the icon to display next to a file ending in <em>name</em> for
-<A HREF="#fancyindexing">FancyIndexing</A>. <em>Icon</em> is either a
-(%-escaped) relative URL to the icon, or of the format
-(<em>alttext</em>,<em>url</em>) where <em>alttext</em> is the text tag given
-for an icon for non-graphical browsers.<p>
-
-<em>Name</em> is either ^^DIRECTORY^^ for directories, ^^BLANKICON^^ for
-blank lines (to format the list correctly), a file extension, a wildcard
-expression, a partial filename or a complete filename. Examples:
-<blockquote><code>
-AddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm <br>
-AddIcon /icons/dir.xbm ^^DIRECTORY^^ <br>
-AddIcon /icons/backup.xbm *~
-</code></blockquote>
-<A HREF="#addiconbytype">AddIconByType</A> should be used in preference to
-AddIcon, when possible.<p><hr>
-
-<A name="addiconbyencoding"><h2>AddIconByEncoding</h2></A>
-<!--%plaintext &lt;?INDEX {\tt AddIconByEncoding} directive&gt; -->
-<strong>Syntax:</strong> AddIconByEncoding <em>icon mime-encoding mime-encoding
-...</em><br>
-<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
-<Strong>Override:</strong> Indexes<br>
-<strong>Status:</strong> Base<br>
-<strong>Module:</strong> mod_dir<p>
-
-This sets the icon to display next to files with
-<em>mime-encoding</em> for <A HREF="#fancyindexing">FancyIndexing</A>.
-<em>Icon</em> is either a (%-escaped) relative URL to the icon, or of the
-format (<em>alttext</em>,<em>url</em>) where <em>alttext</em> is the text tag
-given for an icon for non-graphical browsers.<p>
-
-<em>Mime-encoding</em> is a wildcard expression matching required the
-content-encoding. Examples:
-<blockquote><code>
-AddIconByEncoding /icons/compress.xbm x-compress
-</code></blockquote><p><hr>
-
-<A name="addiconbytype"><h2>AddIconByType</h2></A>
-<!--%plaintext &lt;?INDEX {\tt AddIconByType} directive&gt; -->
-<strong>Syntax:</strong> AddIconByType <em>icon mime-type mime-type ...</em><br>
-<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
-<Strong>Override:</strong> Indexes<br>
-<strong>Status:</strong> Base<br>
-<strong>Module:</strong> mod_dir<p>
-
-This sets the icon to display next to files of type <em>mime-type</em> for
-<A HREF="#fancyindexing">FancyIndexing</A>. <em>Icon</em> is either a
-(%-escaped) relative URL to the icon, or of the format
-(<em>alttext</em>,<em>url</em>) where <em>alttext</em> is the text tag given
-for an icon for non-graphical browsers.<p>
-<em>Mime-type</em> is a wildcard expression matching required the mime types.
-Examples:
-<blockquote><code>
-AddIconByType (IMG,/icons/image.xbm) image/*
-</code></blockquote><p><hr>
-
-<A name="defaulticon"><h2>DefaultIcon</h2></A>
-<!--%plaintext &lt;?INDEX {\tt DefaultIcon} directive&gt; -->
-<strong>Syntax:</strong> DefaultIcon <em>url</em><br>
-<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
-<Strong>Override:</strong> Indexes<br>
-<strong>Status:</strong> Base<br>
-<strong>Module:</strong> mod_dir<p>
-
-The DefaultIcon directive sets the icon to display for files when no
-specific icon is known, for <A HREF="#fancyindexing">FancyIndexing</A>.
-<em>Url</em> is a (%-escaped) relative URL to the icon. Examples:
-<blockquote><code>
-DefaultIcon /icon/unknown.xbm
-</code></blockquote><p><hr>
-
 <A name="directoryindex"><h2>DirectoryIndex</h2></A>
 <!--%plaintext &lt;?INDEX {\tt DirectoryIndex} directive&gt; -->
 <strong>Syntax:</strong> DirectoryIndex <em>local-url local-url ...</em><br>
@@ -235,152 +79,6 @@ would cause the CGI script <code>/cgi-bin/index.pl</code> to be executed
 if neither <code>index.html</code> or <code>index.txt</code> existed in
 a directory.<p><hr>
 
-<A name="fancyindexing"><h2>FancyIndexing</h2></A>
-<!--%plaintext &lt;?INDEX {\tt FancyIndexing} directive&gt; -->
-<strong>Syntax:</strong> FancyIndexing <em>boolean</em><br>
-<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
-<Strong>Override:</strong> Indexes<br>
-<strong>Status:</strong> Base<br>
-<strong>Module:</strong> mod_dir<p>
-
-The FancyIndexing directive sets the FancyIndexing option for a directory.
-<em>Boolean</em> can be <code>on</code> or <code>off</code>. The
-<A HREF="#indexoptions">IndexOptions</A> directive should be used in
-preference.<p><hr>
-
-<A name="headername"><h2>HeaderName</h2></A>
-<!--%plaintext &lt;?INDEX {\tt HeaderName} directive&gt; -->
-<strong>Syntax:</strong> HeaderName <em>filename</em><br>
-<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
-<Strong>Override:</strong> Indexes<br>
-<strong>Status:</strong> Base<br>
-<strong>Module:</strong> mod_dir<p>
-
-The HeaderName directive sets the name of the file that will be inserted
-at the top of the index listing. <em>Filename</em> is the name of the file
-to include, and is taken to be relative to the directory being indexed.
-The server first attempts to include <em>filename</em><code>.html</code>
-as an HTML document, otherwise it will include <em>filename</em> as plain
-text. Example:
-<blockquote><code>HeaderName HEADER</code></blockquote>
-when indexing the directory <code>/web</code>, the server will first look for
-the HTML file <code>/web/HEADER.html</code> and include it if found, otherwise
-it will include the plain text file <code>/web/HEADER</code>, if it exists.
-
-<p>See also <A HREF="#readmename">ReadmeName</A>.<p><hr>
-
-<A name="indexignore"><h2>IndexIgnore</h2></A>
-<!--%plaintext &lt;?INDEX {\tt IndexIgnore} directive&gt; -->
-<strong>Syntax:</strong> IndexIgnore <em>file file ...</em><br>
-<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
-<Strong>Override:</strong> Indexes<br>
-<strong>Status:</strong> Base<br>
-<strong>Module:</strong> mod_dir<p>
-
-The IndexIgnore directive adds to the list of files to hide when listing
-a directory. <em>File</em> is a file extension, partial filename,
-wildcard expression or full filename for files to ignore. Multiple
-IndexIgnore directives add to the list, rather than the replacing the list
-of ignored files. By default, the list contains `<code>.</code>'. Example:
-<blockquote><code>
-IndexIgnore README .htaccess *~
-</code></blockquote><p><hr>
-
-<A name="indexoptions"><h2>IndexOptions</h2></A>
-<!--%plaintext &lt;?INDEX {\tt IndexOptions} directive&gt; -->
-<strong>Syntax:</strong> IndexOptions <em>option option ...</em><br>
-<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
-<Strong>Override:</strong> Indexes<br>
-<strong>Status:</strong> Base<br>
-<strong>Module:</strong> mod_dir<p>
-
-The IndexOptions directive specifies the behavior of the directory indexing.
-<em>Option</em> can be one of
-<dl>
-<dt>FancyIndexing
-<dd><!--%plaintext &lt;?INDEX {\tt FancyIndexing} index option&gt; -->
-This turns on fancy indexing of directories.
-<dt>IconsAreLinks
-<dd>
-<!--%plaintext &lt;?INDEX {\tt IconsAreLinks} index option&gt; -->
-This makes the icons part of the anchor for the filename, for
-fancy indexing.
-<dt>ScanHTMLTitles
-<dd><!--%plaintext &lt;?INDEX {\tt ScanHTMLTitles} index option&gt; -->
-This enables the extraction of the title from HTML documents for fancy
-indexing. If the file does not have a description given by
-<A HREF="#adddescription">AddDescription</A> then httpd will read the
-document for the value of the TITLE tag.  This is CPU and disk intensive.
-<dt>SuppressLastModified
-<dd>
-<!--%plaintext &lt;?INDEX {\tt SuppressLastModified} index option&gt; -->
-This will suppress the display of the last modification date, in fancy
-indexing listings.
-<dt>SuppressSize
-<dd>
-<!--%plaintext &lt;?INDEX {\tt SuppressSize} index option&gt; -->
-This will suppress the file size in fancy indexing listings.
-<dt>SuppressDescription
-<dd>
-<!--%plaintext &lt;?INDEX {\tt SuppressDescription} index option&gt; -->
-This will suppress the file description in fancy indexing listings.
-<dt>IconHeight[=pixels] (<EM>Apache 1.3 and later</EM>)
-<dd>
-<!--%plaintext &lt;?INDEX {\tt IconHeight} index option&gt; -->
-Presence of this option, when used with IconWidth, will cause the server
-to include <SAMP>HEIGHT</SAMP> and <SAMP>WIDTH</SAMP> attributes in the
-<SAMP>IMG</SAMP> tag for the file icon.  This allows browser to
-precalculate the page layout without having to wait until all the
-images have been loaded.  If no value is given for the option, it
-defaults to the standard height of the icons supplied with the Apache
-software.
-<dt>IconWidth[=pixels] (<EM>Apache 1.3 and later</EM>)
-<dd>
-<!--%plaintext &lt;?INDEX {\tt IconWidth} index option&gt; -->
-Presence of this option, when used with IconHeight, will cause the server
-to include <SAMP>HEIGHT</SAMP> and <SAMP>WIDTH</SAMP> attributes in the
-<SAMP>IMG</SAMP> tag for the file icon.  This allows browser to
-precalculate the page layout without having to wait until all the
-images have been loaded.  If no value is given for the option, it
-defaults to the standard width of the icons supplied with the Apache
-software.
-</dl>
-This default is that no options are enabled. If multiple IndexOptions
-could apply to a directory, then the most specific one is taken complete;
-the options are not merged. For example:
-<blockquote><code>
-&lt;Directory /web/docs&gt; <br>
-IndexOptions FancyIndexing <br>
-&lt;/Directory&gt;<br>
-&lt;Directory /web/docs/spec&gt; <br>
-IndexOptions ScanHTMLTitles <br>
-&lt;/Directory&gt;
-</code></blockquote>
-then only <code>ScanHTMLTitles</code> will be set for the /web/docs/spec
-directory.<p><hr>
-
-<A name="readmename"><h2>ReadmeName</h2></A>
-<!--%plaintext &lt;?INDEX {\tt ReadmeName} directive&gt; -->
-<strong>Syntax:</strong> ReadmeName <em>filename</em><br>
-<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
-<Strong>Override:</strong> Indexes<br>
-<strong>Status:</strong> Base<br>
-<strong>Module:</strong> mod_dir<p>
-
-The ReadmeName directive sets the name of the file that will be appended
-to the end of the index listing. <em>Filename</em> is the name of the file
-to include, and is taken to be relative to the directory being indexed.
-The server first attempts to include <em>filename</em><code>.html</code>
-as an HTML document, otherwise it will include <em>filename</em> as plain
-text. Example:
-<blockquote><code>ReadmeName README</code></blockquote>
-when indexing the directory <code>/web</code>, the server will first look for
-the HTML file <code>/web/README.html</code> and include it if found, otherwise
-it will include the plain text file <code>/web/README</code>, if it exists.
-
-<p>See also <A HREF="#headername">HeaderName</A>.<p>
-
-
 <!--#include virtual="footer.html" -->
 </BODY>
 </HTML>