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 3522)
+++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/localization/LocaleResolver.java	(revision 3523)
@@ -35,5 +35,5 @@
 
 	/**
-	 * Returns the locale of a give request.
+	 * Returns the locale of a given request.
 	 * 
 	 * @param request
Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/UserAction.java
===================================================================
--- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/UserAction.java	(revision 3522)
+++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/UserAction.java	(revision 3523)
@@ -23,17 +23,14 @@
 import javax.servlet.http.HttpServletRequest;
 
-
+import net.fckeditor.handlers.Command;
 
 /**
- * An interface which provides the authorization of server-side commands.<br />
- * The commands are:
- * <ul>
- * <li>{@link #isEnabledForFileBrowsing()}: Enables the user
- * to browse/select files.</li>
- * <li>{@link #isEnabledForFileUpload()}: Enables the user
- * to upload files.</li>
- * <li>{@link #isEnabledForFolderCreation()} Enables the user
- * to create folders.</li>
- * </ul>
+ * An interface for user rights management. In particular, this interface gives
+ * you fine-grained control over the File Browser {@link Command commands}.
+ * <p>
+ * You are free to implement this interface the way you need it, in other words
+ * your return values can be global regardless of the request or on a
+ * per-request basis.
+ * </p>
  * 
  * @version $Id$
@@ -42,25 +39,39 @@
 
 	/**
-	 * Authenticates/enables the current user for uploading files.<br />
+	 * Checks if file upload is enabled/allowed. This method maps to
+	 * {@link Command#FILE_UPLOAD FileUpload} and {@link Command#QUICK_UPLOAD
+	 * QuickUpload}.<br />
+	 * <strong>Note:</strong> This method may be renamed to {@code
+	 * isFileUploadEnabled} in future versions.
 	 * 
-	 * @return <code>true</code> if user can upload to the server, or
-	 *         <code>false</code>
+	 * @param request
+	 *            current user request instance
+	 * @return {@code true} if file upload is enabled/allowed, else {@code
+	 *         false}
 	 */
 	public boolean isEnabledForFileUpload(final HttpServletRequest request);
 
 	/**
-	 * Authenticates/enables the current user for browsing files.<br />
+	 * Checks if resource retrieval/listing is enabled/allowed. This method maps
+	 * to {@link Command#GET_FOLDERS GetFolders} and
+	 * {@link Command#GET_FOLDERS_AND_FILES GetFoldersAndFiles}.<br />
+	 * <strong>Note:</strong> This method may be renamed to {@code
+	 * isGetResourcesEnabled} in future versions.
 	 * 
-	 * @return <code>true</code> if user can browse the server, or
-	 *         <code>false</code>
+	 * @param request
+	 *            current user request instance
+	 * @return {@code true} if resource retrieval/listing is enabled/allowed,
+	 *         else {@code false}
 	 */
 	public boolean isEnabledForFileBrowsing(final HttpServletRequest request);
-	
 
 	/**
-	 * Authenticates/enables the current user to create folders.<br />
+	 * Checks if folder creation is enabled/allowed. This method maps to
+	 * {@link Command#CREATE_FOLDER CreateFolder}.
 	 * 
-	 * @return <code>true</code> if user can create folders on the server, or
-	 *         <code>false</code>
+	 * @param request
+	 *            current user request instance
+	 * @return {@code true} if folder creation is enabled/allowed, else {@code
+	 *         false}
 	 */
 	public boolean isCreateFolderEnabled(final HttpServletRequest request);
Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/UserPathBuilder.java
===================================================================
--- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/UserPathBuilder.java	(revision 3522)
+++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/UserPathBuilder.java	(revision 3523)
@@ -23,9 +23,15 @@
 import javax.servlet.http.HttpServletRequest;
 
-import net.fckeditor.handlers.ConnectorHandler;
-
 /**
- * An interface which provides a way to build a user-dependent
- * <code>UserFilesPath</code>.
+ * An interface for userfiles path construction. In particular, this interface
+ * gives you the ability to construct the {@code connector.userFilesPath} and
+ * {@code connector.userFilesAbsolutePath} properties dynamically. See <a
+ * href="http://java.fckeditor.net/properties.html">configuration</a> for more
+ * details.
+ * <p>
+ * You are free to implement this interface the way you need it, in other words
+ * your return values can be global regardless of the request or on a
+ * per-request basis.
+ * </p>
  * 
  * @version $Id$
@@ -34,27 +40,24 @@
 
 	/**
-	 * Path needed to map resources to paths outside context of your webapp.
-	 * If the implementation don't bother you, just return <code>null</code>.
+	 * Returns the constructed server-side userfiles absolute path. This method
+	 * is the dynamic constructor of the {@code connector.userFilesAbsolutePath}
+	 * property. A concrete connector implementation will use this value to
+	 * resolve the server-side location of resources.
 	 * 
-	 * @return local path
+	 * @param request
+	 *            current user request instance
+	 * @return the constructed server-side userfiles absolute path
 	 */
 	public String getUserFilesAbsolutePath(final HttpServletRequest request);
