Adds the frequently-requested example of relaxing authentication for a

subdirectory. Whether this is actually a *good* idea is left as an
exercise for the reader.


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

2 files changed, 40 insertions, 0 deletions

diff --git a/docs/manual/mod/mod_access_compat.html.en b/docs/manual/mod/mod_access_compat.html.en
index a04c297f6b..a91adab23f 100644
--- a/docs/manual/mod/mod_access_compat.html.en
+++ b/docs/manual/mod/mod_access_compat.html.en
@@ -414,6 +414,26 @@ later</td></tr>
       Satisfy Any
     </code></p></div>
 
+    <p>
+    Another frequent use of the <code class="directive">Satisfy</code> directive
+    is to relax access restrictions for a subdirectory:
+    </p>
+
+    <div class="example"><p><code>
+      &lt;Directory /var/www/private&gt;<br />
+        Require valid-user<br /> 
+      &lt;/Directory&gt;<br />
+      <br />
+      &lt;Directory /var/www/private/public&gt;<br />
+        Allow from all<br />
+        Satisfy Any<br />
+      &lt;/Directory&gt;
+    </code></p></div>
+
+    <p>In the above example, authentication will be required for the
+    <code>/var/www/private</code> directory, but will not be required
+    for the <code>/var/www/private/public</code> directory.</p>
+
     <p>Since version 2.0.51 <code class="directive">Satisfy</code> directives can
     be restricted to particular methods by <code class="directive"><a href="../mod/core.html#limit">&lt;Limit&gt;</a></code> and <code class="directive"><a href="../mod/core.html#limitexcept">&lt;LimitExcept&gt;</a></code> sections.</p>
 
diff --git a/docs/manual/mod/mod_access_compat.xml b/docs/manual/mod/mod_access_compat.xml
index 4b9fca2e69..7ce830cec0 100644
--- a/docs/manual/mod/mod_access_compat.xml
+++ b/docs/manual/mod/mod_access_compat.xml
@@ -433,6 +433,26 @@ later</compatibility>
       Satisfy Any
     </example>
 
+    <p>
+    Another frequent use of the <directive>Satisfy</directive> directive
+    is to relax access restrictions for a subdirectory:
+    </p>
+
+    <example>
+      &lt;Directory /var/www/private&gt;<br />
+        Require valid-user<br /> 
+      &lt;/Directory&gt;<br />
+      <br />
+      &lt;Directory /var/www/private/public&gt;<br />
+        Allow from all<br />
+        Satisfy Any<br />
+      &lt;/Directory&gt;
+    </example>
+
+    <p>In the above example, authentication will be required for the
+    <code>/var/www/private</code> directory, but will not be required
+    for the <code>/var/www/private/public</code> directory.</p>
+
     <p>Since version 2.0.51 <directive>Satisfy</directive> directives can
     be restricted to particular methods by <directive module="core"
     type="section">Limit</directive> and <directive module="core" type="section"