Return-Path: 
 <cvs-return-37933-apmail-httpd-cvs-archive=httpd.apache.org@httpd.apache.org>
Delivered-To: apmail-httpd-cvs-archive@www.apache.org
Received: (qmail 76334 invoked from network); 18 Jan 2011 22:52:24 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3)
  by minotaur.apache.org with SMTP; 18 Jan 2011 22:52:24 -0000
Received: (qmail 28100 invoked by uid 500); 18 Jan 2011 22:52:23 -0000
Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org
Received: (qmail 28050 invoked by uid 500); 18 Jan 2011 22:52:23 -0000
Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@httpd.apache.org
list-help: <mailto:cvs-help@httpd.apache.org>
list-unsubscribe: <mailto:cvs-unsubscribe@httpd.apache.org>
List-Post: <mailto:cvs@httpd.apache.org>
List-Id: <cvs.httpd.apache.org>
Delivered-To: mailing list cvs@httpd.apache.org
Received: (qmail 28043 invoked by uid 99); 18 Jan 2011 22:52:23 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 18 Jan 2011 22:52:23 +0000
X-ASF-Spam-Status: No, hits=-2000.0 required=10.0
	tests=ALL_TRUSTED
X-Spam-Check-By: apache.org
Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4)
    by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 18 Jan 2011 22:52:22 +0000
Received: by eris.apache.org (Postfix, from userid 65534)
	id 90E3123888FD; Tue, 18 Jan 2011 22:52:02 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1060607 -
 /httpd/httpd/trunk/docs/manual/sections.html.en
Date: Tue, 18 Jan 2011 22:52:02 -0000
To: cvs@httpd.apache.org
From: sf@apache.org
X-Mailer: svnmailer-1.0.8
Message-Id: <20110118225202.90E3123888FD@eris.apache.org>

Author: sf
Date: Tue Jan 18 22:52:02 2011
New Revision: 1060607

URL: http://svn.apache.org/viewvc?rev=1060607&view=rev
Log:
update transforms

Modified:
    httpd/httpd/trunk/docs/manual/sections.html.en

Modified: httpd/httpd/trunk/docs/manual/sections.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/sections.html.en?rev=1060607&r1=1060606&r2=1060607&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/sections.html.en (original)
+++ httpd/httpd/trunk/docs/manual/sections.html.en Tue Jan 18 22:52:02 2011
@@ -31,7 +31,7 @@ use configuration section containers or 
 to change the scope of other configuration directives.</p>
 </div>
 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#types">Types of Configuration Section Containers</a></li>
-<li><img alt="" src="./images/down.gif" /> <a href="#file-and-web">Filesystem and Webspace</a></li>
+<li><img alt="" src="./images/down.gif" /> <a href="#file-and-web">Filesystem, Webspace, and Boolean Expressions</a></li>
 <li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">Virtual Hosts</a></li>
 <li><img alt="" src="./images/down.gif" /> <a href="#proxy">Proxy</a></li>
 <li><img alt="" src="./images/down.gif" /> <a href="#whatwhere">What Directives are Allowed?</a></li>
@@ -108,7 +108,7 @@ Also, these sections can be nested to ac
 restrictions.</p>
 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 <div class="section">
-<h2><a name="file-and-web" id="file-and-web">Filesystem and Webspace</a></h2>
+<h2><a name="file-and-web" id="file-and-web">Filesystem, Webspace, and Boolean Expressions</a></h2>
 
 <p>The most commonly used configuration section containers are the
 ones that change the configuration of particular places in the
@@ -278,6 +278,20 @@ Deny from all<br />
 
 
 
+<h3><a name="expressions" id="expressions">Boolean expressions</a></h3>
+<p>The <code class="directive"><a href="./mod/core.html#if">&lt;If&gt;</a></code>
+directive change the configuration depending on a condition which can be
+expressed by a boolean expression. For example, the following configuration
+denies access if the HTTP Referer header does not start with
+"http://www.example.com/".</p>
+<div class="example"><p><code>
+&lt;If "!(%{HTTP_REFERER} -strmatch 'http://www.example.com/*')"&gt;<br />
+Require all denied<br />
+&lt;/If&gt;
+</code></p></div>
+
+
+
 <h3><a name="whichwhen" id="whichwhen">What to use When</a></h3>
 
 <p>Choosing between filesystem containers and webspace containers is
@@ -322,6 +336,20 @@ rule.  Putting configuration restriction
 to all requests regardless of the specific URL.</p>
 
 
+<h3><a name="nesting" id="nesting">Nesting of sections</a></h3>
+
+<p>Some section types can be nested inside other section types. One the one
+hand, <code class="directive"><a href="./mod/core.html#file">&lt;File&gt;</a></code> can be used
+inside <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>.  On
+the other hand, <code class="directive"><a href="./mod/core.html#if">&lt;If&gt;</a></code> can
+be used inside <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>,
+<code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>, and <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code> sections. The regex
+counterparts of the named section behave identically.</p>
+
+<p>Nested sections are merged after non-nested sections of the same type.</p>
+
+
+
 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 <div class="section">
 <h2><a name="virtualhost" id="virtualhost">Virtual Hosts</a></h2>
@@ -405,6 +433,10 @@ are interpreted, it is important to unde
 
       <li><code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>
       and <code class="directive"><a href="./mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code> done simultaneously</li>
+
+      <li><code class="directive"><a href="./mod/core.html#if">&lt;If&gt;</a></code>
+      </li>
+
     </ol>
 
     <p>Apart from <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>, each group is processed in