From 25bad8d37eab41b3db605b53899e5c587ba31165 Mon Sep 17 00:00:00 2001
From: Rich Bowen <rbowen@apache.org>
Date: Sun, 25 Jan 2009 22:13:40 +0000
Subject: [PATCH] Adds a mod_authn_file example to the AuthProviderAlias docs,
 since more people understand mod_authn_file than understand LDAP.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@737588 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/mod/mod_authn_core.html.en | 35 ++++++++++++++++++++++++--
 docs/manual/mod/mod_authn_core.xml     | 35 ++++++++++++++++++++++++--
 2 files changed, 66 insertions(+), 4 deletions(-)

diff --git a/docs/manual/mod/mod_authn_core.html.en b/docs/manual/mod/mod_authn_core.html.en
index f98dbd3fbd..755b9dc96a 100644
--- a/docs/manual/mod/mod_authn_core.html.en
+++ b/docs/manual/mod/mod_authn_core.html.en
@@ -59,13 +59,44 @@
     extended authentication provider to be reference by multiple 
     locations.</p>
 
-    <h3><a name="example" id="example">Example</a></h3>
+    <h3><a name="example" id="example">Examples</a></h3>
+
+        <p>This example checks for passwords in two different text
+        files.</p>
+
+        <div class="example"><h3>Checking multiple text password files</h3><p><code>
+
+        # Check here first<br />
+        &lt;AuthnProviderAlias file file1&gt;<br />
+        <span class="indent">
+            AuthUserFile /www/conf/passwords1<br />
+        </span>
+        &lt;/AuthnProviderAlias&gt;<br />
+        <br />
+        # Then check here<br />
+        &lt;AuthnProviderAlias file file2&gt;   <br />
+        <span class="indent">
+            AuthUserFile /www/conf/passwords2<br />
+        </span>
+        &lt;/AuthnProviderAlias&gt;<br />
+        <br />
+        &lt;Directory /var/web/pages/secure&gt;<br />
+        <span class="indent">
+            AuthBasicProvider file1 file2<br />
+            <br />
+            AuthType Basic<br />
+            AuthName "Protected Area"<br />
+            Require valid-user<br />
+        </span>
+        &lt;/Directory&gt;<br />
+        </code></p></div>
+
         <p>The example below creates two different ldap authentication 
         provider aliases based on the ldap provider.  This allows
         a single authenticated location to be serviced by multiple ldap
         hosts:</p>
     
-        <div class="example"><h3>Example</h3><p><code>
+        <div class="example"><h3>Checking multiple LDAP servers</h3><p><code>
           &lt;AuthnProviderAlias ldap ldap-alias1&gt;<br />
           <span class="indent">
              AuthLDAPBindDN cn=youruser,o=ctx<br />
diff --git a/docs/manual/mod/mod_authn_core.xml b/docs/manual/mod/mod_authn_core.xml
index 88d9c5da5e..fd3284cdc6 100644
--- a/docs/manual/mod/mod_authn_core.xml
+++ b/docs/manual/mod/mod_authn_core.xml
@@ -48,13 +48,44 @@
     extended authentication provider to be reference by multiple 
     locations.</p>
 
-    <section id="example"><title>Example</title>
+    <section id="example"><title>Examples</title>
+
+        <p>This example checks for passwords in two different text
+        files.</p>
+
+        <example><title>Checking multiple text password files</title>
+
+        # Check here first<br />
+        &lt;AuthnProviderAlias file file1&gt;<br />
+        <indent>
+            AuthUserFile /www/conf/passwords1<br />
+        </indent>
+        &lt;/AuthnProviderAlias&gt;<br />
+        <br />
+        # Then check here<br />
+        &lt;AuthnProviderAlias file file2&gt;   <br />
+        <indent>
+            AuthUserFile /www/conf/passwords2<br />
+        </indent>
+        &lt;/AuthnProviderAlias&gt;<br />
+        <br />
+        &lt;Directory /var/web/pages/secure&gt;<br />
+        <indent>
+            AuthBasicProvider file1 file2<br />
+            <br />
+            AuthType Basic<br />
+            AuthName "Protected Area"<br />
+            Require valid-user<br />
+        </indent>
+        &lt;/Directory&gt;<br />
+        </example>
+
         <p>The example below creates two different ldap authentication 
         provider aliases based on the ldap provider.  This allows
         a single authenticated location to be serviced by multiple ldap
         hosts:</p>
     
-        <example><title>Example</title>
+        <example><title>Checking multiple LDAP servers</title>
           &lt;AuthnProviderAlias ldap ldap-alias1&gt;<br />
           <indent>
              AuthLDAPBindDN cn=youruser,o=ctx<br />
-- 
2.40.0