httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sl...@locus.apache.org
Subject cvs commit: httpd-docs-2.0/htdocs/manual/mod mod_autoindex.html mod_cern_meta.html mod_cgi.html mod_expires.html
Date Tue, 26 Sep 2000 19:21:17 GMT
slive       00/09/26 12:21:12

  Modified:    htdocs/manual/mod mod_autoindex.html mod_cern_meta.html
                        mod_cgi.html mod_expires.html
  Log:
  Style fixes.  I've stopped removing 1.3 references.
  This will need to be done later.
  
  Revision  Changes    Path
  1.35      +41 -18    httpd-docs-2.0/htdocs/manual/mod/mod_autoindex.html
  
  Index: mod_autoindex.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-2.0/htdocs/manual/mod/mod_autoindex.html,v
  retrieving revision 1.34
  retrieving revision 1.35
  diff -u -r1.34 -r1.35
  --- mod_autoindex.html	2000/04/24 04:03:38	1.34
  +++ mod_autoindex.html	2000/09/26 19:21:07	1.35
  @@ -15,16 +15,35 @@
   <!--#include virtual="header.html" -->
   <H1 ALIGN="CENTER">Module mod_autoindex</H1>
   
  -This module is contained in the <CODE>mod_autoindex.c</CODE> file, and
  -is compiled in by default. It provides for automatic directory indexing.
  +This module provides for automatic directory indexing.
   
  +<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_autoindex.c
  +<BR>
  +<A
  +HREF="module-dict.html#ModuleIdentifier"
  +REL="Help"
  +><STRONG>Module Identifier:</STRONG></A> autoindex_module
  +</P>
  +
  +
   <H2>Summary</H2>
  +<!-- XXX: This should mention the necessity of Options +Indexes -->
   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="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
  @@ -61,7 +80,7 @@
   
   <H2>Directives</H2>
   
  -<MENU>
  +<UL>
   <LI><A HREF="#addalt">AddAlt</A>
   <LI><A HREF="#addaltbyencoding">AddAltByEncoding</A>
   <LI><A HREF="#addaltbytype">AddAltByType</A>
  @@ -76,10 +95,14 @@
   <LI><A HREF="#indexoptions">IndexOptions</A>
   <LI><A HREF="#indexorderdefault">IndexOrderDefault</A>
   <LI><A HREF="#readmename">ReadmeName</A>
  -</MENU>
  +</UL>
  +
  +<p>See also: <A HREF="core.html#options">Options</A> and <A
  +HREF="mod_dir.html#directoryindex">DirectoryIndex</A>.</p>
  +
   <HR>
   
  -<H2><A NAME="addalt">AddAlt</A></H2>
  +<H2><A NAME="addalt">AddAlt</A> directive</H2>
   <!--%plaintext &lt;?INDEX {\tt AddAlt} directive&gt; -->
   <A
    HREF="directive-dict.html#Syntax"
  @@ -111,7 +134,7 @@
   image-incapable or has image loading disabled.
   
   <HR>
  -<H2><A NAME="addaltbyencoding">AddAltByEncoding</A></H2>
  +<H2><A NAME="addaltbyencoding">AddAltByEncoding</A> directive</H2>
   <!--%plaintext &lt;?INDEX {\tt AddAltByEncoding} directive&gt; -->
   <A
    HREF="directive-dict.html#Syntax"
  @@ -144,7 +167,7 @@
   image-incapable or has image loading disabled.
   
   <HR>
  -<H2><A NAME="addaltbytype">AddAltByType</A></H2>
  +<H2><A NAME="addaltbytype">AddAltByType</A> directive</H2>
   <!--%plaintext &lt;?INDEX {\tt AddAltByType} directive&gt; -->
   <A
    HREF="directive-dict.html#Syntax"
  @@ -178,7 +201,7 @@
   
   <HR>
   
  -<H2><A NAME="adddescription">AddDescription</A></H2>
  +<H2><A NAME="adddescription">AddDescription</A> directive</H2>
   <!--%plaintext &lt;?INDEX {\tt AddDescription} directive&gt; -->
   <A
    HREF="directive-dict.html#Syntax"
  @@ -229,7 +252,7 @@
   </P>
   <HR>
   
  -<H2><A NAME="addicon">AddIcon</A></H2>
  +<H2><A NAME="addicon">AddIcon</A> directive</H2>
   <!--%plaintext &lt;?INDEX {\tt AddIcon} directive&gt; -->
   <A
    HREF="directive-dict.html#Syntax"
  @@ -270,7 +293,7 @@
   <A HREF="#addiconbytype">AddIconByType</A> should be used in preference to
   AddIcon, when possible.<P><HR>
   
  -<H2><A NAME="addiconbyencoding">AddIconByEncoding</A></H2>
  +<H2><A NAME="addiconbyencoding">AddIconByEncoding</A> directive</H2>
   <!--%plaintext &lt;?INDEX {\tt AddIconByEncoding} directive&gt; -->
   <A
    HREF="directive-dict.html#Syntax"
  @@ -307,7 +330,7 @@
   AddIconByEncoding /icons/compress.xbm x-compress
   </CODE></BLOCKQUOTE><P><HR>
   
  -<H2><A NAME="addiconbytype">AddIconByType</A></H2>
  +<H2><A NAME="addiconbytype">AddIconByType</A> directive</H2>
   <!--%plaintext &lt;?INDEX {\tt AddIconByType} directive&gt; -->
   <A
    HREF="directive-dict.html#Syntax"
  @@ -343,7 +366,7 @@
   AddIconByType (IMG,/icons/image.xbm) image/*
   </CODE></BLOCKQUOTE><P><HR>
   
  -<H2><A NAME="defaulticon">DefaultIcon</A></H2>
  +<H2><A NAME="defaulticon">DefaultIcon</A> directive</H2>
   <!--%plaintext &lt;?INDEX {\tt DefaultIcon} directive&gt; -->
   <A
    HREF="directive-dict.html#Syntax"
  @@ -374,7 +397,7 @@
   DefaultIcon /icon/unknown.xbm
   </CODE></BLOCKQUOTE><P><HR>
   
  -<H2><A NAME="fancyindexing">FancyIndexing</A></H2>
  +<H2><A NAME="fancyindexing">FancyIndexing</A> directive</H2>
   <!--%plaintext &lt;?INDEX {\tt FancyIndexing} directive&gt; -->
   <A
    HREF="directive-dict.html#Syntax"
  @@ -415,7 +438,7 @@
   </BLOCKQUOTE>
   <HR>
   
  -<H2><A NAME="headername">HeaderName</A></H2>
  +<H2><A NAME="headername">HeaderName</A> directive</H2>
   <!--%plaintext &lt;?INDEX {\tt HeaderName} directive&gt; -->
   <A
    HREF="directive-dict.html#Syntax"
  @@ -485,7 +508,7 @@
   See also <A HREF="#readmename">ReadmeName</A>.
   <P><HR>
   
  -<H2><A NAME="indexignore">IndexIgnore</A></H2>
  +<H2><A NAME="indexignore">IndexIgnore</A> directive</H2>
   <!--%plaintext &lt;?INDEX {\tt IndexIgnore} directive&gt; -->
   <A
    HREF="directive-dict.html#Syntax"
  @@ -518,7 +541,7 @@
   IndexIgnore README .htaccess *~
   </CODE></BLOCKQUOTE><P><HR>
   
  -<H2><A NAME="indexoptions">IndexOptions</A></H2>
  +<H2><A NAME="indexoptions">IndexOptions</A> directive</H2>
   <!--%plaintext &lt;?INDEX {\tt IndexOptions} directive&gt; -->
   <A
    HREF="directive-dict.html#Syntax"
  @@ -767,7 +790,7 @@
   
   <HR>
   
  -<H2><A NAME="indexorderdefault">IndexOrderDefault</A></H2>
  +<H2><A NAME="indexorderdefault">IndexOrderDefault</A> directive</H2>
   <!--%plaintext &lt;?INDEX {\tt IndexOrderDefault} directive&gt; -->
   <A
    HREF="directive-dict.html#Syntax"
  @@ -826,7 +849,7 @@
   
   <HR>
   
  -<H2><A NAME="readmename">ReadmeName</A></H2>
  +<H2><A NAME="readmename">ReadmeName</A> directive</H2>
   <!--%plaintext &lt;?INDEX {\tt ReadmeName} directive&gt; -->
   <A
    HREF="directive-dict.html#Syntax"
  
  
  
  1.14      +32 -6     httpd-docs-2.0/htdocs/manual/mod/mod_cern_meta.html
  
  Index: mod_cern_meta.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-2.0/htdocs/manual/mod/mod_cern_meta.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- mod_cern_meta.html	1998/06/04 18:46:36	1.13
  +++ mod_cern_meta.html	2000/09/26 19:21:07	1.14
  @@ -15,12 +15,34 @@
   <!--#include virtual="header.html" -->
   <H1 ALIGN="CENTER">Apache module mod_cern_meta</H1>
   
  -This module is contained in the <CODE>mod_cern_meta.c</CODE> file, and
  -is not compiled in by default. It provides for CERN httpd metafile
  -semantics. It is only available in Apache 1.1 and later.
  +<p>This module provides for CERN httpd metafile semantics.</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_cern_meta.c
  +<BR>
  +<A
  +HREF="module-dict.html#ModuleIdentifier"
  +REL="Help"
  +><STRONG>Module Identifier:</STRONG></A> cern_meta_module
  +<BR>
  +<A
  +HREF="module-dict.html#Compatibility"
  +REL="Help"
  +><STRONG>Compatibility:</STRONG></A> Available in Apache 1.1 and later.
  +</P>
  +
  +
   <H2>Summary</H2>
   
  +<!-- XXX: Should mention other possibilities in Apache: mod_header -->
  +
   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
  @@ -43,7 +65,7 @@
   
   <HR>
   
  -<H2><A NAME="metafiles">MetaFiles</A></H2>
  +<H2><A NAME="metafiles">MetaFiles</A> directive</H2>
   <A
    HREF="directive-dict.html#Syntax"
    REL="Help"
  @@ -72,7 +94,9 @@
   
   Turns on/off Meta file processing on a per-directory basis. This option was introduced
in Apache 1.3.
   
  -<H2><A NAME="metadir">MetaDir</A></H2>
  +<hr>
  +
  +<H2><A NAME="metadir">MetaDir</A> directive</H2>
   <A
    HREF="directive-dict.html#Syntax"
    REL="Help"
  @@ -102,8 +126,10 @@
   subdirectory of the directory that contains the file being
   accessed. Set to "<CODE>.</CODE>" to look in the same directory as the
   file.
  +
  +<hr>
   
  -<H2><A NAME="metasuffix">MetaSuffix</A></H2>
  +<H2><A NAME="metasuffix">MetaSuffix</A> directive</H2>
   <A
    HREF="directive-dict.html#Syntax"
    REL="Help"
  
  
  
  1.19      +39 -10    httpd-docs-2.0/htdocs/manual/mod/mod_cgi.html
  
  Index: mod_cgi.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-2.0/htdocs/manual/mod/mod_cgi.html,v
  retrieving revision 1.18
  retrieving revision 1.19
  diff -u -r1.18 -r1.19
  --- mod_cgi.html	1998/11/20 16:34:17	1.18
  +++ mod_cgi.html	2000/09/26 19:21:08	1.19
  @@ -16,14 +16,29 @@
   
   <H1 ALIGN="CENTER">Module mod_cgi</H1>
   
  -This module is contained in the <CODE>mod_cgi.c</CODE> file, and
  -is compiled in by default. It provides for execution of CGI scripts.
  -Any file with mime type <CODE>application/x-httpd-cgi</CODE> will be
  -processed by this module.
  -<!--%plaintext &lt;?INDEX {\tt application/x-httpd-cgi} mime type&gt; -->
  -<!--%plaintext &lt;?INDEX CGI scripts&gt; -->
  +<p>This module provides for execution of CGI scripts.</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_cgi.c
  +<BR>
  +<A
  +HREF="module-dict.html#ModuleIdentifier"
  +REL="Help"
  +><STRONG>Module Identifier:</STRONG></A> cgi_module
  +</P>
  +
  +
   <H2>Summary</H2>
  +<!-- XXX: Should have references to CGI definition/RFC -->
  +<!-- XXX: Should mention Options ExecCGI  -->
  +
   Any file that has the mime type <CODE>application/x-httpd-cgi</CODE>
   or handler <CODE>cgi-script</CODE> (Apache 1.1 or later)
   will be treated as a CGI script, and run by the server, with its output
  @@ -37,6 +52,18 @@
   value of the <A HREF="core.html#documentroot">DocumentRoot</A>
   configuration variable.
   
  +<h2>Directives</h2>
  +
  +<ul>
  +<li><a href="#scriptlog">ScriptLog</a></li>
  +<li><a href="#scriptloglength">ScriptLogLength</a></li>
  +<li><a href="#scriptlogbuffer">ScriptLogBuffer</a></li>
  +</ul>
  +
  +<p>See also: <a href="core.html#options">Options</a>, <a
  +href="mod_alias.html#scriptalias">ScriptAlias</a> and <a
  +href="mod_mime.html#addtype">AddType</a>.
  +
   <H2>CGI Environment variables</H2>
   The server will set the CGI environment variables as described in the
   <A HREF="http://hoohoo.ncsa.uiuc.edu/cgi/">CGI specification</A>, with the
  @@ -115,10 +142,8 @@
   anything on standard output or standard error).
   
   <HR>
  -
  -<H2>Directives</H2>
   
  -<H3><A NAME="scriptlog">ScriptLog</A></H3>
  +<H3><A NAME="scriptlog">ScriptLog</A> directive</H3>
   
   <A
    HREF="directive-dict.html#Syntax"
  @@ -158,8 +183,10 @@
   have security problems if used in a manner other than that for which
   it was designed.</P>
   
  -<H3><A NAME="scriptloglength">ScriptLogLength</A></H3>
  +<hr>
   
  +<H3><A NAME="scriptloglength">ScriptLogLength</A> directive</H3>
  +
   <A
    HREF="directive-dict.html#Syntax"
    REL="Help"
  @@ -184,6 +211,8 @@
   file. To prevent problems due to unbounded growth, this directive can
   be used to set an maximum file-size for the CGI logfile. If the file
   exceeds this size, no more information will be written to it.
  +
  +<hr>
   
   <H3><A NAME="scriptlogbuffer">ScriptLogBuffer</A></H3>
   
  
  
  
  1.13      +104 -86   httpd-docs-2.0/htdocs/manual/mod/mod_expires.html
  
  Index: mod_expires.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-2.0/htdocs/manual/mod/mod_expires.html,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- mod_expires.html	1998/09/17 12:06:40	1.12
  +++ mod_expires.html	2000/09/26 19:21:09	1.13
  @@ -14,11 +14,27 @@
     <!--#include virtual="header.html" -->
     <H1 ALIGN="CENTER">Module mod_expires</H1>
     <P>
  -  This module is contained in the <CODE>mod_expires.c</CODE> file, and
  -  is <STRONG>not</STRONG> compiled in by default.  It provides for the
  -  generation of <CODE>Expires</CODE> headers according to user-specified
  -  criteria.
  +  This module provides for the generation of <CODE>Expires</CODE> HTTP
  +  headers according to user-specified criteria.
     </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_expires.c
  +<BR>
  +<A
  +HREF="module-dict.html#ModuleIdentifier"
  +REL="Help"
  +><STRONG>Module Identifier:</STRONG></A> expires_module
  +</P>
  +
  +
     <H2>Summary</H2>
     <P>
     This module controls the setting of the <CODE>Expires</CODE> HTTP
  @@ -34,9 +50,10 @@
     &quot;expired&quot; and invalid, and a new copy must be obtained from
     the source.
     </P>
  +
     <H2>Directives</H2>
     <P>
  -  <MENU>
  +  <ul>
      <LI><A
           HREF="#expiresactive"
          >ExpiresActive</A>
  @@ -49,7 +66,89 @@
           HREF="#expiresdefault"
          >ExpiresDefault</A>
      </LI>
  +  </ul>
  +
  +  <H2>
  +   <A NAME="AltSyn">Alternate Interval Syntax</A>
  +  </H2>
  +  <P>
  +  The 
  +  <A
  +   HREF="#expiresdefault"
  +  ><SAMP>ExpiresDefault</SAMP></A>
  +  and
  +  <A
  +   HREF="#expiresbytype"
  +  ><SAMP>ExpiresByType</SAMP></A>
  +  directives can also be defined in a more readable syntax of the form:
  +  </P>
  +  <DL>
  +   <DD><CODE>ExpiresDefault "&lt;base&gt; [plus] {&lt;num&gt;
&lt;type&gt;}*"
  +    <BR>
  +    ExpiresByType type/encoding "&lt;base&gt; [plus]
  +      {&lt;num&gt; &lt;type&gt;}*"</CODE>
  +   </DD>
  +  </DL>
  +  <P>
  +  where &lt;base&gt; is one of:
  +  </P>
  +  <MENU>
  +   <LI><SAMP>access</SAMP>  
  +   </LI>
  +   <LI><SAMP>now</SAMP> (equivalent to '<SAMP>access</SAMP>')
  +   </LI>
  +   <LI><SAMP>modification</SAMP>
  +   </LI>
     </MENU>
  +  <P>
  +  The '<SAMP>plus</SAMP>' keyword is optional.  &lt;num&gt; should
be an
  +  integer value [acceptable to <SAMP>atoi()</SAMP>], and &lt;type&gt;
  +  is one of:
  +  </P>
  +  <MENU>
  +   <LI><SAMP>years</SAMP>
  +   </LI>
  +   <LI><SAMP>months</SAMP>
  +   </LI>
  +   <LI><SAMP>weeks</SAMP>
  +   </LI>
  +   <LI><SAMP>days</SAMP>
  +   </LI>
  +   <LI><SAMP>hours</SAMP>
  +   </LI>
  +   <LI><SAMP>minutes</SAMP>
  +   </LI>
  +   <LI><SAMP>seconds</SAMP>
  +   </LI>
  +  </MENU>
  +  <P>
  +  For example, any of the following directives can be used to make
  +  documents expire 1 month after being accessed, by default:
  +  </P>
  +  <DL>
  +   <DD><CODE>ExpiresDefault "access plus 1 month"
  +    <BR>
  +    ExpiresDefault "access plus 4 weeks"
  +    <BR>
  +    ExpiresDefault "access plus 30 days"</CODE>
  +   </DD>
  +  </DL>
  +  <P>
  +  The expiry time can be fine-tuned by adding several '&lt;num&gt;
  +  &lt;type&gt;' clauses:
  +  </P>
  +  <DL>
  +   <DD><CODE>ExpiresByType text/html "access plus 1 month 15 days 2 hours"
  +    <BR>
  +    ExpiresByType image/gif "modification plus 5 hours 3 minutes"</CODE>
  +   </DD>
  +  </DL>
  +  <P>
  +  Note that if you use a modification date based setting, the Expires
  +  header will <STRONG>not</STRONG> be added to content that does
  +  not come from a file on disk.  This is due to the fact that there is
  +  no modification time for such content.
  +
     <HR>
     <H2><A NAME="expiresactive">
      ExpiresActive directive
  @@ -240,87 +339,6 @@
     >alternate syntax</A>
     description as well.
     </P>
  -  <HR>
  -  <H2>
  -   <A NAME="AltSyn">Alternate Interval Syntax</A>
  -  </H2>
  -  <P>
  -  The 
  -  <A
  -   HREF="#expiresdefault"
  -  ><SAMP>ExpiresDefault</SAMP></A>
  -  and
  -  <A
  -   HREF="#expiresbytype"
  -  ><SAMP>ExpiresByType</SAMP></A>
  -  directives can also be defined in a more readable syntax of the form:
  -  </P>
  -  <DL>
  -   <DD><CODE>ExpiresDefault "&lt;base&gt; [plus] {&lt;num&gt;
&lt;type&gt;}*"
  -    <BR>
  -    ExpiresByType type/encoding "&lt;base&gt; [plus]
  -      {&lt;num&gt; &lt;type&gt;}*"</CODE>
  -   </DD>
  -  </DL>
  -  <P>
  -  where &lt;base&gt; is one of:
  -  </P>
  -  <MENU>
  -   <LI><SAMP>access</SAMP>  
  -   </LI>
  -   <LI><SAMP>now</SAMP> (equivalent to '<SAMP>access</SAMP>')
  -   </LI>
  -   <LI><SAMP>modification</SAMP>
  -   </LI>
  -  </MENU>
  -  <P>
  -  The '<SAMP>plus</SAMP>' keyword is optional.  &lt;num&gt; should
be an
  -  integer value [acceptable to <SAMP>atoi()</SAMP>], and &lt;type&gt;
  -  is one of:
  -  </P>
  -  <MENU>
  -   <LI><SAMP>years</SAMP>
  -   </LI>
  -   <LI><SAMP>months</SAMP>
  -   </LI>
  -   <LI><SAMP>weeks</SAMP>
  -   </LI>
  -   <LI><SAMP>days</SAMP>
  -   </LI>
  -   <LI><SAMP>hours</SAMP>
  -   </LI>
  -   <LI><SAMP>minutes</SAMP>
  -   </LI>
  -   <LI><SAMP>seconds</SAMP>
  -   </LI>
  -  </MENU>
  -  <P>
  -  For example, any of the following directives can be used to make
  -  documents expire 1 month after being accessed, by default:
  -  </P>
  -  <DL>
  -   <DD><CODE>ExpiresDefault "access plus 1 month"
  -    <BR>
  -    ExpiresDefault "access plus 4 weeks"
  -    <BR>
  -    ExpiresDefault "access plus 30 days"</CODE>
  -   </DD>
  -  </DL>
  -  <P>
  -  The expiry time can be fine-tuned by adding several '&lt;num&gt;
  -  &lt;type&gt;' clauses:
  -  </P>
  -  <DL>
  -   <DD><CODE>ExpiresByType text/html "access plus 1 month 15 days 2 hours"
  -    <BR>
  -    ExpiresByType image/gif "modification plus 5 hours 3 minutes"</CODE>
  -   </DD>
  -  </DL>
  -  <P>
  -  Note that if you use a modification date based setting, the Expires
  -  header will <STRONG>not</STRONG> be added to content that does
  -  not come from a file on disk.  This is due to the fact that there is
  -  no modification time for such content.
   
     <!--#include virtual="footer.html" -->
    </BODY>
  
  
  

Mime
View raw message