From 05ba2ff3f30edc019f6e876fad3413e6dd592e0b Mon Sep 17 00:00:00 2001
From: Luke Taylor <luke.taylor@springsource.com>
Date: Sun, 14 Jun 2009 20:50:29 +0000
Subject: [PATCH] Improved Javadoc

---
 .../core/userdetails/UserDetailsService.java       | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/core/src/main/java/org/springframework/security/core/userdetails/UserDetailsService.java b/core/src/main/java/org/springframework/security/core/userdetails/UserDetailsService.java
index d2e7cdf172..499942ea1b 100644
--- a/core/src/main/java/org/springframework/security/core/userdetails/UserDetailsService.java
+++ b/core/src/main/java/org/springframework/security/core/userdetails/UserDetailsService.java
@@ -15,18 +15,20 @@
 
 package org.springframework.security.core.userdetails;
 
-import org.springframework.security.authentication.dao.DaoAuthenticationProvider;
-
 import org.springframework.dao.DataAccessException;
 
 
 /**
- * Defines an interface for implementations that wish to provide data access
- * services to the {@link DaoAuthenticationProvider}.
+ * Core interface which loads user-specific data.
+ * <p>
+ * It is used throughout the framework as a user DAO and is the strategy used by the
+ * {@link org.springframework.security.authentication.dao.DaoAuthenticationProvider DaoAuthenticationProvider}.
  *
  * <p>
- * The interface requires only one read-only method, which simplifies support
- * of new data access strategies.
+ * The interface requires only one read-only method, which simplifies support for new data-access strategies.
+ *
+ * @see org.springframework.security.authentication.dao.DaoAuthenticationProvider
+ * @see UserDetails
  *
  * @author Ben Alex
  * @version $Id$