svn commit: r825898 - in /httpd/httpd/trunk/docs/manual/mod: mod_access_compat.html.en mod_access_compat.xml

[rb...@apache.org]

Author: rbowen
Date: Fri Oct 16 13:55:17 2009
New Revision: 825898

URL: http://svn.apache.org/viewvc?rev=825898&view=rev
Log:
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.

Modified:
    httpd/httpd/trunk/docs/manual/mod/mod_access_compat.html.en
    httpd/httpd/trunk/docs/manual/mod/mod_access_compat.xml

Modified: httpd/httpd/trunk/docs/manual/mod/mod_access_compat.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_access_compat.html.en?rev=825898&r1=825897&r2=825898&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_access_compat.html.en (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_access_compat.html.en Fri Oct 16 13:55:17 2009
@@ -414,6 +414,26 @@
       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>
 

Modified: httpd/httpd/trunk/docs/manual/mod/mod_access_compat.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_access_compat.xml?rev=825898&r1=825897&r2=825898&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_access_compat.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_access_compat.xml Fri Oct 16 13:55:17 2009
@@ -433,6 +433,26 @@
       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"