From 2172502b6991b939b16e5ef67759f379afd8b5b4 Mon Sep 17 00:00:00 2001
From: Mattias Hellborg Arthursson <mattias@261consulting.com>
Date: Wed, 14 Aug 2013 12:40:09 +0200
Subject: [PATCH] LDAP-225: Authentication documentation is misleading Added a
 clarifying note to section 10.1.

---
 src/docbkx/user-authentication.xml | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/src/docbkx/user-authentication.xml b/src/docbkx/user-authentication.xml
index 4cada665..8bbc9c41 100644
--- a/src/docbkx/user-authentication.xml
+++ b/src/docbkx/user-authentication.xml
@@ -75,15 +75,20 @@
         <title>Authenticating a user using Spring LDAP.</title>
 
         <programlisting>boolean authenticated = ldapTemplate.authenticate("", "(uid=john.doe)", "secret");</programlisting>
-      </example></para>
-
-    <tip>
-      <para>Don't write your own custom authenticate methods. Use the ones
-      provided in Spring LDAP 1.3.x.</para>
-    </tip>
+      </example>
+        <note>
+            As described in below, some setups may require additional operations to be performed
+            in order for actual authentication to occur. See <xref linkend="operationsOnAuthenticatedContext"/>
+            for details.
+        </note>
+        <tip>
+            Don't write your own custom authenticate methods. Use the ones
+                provided in Spring LDAP 1.3.x.
+        </tip>
+    </para>
   </sect1>
 
-  <sect1>
+  <sect1 id="operationsOnAuthenticatedContext">
     <title>Performing Operations on the Authenticated Context</title>
 
     <para>Some authentication schemes and LDAP servers require some operation