Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/localization/LocaleResolver.java
===================================================================
--- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/localization/LocaleResolver.java	(revision 3433)
+++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/localization/LocaleResolver.java	(revision 3434)
@@ -35,9 +35,10 @@
 
 	/**
+	 * Returns the locale of a give request.
 	 * 
 	 * @param request
-	 *            The current request instance.
-	 * @return The locale of the user or <code>null</code> if the locale
-	 *         cannot be resolved.
+	 *            the current request instance
+	 * @return the locale of the request, <code>null</code> if the locale
+	 *         couldn't be resolved
 	 */
 	public Locale resolveLocale(final HttpServletRequest request);
Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/localization/impl/AcceptLanguageHeaderResolver.java
===================================================================
--- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/localization/impl/AcceptLanguageHeaderResolver.java	(revision 3433)
+++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/localization/impl/AcceptLanguageHeaderResolver.java	(revision 3434)
@@ -30,10 +30,8 @@
 
 /**
- * This implementation simply returns the user locale with
- * {@link ServletRequest#getLocale()} but it has an advantage over the named
- * method. If the <code>Accept-Language</code> header is empty, the default
- * server locale will be returned. This behavior is undesired and can lead to
- * wrong localized messages. Instead, this implementation will only return the
- * locale if the header is not empty.
+ * Resolves the current user locale by calling
+ * {@link ServletRequest#getLocale()}. This method is somewhat superior to the
+ * <code>getLocale</code> method because it returns a locale if and only if the
+ * <code>Accept-Language</code> header is not empty.
  * 
  * @version $Id$
@@ -42,9 +40,4 @@
 public class AcceptLanguageHeaderResolver implements LocaleResolver {
 
-	/*
-	 * (non-Javadoc)
-	 * 
-	 * @see net.fckeditor.localization.LocaleResolver#resolveLocale(javax.servlet.http.HttpServletRequest)
-	 */
 	public Locale resolveLocale(final HttpServletRequest request) {
 
Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/localization/impl/JstlResolver.java
===================================================================
--- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/localization/impl/JstlResolver.java	(revision 3433)
+++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/localization/impl/JstlResolver.java	(revision 3434)
@@ -29,5 +29,5 @@
 
 /**
- * This implementation maps directly to the JSTL locale mechanism. This is
+ * Resolves the current user locale against JSTL/FMT session locale. This is
  * recommended for those who use FMT tags for example.
  * 
@@ -41,8 +41,4 @@
 	}
 
-	/*
-	 * (non-Javadoc)
-	 * @see net.fckeditor.localization.LocaleResolver#resolveLocale(javax.servlet.http.HttpServletRequest)
-	 */
 	public Locale resolveLocale(final HttpServletRequest request) {