address a frequent pitfall/misunderstanding about how multiple basic auth providers are used

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

2 files changed, 10 insertions, 0 deletions

diff --git a/docs/manual/mod/mod_auth_basic.html.en b/docs/manual/mod/mod_auth_basic.html.en
index d89dbe5578..f0cb8f6723 100644
--- a/docs/manual/mod/mod_auth_basic.html.en
+++ b/docs/manual/mod/mod_auth_basic.html.en
@@ -111,6 +111,11 @@ lower level modules</td></tr>
       &lt;/Location&gt;
     </code></p></div>
 
+    <p> Providers are queried in order until a provider finds a match
+    for the requested username, at which point this sole provider will 
+    attempt to check the password.  A failure to verify the password does
+    not result in control being passed on to subsequent providers.</p>
+
     <p>Providers are implemented by <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>,
     <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>, <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>,
     and <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>.</p>
diff --git a/docs/manual/mod/mod_auth_basic.xml b/docs/manual/mod/mod_auth_basic.xml
index 4c86d3adff..8528c68afc 100644
--- a/docs/manual/mod/mod_auth_basic.xml
+++ b/docs/manual/mod/mod_auth_basic.xml
@@ -74,6 +74,11 @@
       &lt;/Location&gt;
     </example>
 
+    <p> Providers are queried in order until a provider finds a match
+    for the requested username, at which point this sole provider will 
+    attempt to check the password.  A failure to verify the password does
+    not result in control being passed on to subsequent providers.</p>
+
     <p>Providers are implemented by <module>mod_authn_dbm</module>,
     <module>mod_authn_file</module>, <module>mod_authn_dbd</module>,
     and <module>mod_authnz_ldap</module>.</p>