Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/ThreadLocalData.java
===================================================================
--- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/ThreadLocalData.java	(revision 3472)
+++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/ThreadLocalData.java	(revision 3473)
@@ -24,7 +24,9 @@
 
 /**
- * Container for the {@link HttpServletRequest} and {@link Context}, to have static access to them
- * wherever you want. Both are stored as {@link ThreadLocal}s and therefore the are bound to the current thread.<br>
- *
+ * Maintains current {@link Context context} and {@link HttpServletRequest
+ * request} instances. This container relies on {@link ThreadLocal} and provides
+ * static access to the aforementioned objects for the current File Browse
+ * request. This means that this class is thread-safe.
+ * 
  * @version $Id$
  */
@@ -34,27 +36,38 @@
 	
 	/**
-	 * Initialization of the begin of each request cycle.
+	 * Initializes the current request cycle.
 	 * 
-	 * @param servletRequest
+	 * @param request
+	 *            current user request instance
 	 */
 	public static void beginRequest(final HttpServletRequest request) {
 		if (request == null)
-			throw new NullPointerException();
+			throw new NullPointerException("the request cannot be null");
 		ThreadLocalData.request.set(request);
 		ThreadLocalData.context.set(new Context(request));
 	}
 	
+	/**
+	 * Returns the current user request instance.
+	 * 
+	 * @return the current user request instance
+	 */
 	public static HttpServletRequest getRequest() {
 		return request.get();
 	}
-	
-	 public static Context getContext() {
-		 return context.get();
-	 }
+
+	/**
+	 * Returns the current context instance.
+	 * 
+	 * @return the current context instance
+	 */
+	public static Context getContext() {
+		return context.get();
+	}
 	
 	/**
-	 * Clear the ThreadLocals.<br>
-	 * <strong>Important: To prevent memory leaks we have to make sure that this
-	 * method is calling at the end of each request cycle!!!</strong>
+	 * Terminates the current request cycle. <br />
+	 * <strong>Important: To prevent memory leaks, make sure that this
+	 * method is called at the end of the current request cycle!</strong>
 	 */
 	public static void endRequest() {