From b248eae416c46c29ca445248e090312a33880da8 Mon Sep 17 00:00:00 2001
From: hmolsen <mail@hannesmolsen.de>
Date: Wed, 2 Mar 2016 20:39:28 +0100
Subject: [PATCH] Javadoc on ProviderManager.authenticate clarification

Fixes gh-3722
---
 .../security/authentication/ProviderManager.java     | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/core/src/main/java/org/springframework/security/authentication/ProviderManager.java b/core/src/main/java/org/springframework/security/authentication/ProviderManager.java
index 473436ac9f..7d6be070fd 100644
--- a/core/src/main/java/org/springframework/security/authentication/ProviderManager.java
+++ b/core/src/main/java/org/springframework/security/authentication/ProviderManager.java
@@ -136,9 +136,15 @@ public class ProviderManager implements AuthenticationManager, MessageSourceAwar
 	 * attempted with that <code>AuthenticationProvider</code>.
 	 * <p>
 	 * If more than one <code>AuthenticationProvider</code> supports the passed
-	 * <code>Authentication</code> object, only the first
-	 * <code>AuthenticationProvider</code> tried will determine the result. No subsequent
-	 * <code>AuthenticationProvider</code>s will be tried.
+	 * <code>Authentication</code> object, the first one able to successfully
+	 * authenticate the <code>Authentication</code> object determines the
+	 * <code>result</code>, overriding any possible <code>AuthenticationException</code>
+	 * thrown by earlier supporting <code>AuthenticationProvider</code>s.
+	 * On successful authentication, no subsequent <code>AuthenticationProvider</code>s
+	 * will be tried.
+	 * If authentication was not successful by any supporting
+	 * <code>AuthenticationProvider</code> the last thrown
+	 * <code>AuthenticationException</code> will be rethrown.
 	 *
 	 * @param authentication the authentication request object.
 	 *