You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by pe...@apache.org on 2001/02/06 17:31:17 UTC
cvs commit: httpd-2.0/docs/manual sections.html
pepper 01/02/06 08:31:17
Modified: docs/manual sections.html
Log:
Added note about later sections overriding earlier.
Removed note about order reversal in 1.2-1.3a versions.
Fixed a couple typos.
Matched up <p> & </p>.
Revision Changes Path
1.11 +26 -33 httpd-2.0/docs/manual/sections.html
Index: sections.html
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/sections.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- sections.html 2000/10/04 13:44:28 1.10
+++ sections.html 2001/02/06 16:31:17 1.11
@@ -12,9 +12,10 @@
ALINK="#FF0000"
>
<!--#include virtual="header.html" -->
+
<H1 ALIGN="CENTER">How Directory, Location and Files sections work</H1>
-The sections <A
+<p>The sections <A
HREF="mod/core.html#directory"><CODE><Directory></CODE></A>, <A
HREF="mod/core.html#location"><CODE><Location></CODE></A> and <A
HREF="mod/core.html#files"><CODE><Files></CODE></A> can contain
@@ -23,31 +24,31 @@
apply directives to that directory. This document explains how these
different sections differ and how they relate to each other when
Apache decides which directives apply for a particular directory or
-request URL.
+request URL.</p>
<H2>Directives allowed in the sections</H2>
-Everything that is syntactically allowed in
+<p>Everything that is syntactically allowed in
<CODE><Directory></CODE> is also allowed in
<CODE><Location></CODE> (except a sub-<CODE><Files></CODE>
-section). Semantically however some things, and the most
-notable are <CODE>AllowOverride</CODE> and the two options
+section). Semantically, however some things, most
+notably <CODE>AllowOverride</CODE> and the two options
<CODE>FollowSymLinks</CODE> and <CODE>SymLinksIfOwnerMatch</CODE>,
make no sense in <CODE><Location></CODE>,
<CODE><LocationMatch></CODE> or <CODE><DirectoryMatch></CODE>.
The same for <CODE><Files></CODE> -- syntactically everything
-is fine, but semantically some things are different.
+is fine, but semantically some things are different.</p>
<H2>How the sections are merged</H2>
-The order of merging is:
+<p>The order of merging is:</p>
<OL>
<LI>
<CODE><Directory></CODE> (except regular expressions) and
- .htaccess done simultaneously (with .htaccess overriding
+ .htaccess done simultaneously (with .htaccess, if allowed, overriding
<CODE><Directory></CODE>)
</LI>
@@ -68,7 +69,7 @@
</OL>
-Apart from <CODE><Directory></CODE>, each group is processed in
+<p>Apart from <CODE><Directory></CODE>, each group is processed in
the order that they appear in the configuration
files. <CODE><Directory></CODE> (group 1 above) is processed in
the order shortest directory component to longest. If multiple
@@ -77,22 +78,18 @@
configuration files are read in the order httpd.conf, srm.conf and
access.conf. Configurations included via the <CODE>Include</CODE>
directive will be treated as if they were inside the including file
-at the location of the <CODE>Include</CODE> directive.
-
-<P>
+at the location of the <CODE>Include</CODE> directive.</p>
-Sections inside <CODE><VirtualHost></CODE> sections are applied
+<p>Sections inside <CODE><VirtualHost></CODE> sections are applied
<EM>after</EM> the corresponding sections outside the virtual host
definition. This allows virtual hosts to override the main server
-configuration. (Note: this only works correctly from 1.2.2 and 1.3a2
-onwards. Before those releases sections inside virtual hosts were
-applied <EM>before</EM> the main server).
+configuration.</p>
-<H2>Notes about using sections</H2>
+<p>Later sections override earlier ones.</p>
-The general guidelines are:
+<H2>Notes about using sections</H2>
-<P>
+<p>The general guidelines are:</p>
<UL>
<LI>
@@ -107,7 +104,7 @@
</LI>
</UL>
-But a notable exception is:
+<p>But a notable exception is:</p>
<UL>
<LI>
@@ -119,18 +116,16 @@
</LI>
</UL>
-<P>
-Note about .htaccess parsing:
-</P>
+<p>Note about .htaccess parsing:</p>
+
<UL>
<LI>
Modifying .htaccess parsing during Location doesn't do
anything because .htaccess parsing has already occurred.
</UL>
+
+<p><CODE><Location></CODE> and symbolic links:</p>
-<P>
-<CODE><Location></CODE> and symbolic links:
-</P>
<UL>
<LI>
It is not possible to use "<CODE>Options FollowSymLinks</CODE>"
@@ -141,19 +136,16 @@
Using the options in question is only possible inside a
<CODE><Directory></CODE> section (or a <CODE>.htaccess</CODE> file).
</UL>
+
+<p><CODE><Files></CODE> and <CODE>Options</CODE>:</p>
-<P>
-<CODE><Files></CODE> and <CODE>Options</CODE>:
-</P>
<UL>
<LI>
Apache won't check for it, but using an <CODE>Options</CODE>
directive inside a <CODE><Files></CODE> section has no effect.
</UL>
-<P>
-Another note:
-</P>
+<p>Another note:</p>
<UL>
<LI>
@@ -167,4 +159,5 @@
</UL>
<!--#include virtual="footer.html" -->
-</BODY></HTML>
+</BODY>
+</HTML>