Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/connector/Connector.java
===================================================================
--- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/connector/Connector.java	(revision 3762)
+++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/connector/Connector.java	(revision 3763)
@@ -38,6 +38,7 @@
 
 /**
- * Backend interface of the File Browser. A connector serves and manages files
- * and folders accessed through the file manager on an arbitrary backend system.<br />
+ * Backend interface of a File Browser connector. A connector serves and manages
+ * files and folders accessed through the File Browser on an arbitrary backend
+ * system.<br />
  * The connector will receive a request if, and only if, the request was valid
  * in terms of valid and reasonable parameters up to an abstract point which is
@@ -48,5 +49,5 @@
  * <li>If you need to access the request instance itself and/or the context
  * parameters sent from the File Browser, take a look at the
- * {@link ThreadLocalData} object.</li>
+ * {@link ThreadLocalData} class.</li>
  * <li>Use
  * {@link RequestCycleHandler#getUserFilesAbsolutePath(javax.servlet.http.HttpServletRequest)
@@ -74,8 +75,7 @@
 	 * @param servletContext
 	 *            reference to the {@link ServletContext} in which the caller is
-	 *            executing
+	 *            running
 	 * @throws Exception
-	 *             if an exception occurs that interrupts the connector's normal
-	 *             operation
+	 *             if the connector initialization fails due to some reason
 	 */
 	public void init(final ServletContext servletContext) throws Exception;
Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/connector/Dispatcher.java
===================================================================
--- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/connector/Dispatcher.java	(revision 3762)
+++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/connector/Dispatcher.java	(revision 3763)
@@ -55,10 +55,10 @@
 
 /**
- * File browser request dispatcher. This class is the validating instance
- * between the {@link ConnectorServlet connector servlet} and a
+ * File Browser request dispatcher. This class is the validating and managing
+ * instance between the {@link ConnectorServlet connector servlet} and the
  * {@link Connector connector}. It receives the requests, parses the parameters,
  * validates/sanitizes them and mandates them to the connector. After the
- * connector has processed the requests, this dispatcher passes the response
- * back to the connector servlet. More over, it intercepts all
+ * connector has processed the request, this dispatcher passes the response back
+ * to the connector servlet. More over, it intercepts all
  * {@link net.fckeditor.connector.exception specified exceptions} from the
  * connector and emits appropriate messages to the user.
@@ -77,8 +77,7 @@
 	 * @param servletContext
 	 *            reference to the {@link ServletContext} in which the caller is
-	 *            executing
+	 *            running
 	 * @throws Exception
-	 *             if an exception occurs that interrupts the dispatcher's
-	 *             normal operation
+	 *             if the dispatcher initialization fails due to some reason
 	 */
 	Dispatcher(final ServletContext servletContext) throws Exception {