-	
+
 	/**
-	 * Getter for the user-dependent <code>UserFilesPath</code>.<br />
-	 * <strong>Important:</strong>
-	 * <ul>
-	 * <li> If the implementation returns <code>null</code>,
-	 * {@link ConnectorHandler} will used the default one! That's useful, if the
-	 * implementation doesn't bother you.</li>
-	 * <li>The returned directory string has to start with '/', but has to end
-	 * without '/'.</li>
-	 * <li>The path has to be within the context.</li>
-	 * </ul>
-	 * <strong>If your implementation needs {@link HttpServletRequest} e.g. to get a
-	 * session variable, you can get it by calling {@link ThreadLocalData#getRequest()}. </strong>
+	 * Returns the constructed client-side userfiles path. This method is the
+	 * dynamic constructor of the {@code connector.userFilesPath} property. A
+	 * browser will use this value to resolve the url-side location of resources
+	 * on the server.
 	 * 
 	 * @param request
-	 * @return <code>UserFilesPath</code> for the current user.
+	 *            current user request instance
+	 * @return the constructed client-side userfiles path
 	 */
 	public String getUserFilesPath(final HttpServletRequest request);
Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/impl/ContextPathBuilder.java
===================================================================
--- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/impl/ContextPathBuilder.java	(revision 3522)
+++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/impl/ContextPathBuilder.java	(revision 3523)
@@ -24,17 +24,13 @@
 
 /**
- * This implementation always returns the context path with the UserFilesPath
- * from the properties file.
+ * UserPathBuilder implementation that always return static {@code
+ * connector.userFiles*Path} properties with prepended current context path. In
+ * particular this implementation will prepend the context path to
+ * {@link #getUserFilesPath(HttpServletRequest)} only.
  * 
  * @version $Id$
- * 
  */
 public class ContextPathBuilder extends ServerRootPathBuilder {
 
-	/*
-	 * (non-Javadoc)
-	 * 
-	 * @see net.fckeditor.requestcycle.UserPathBuilder#getUserFilesPath()
-	 */
 	public String getUserFilesPath(final HttpServletRequest request) {
 		return request.getContextPath().concat(super.getUserFilesPath(request));
Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/impl/DisabledUserAction.java
===================================================================
--- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/impl/DisabledUserAction.java	(revision 3522)
+++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/impl/DisabledUserAction.java	(revision 3523)
@@ -27,6 +27,5 @@
 
 /**
- * Standard implementation for {@link UserAction}. It always returns
- * <code>false</code>.
+ * UserAction implementation that always returns {@code false}.
  * 
  * @version $Id$
@@ -34,24 +33,12 @@
 public class DisabledUserAction implements UserAction {
 
-	/*
-	 * (non-Javadoc)
-	 * @see net.fckeditor.requestcycle.UserAction#isEnabledForFileBrowsing()
-	 */
 	public boolean isEnabledForFileBrowsing(final HttpServletRequest request) {
 		return false;
 	}
 
-	/*
-	 * (non-Javadoc)
-	 * @see net.fckeditor.requestcycle.UserAction#isEnabledForFileUpload()
-	 */
 	public boolean isEnabledForFileUpload(final HttpServletRequest request) {
 		return false;
 	}
 
-	/*
-	 * (non-Javadoc)
-	 * @see net.fckeditor.requestcycle.UserAction#isEnabledForFolderCreation()
-	 */
 	public boolean isCreateFolderEnabled(final HttpServletRequest request) {
 		return false;
Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/impl/EnabledUserAction.java
===================================================================
--- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/impl/EnabledUserAction.java	(revision 3522)
+++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/impl/EnabledUserAction.java	(revision 3523)
@@ -27,6 +27,5 @@
 
 /**
- * Standard implementation for {@link UserAction}. It always returns
- * <code>true</code>.
+ * UserAction implementation that always returns {@code true}.
  * 
  * @version $Id$
@@ -34,24 +33,12 @@
 public class EnabledUserAction implements UserAction {
 
-	/*
-	 * (non-Javadoc)
-	 * @see net.fckeditor.requestcycle.UserAction#isEnabledForFileBrowsing()
-	 */
 	public boolean isEnabledForFileBrowsing(final HttpServletRequest request) {
 		return true;
 	}
 
-	/*
-	 * (non-Javadoc)
-	 * @see net.fckeditor.requestcycle.UserAction#isEnabledForFileUpload()
-	 */
 	public boolean isEnabledForFileUpload(final HttpServletRequest request) {
 		return true;
 	}
 
-	/*
-	 * (non-Javadoc)
-	 * @see net.fckeditor.requestcycle.UserAction#isEnabledForFolderCreation()
-	 */
 	public boolean isCreateFolderEnabled(final HttpServletRequest request) {
 		return true;
Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/impl/ServerRootPathBuilder.java
===================================================================
--- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/impl/ServerRootPathBuilder.java	(revision 3522)
+++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/requestcycle/impl/ServerRootPathBuilder.java	(revision 3523)
@@ -7,30 +7,15 @@
 
 /**
- * This implementation always returns the UserFilesPath from the properties file
- * absolute to the server root URL.
+ * UserPathBuilder implementation that always return static {@code
+ * connector.userFiles*Path} properties as-is.
  * 
  * @version $Id$
- * 
  */
 public class ServerRootPathBuilder implements UserPathBuilder {
 
-	/*
-	 * (non-Javadoc)
-	 * 
-	 * @see
-	 * net.fckeditor.requestcycle.UserPathBuilder#getUserFilesAbsolutePath(javax
-	 * .servlet.http.HttpServletRequest)
-	 */
 	public String getUserFilesAbsolutePath(final HttpServletRequest request) {
 		return PropertiesLoader.getUserFilesAbsolutePath();
 	}
 
-	/*
-	 * (non-Javadoc)
-	 * 
-	 * @see
-	 * net.fckeditor.requestcycle.UserPathBuilder#getUserFilesPath(javax.servlet
-	 * .http.HttpServletRequest)
-	 */
 	public String getUserFilesPath(final HttpServletRequest request) {
 		return PropertiesLoader.getUserFilesPath();