Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/FCKeditor.java =================================================================== --- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/FCKeditor.java (revision 3593) +++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/FCKeditor.java (revision 3594) @@ -30,7 +30,11 @@ /** - * Java representation of the FCKeditor. This representation reflects the editor - * in an object-oriented way. It can be configured as any other JavaBean type - * class. The final output of this class is HTML code. + * Java representation of the FCKeditor. This representation reflects the editor in an + * object-oriented way. It can be configured as any other JavaBean type class. + * The final output of this class is HTML code.
+ * Note: It's your responsibility to supply reasonable and + * valid values, only {@code request} and {@code instanceName} will be checked + * for sanity. * * @version $Id$ @@ -54,8 +58,5 @@ * A constructors which handles basic FCKeditor initialization with a few * parameters. If you omit basic parameters, default ones will be taken from - * the properties file.
- * Note: It's your responsibility to supply reasonable and - * valid values, only request and instanceName - * will be checked. + * the {@link PropertiesLoader properties file}. * * @param request @@ -68,15 +69,12 @@ * the desired editor height (CSS-style value) * @param toolbarSet - * the desired toolbar set name. Supplying a non-existent set - * will make the editor fail. + * the desired toolbar set name * @param value - * the HTML markup of the editor document. Markup will be - * properly escaped. + * the HTML markup of this editor. Markup will be properly + * escaped. * @param basePath - * the base path of the editor, absolute to the context + * the base path of this editor, absolute to the context * @throws IllegalArgumentException - * if instanceName is not a valid XHTML id - * @throws IllegalArgumentException - * if instanceName is empty + * if instanceName is empty or not a valid XHTML id */ public FCKeditor(final HttpServletRequest request, @@ -103,10 +101,8 @@ * the unique name of this editor * @throws IllegalArgumentException - * if instanceName is not a valid HTML id - * @throws IllegalArgumentException - * if instanceName is empty + * if instanceName is empty or not a valid HTML id */ public FCKeditor(final HttpServletRequest request, final String instanceName) { - + if (request == null) throw new NullPointerException("the request cannot be null"); @@ -114,16 +110,14 @@ setInstanceName(instanceName); - - } - - /** - * Sets the unique name of the editor. + + } + + /** + * Sets the unique name of this editor. * * @param instanceName * the unique name of this editor * @throws IllegalArgumentException - * if instanceName is not a valid XHTML id - * @throws IllegalArgumentException - * if instanceName is empty + * if instanceName is empty or not a valid XHTML id */ public void setInstanceName(final String instanceName) { @@ -140,6 +134,6 @@ * * @param value - * the HTML markup of the editor document. Markup will be - * properly escaped. + * the HTML markup of this editor. Markup will be properly + * escaped. */ public void setValue(final String value) { @@ -148,9 +142,9 @@ /** - * Sets the base path of the editor. The base path reflects the location of + * Sets the base path of this editor. The base path reflects the location of * the editor files absolute to the context root not the server root. * * @param basePath - * the base path of the editor, absolute to the context + * the base path of this editor, absolute to the context */ public void setBasePath(final String basePath) { @@ -159,9 +153,8 @@ /** - * Set the name of the toolbar set to display. + * Sets the name of the toolbar set of this editor. * * @param toolbarSet - * the desired toolbar set name. Supplying a non-existent set - * will make the editor fail. + * the desired toolbar set name */ public void setToolbarSet(final String toolbarSet) { @@ -170,5 +163,5 @@ /** - * Sets the width of the editor. This value can be any valid CSS width + * Sets the width of this editor. This value can be any valid CSS width * value. * @@ -181,5 +174,5 @@ /** - * Sets the height of the editor. This value can be any valid CSS height + * Sets the height of this editor. This value can be any valid CSS height * value. * @@ -227,5 +220,5 @@ * the name of the config option (case-sensitive) * @param value - * the value of this config option. Null values will be ignored. + * the value of the config option. Null values will be ignored. */ public void setConfig(String name, String value) { @@ -329,5 +322,5 @@ if (Utils.isNotEmpty(toolbarSet)) editorLink.append("&Toolbar=").append(toolbarSet); - + XHtmlTagTool iframeTag = new XHtmlTagTool("iframe", XHtmlTagTool.SPACE); Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/FCKeditorConfig.java =================================================================== --- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/FCKeditorConfig.java (revision 3593) +++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/FCKeditorConfig.java (revision 3594) @@ -33,5 +33,6 @@ /** - * Java representation of the FCKConfig object from the editor. Every FCKeditor + * Java representation of the FCKConfig object from the editor. Every FCKeditor * instance will load the config.js by default, if you assign a * FCKConfig instance to an editor, it will automatically override these @@ -47,6 +48,5 @@ /** - * Generates the URL parameter sequence from this configuration which is - * passed to the editor. + * Generates the URL parameter sequence for this configuration. * * @return HTML-encoded sequence of configuration parameters Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/tags/CheckTag.java =================================================================== --- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/tags/CheckTag.java (revision 3593) +++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/tags/CheckTag.java (revision 3594) @@ -39,5 +39,6 @@ /** - * This tag displays information about browser and user capabilities.
+ * Displays information about browser and user capabilities. + *

* There are four available commands: *

    @@ -47,7 +48,6 @@ *
  1. GetResources
    2. *
- * - *
- * Each callout will emit a localized message (if available) about the command's + *

+ * Each call will emit a localized message (if available) about the command's * status. * Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/tags/ConfigTag.java =================================================================== --- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/tags/ConfigTag.java (revision 3593) +++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/tags/ConfigTag.java (revision 3594) @@ -29,10 +29,9 @@ import javax.servlet.jsp.tagext.TagSupport; +import net.fckeditor.FCKeditorConfig; + /** - * This tag sets configuration options for the surrounding editor tag. Provide - * any configuration option you want as described here. This tag utilizes the dynamic attribute features provided by the - * {@link DynamicAttributes} interface.
- * Attention: This tag can only be nested with an editor tag. + * Sets {@link FCKeditorConfig configuration options} in the surrounding editor + * tag only. * * @version $Id$ Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/tags/EditorTag.java =================================================================== --- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/tags/EditorTag.java (revision 3593) +++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/tags/EditorTag.java (revision 3594) @@ -34,5 +34,6 @@ /** - * This tag assembles and creates a FCKeditor instance. + * Tag creates and configures a {@link FCKeditor} instance. The setter methods + * are the same as in the FCKeditor class itself. * * @version $Id$ Index: /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/tags/package-info.java =================================================================== --- /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/tags/package-info.java (revision 3593) +++ /FCKeditor.Java/trunk/java-core/src/main/java/net/fckeditor/tags/package-info.java (revision 3594) @@ -1,4 +1,5 @@ /** - * JSP tags to access and modify the FCKeditor object. + * JSP tags to create and configure the {@link net.fckeditor.FCKeditor FCKeditor} + * object. */ package net.fckeditor.tags;