httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sl...@apache.org
Subject cvs commit: httpd-docs-1.3/htdocs/manual/misc FAQ-E.html
Date Wed, 30 Jan 2002 01:59:33 GMT
slive       02/01/29 17:59:33

  Modified:    htdocs/manual/misc FAQ-E.html
  Log:
  The "basic configuration" section of the FAQ is getting out of hand,
  but these are certainly two FAQs:
  
  1. As suggested by Daniel Lopez, remind people about using Options to
  turn on and off indexes.
  
  2. Help people who don't understand the precendence rules for Options.
  In general, people seem to want to put Options directives in the
  main server context, which almost never works.  This is one of the most
  confusing things about configuring apache.  Unfortunately, most people
  who run into this problem don't even know that Options is the cause,
  so they will never find this FAQ.  Oh well.
  
  Revision  Changes    Path
  1.15      +61 -1     httpd-docs-1.3/htdocs/manual/misc/FAQ-E.html
  
  Index: FAQ-E.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/misc/FAQ-E.html,v
  retrieving revision 1.14
  retrieving revision 1.15
  diff -u -d -b -u -r1.14 -r1.15
  --- FAQ-E.html	31 Dec 2001 22:00:23 -0000	1.14
  +++ FAQ-E.html	30 Jan 2002 01:59:33 -0000	1.15
  @@ -33,7 +33,7 @@
       <h1 align="CENTER">Apache Server Frequently Asked
       Questions</h1>
   
  -    <p>$Revision: 1.14 $ ($Date: 2001/12/31 22:00:23 $)</p>
  +    <p>$Revision: 1.15 $ ($Date: 2002/01/30 01:59:33 $)</p>
   
       <p>The latest version of this FAQ is always available from the
       main Apache web site, at &lt;<a
  @@ -136,6 +136,13 @@
             server or from my local network, but I can't access it from
             elsewhere on the Internet?</a></li>
   
  +	  <li><a href="#indexes">How do I turn automatic directory indexes
  +	  on or off?</a></li>
  +
  +         <li><a href="#options">Why do my Options directives not have
  +         the desired effect?</a></li>
  +
  +
           </ol>
         </li>
         <!--#endif -->
  @@ -718,6 +725,59 @@
   
           <hr /></li>
   
  +         <li><a id="indexes" name="indexes"><strong>How do I turn automatic
  +         directory indexes on or off?</strong></a>
  +
  +         <p>If a client requests a URL that designates a directory and
  +         the directory does not contain a filename that matches the <a
  +         href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a>
  +         directive, then <a
  +         href="../mod/mod_autoindex.html">mod_autoindex</a> can be
  +         configured to present a listing of the directory contents.</p>
  +
  +         <p>To turn on automatic directory indexing, find the 
  +         <a href="../mod/core.html#options">Options</a> directive that
  +         applies to the directory and add the <code>Indexes</code>
  +         keyword.  To turn off automatic directory indexing, remove
  +         the <code>Indexes</code> keyword from the appropriate 
  +         <code>Options</code> line.</p>
  +
  +       <hr /></li>
  +
  +         <li><a id="options" name="options"><strong>Why do my Options
  +         directives not have the desired effect?</strong></a>
  +
  +         <p>Directives placed in the configuration files are applied
  +         in a very particular order, as described by <a
  +         href="../sections.html">How Directory, Location, and Files
  +         sections work</a>.  In addition, each <a
  +         href="../mod/core.html#options">Options</a> directive has the
  +         effect of resetting the options to <code>none</code> before
  +         adding the specified options (unless only "+" and "-" options
  +         are used).  The consequence is that <code>Options</code> set
  +         in the main server or virtual host context (outside any
  +         directory, location, or files section) will usually have no
  +         effect, because they are overriden by more specific
  +         <code>Options</code> directives.  For example, in the following</p>
  +
  +<blockquote><code>
  +&lt;Directory /usr/local/apache/htdocs&gt;<br />
  +&nbsp;&nbsp;&nbsp;&nbsp;Options Indexes<br />
  +&lt;/Directory&gt;<br />
  +Options Includes ExecCGI<br />
  +</code></blockquote>
  +    
  +         <p><code>Includes</code> and <code>ExecCGI</code>
will be 
  +         <strong>off</strong> in the <code>/usr/local/apache/htdocs</code>
  +         directory.</p>
  +
  +         <p>You can usually avoid problems by either finding the 
  +         <code>Options</code> directive that already applies to a 
  +         specific directory and changing it, or by putting your
  +         <code>Options</code> directive inside the most specific possible
  +         <code>&lt;Directory&gt;</code> section.</p>
  +
  +       <hr /></li>
   
       </ol>
       <!--#endif -->
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message