diff --git a/docs/manual/src/docbook/namespace-config.xml b/docs/manual/src/docbook/namespace-config.xml
index 019024c780..8ad6f8602e 100644
--- a/docs/manual/src/docbook/namespace-config.xml
+++ b/docs/manual/src/docbook/namespace-config.xml
@@ -329,8 +329,10 @@
   ]]>
         </programlisting> where <literal>myAuthenticationProvider</literal> is the name of a
         bean in your application context which implements
-          <interfacename>AuthenticationProvider</interfacename>. See <xref linkend="ns-auth-manager"
-        /> for more on information on how the Spring Security
+          <interfacename>AuthenticationProvider</interfacename>. You can use multiple
+          <literal>authentication-provider</literal> elements, in which case they will be checked
+        in the order they are declared when attempting to authenticated a user. See <xref
+          linkend="ns-auth-manager"/> for more on information on how the Spring Security
           <interfacename>AuthenticationManager</interfacename> is configured using the namespace. </para>
       <section xml:id="ns-password-encoder">
         <title>Adding a Password Encoder</title>