svn commit: r737344 - in /incubator/click/trunk/click: examples/src/org/apache/click/examples/control/cayenne/NestedCayenneForm.java framework/src/org/apache/click/control/Form.java framework/src/org/apache/click/util/ContainerUtils.java

[sa...@apache.org]

Author: sabob
Date: Sat Jan 24 12:20:14 2009
New Revision: 737344

URL: http://svn.apache.org/viewvc?rev=737344&view=rev
Log:
javadoc

Modified:
    incubator/click/trunk/click/examples/src/org/apache/click/examples/control/cayenne/NestedCayenneForm.java
    incubator/click/trunk/click/framework/src/org/apache/click/control/Form.java
    incubator/click/trunk/click/framework/src/org/apache/click/util/ContainerUtils.java

Modified: incubator/click/trunk/click/examples/src/org/apache/click/examples/control/cayenne/NestedCayenneForm.java
URL: http://svn.apache.org/viewvc/incubator/click/trunk/click/examples/src/org/apache/click/examples/control/cayenne/NestedCayenneForm.java?rev=737344&r1=737343&r2=737344&view=diff
==============================================================================
--- incubator/click/trunk/click/examples/src/org/apache/click/examples/control/cayenne/NestedCayenneForm.java (original)
+++ incubator/click/trunk/click/examples/src/org/apache/click/examples/control/cayenne/NestedCayenneForm.java Sat Jan 24 12:20:14 2009
@@ -64,7 +64,9 @@
     }
 
     /**
-     * Return the DataContext for this Form using the following heuristics:
+     * Return the DataContext for this Form.
+     *
+     * The following heuristics is applied:
      *
      * #1. return the dataObject DataContext if set
      * #2. return the {@link #nestedDataContext} instance if set

Modified: incubator/click/trunk/click/framework/src/org/apache/click/control/Form.java
URL: http://svn.apache.org/viewvc/incubator/click/trunk/click/framework/src/org/apache/click/control/Form.java?rev=737344&r1=737343&r2=737344&view=diff
==============================================================================
--- incubator/click/trunk/click/framework/src/org/apache/click/control/Form.java (original)
+++ incubator/click/trunk/click/framework/src/org/apache/click/control/Form.java Sat Jan 24 12:20:14 2009
@@ -172,18 +172,19 @@
  * request is made the form will validate the field values. To disable
  * automatic validation set {@link #setValidate(boolean)} to false.
  * <p/>
- * Form {@link #validate()} method provides special validation for multipart requests.
- * Multipart requests are used when uploading files from the client.
+ * <b>File Upload Validation</b>
  * <p/>
+ * Form {@link #validate()} method provides special validation for multipart requests
+ * (multipart requests are used for when files are uploaded from the browser).
  * The {@link #validate()} method checks that files being uploaded do not exceed the
  * {@link org.apache.click.service.CommonsFileUploadService#sizeMax maximum request size}
  * or the {@link org.apache.click.service.CommonsFileUploadService#fileSizeMax maximum file size}.
  * <p/>
- * <b>Please note</b> that if the <tt>maximum request size</tt> or <tt>maximum file size</tt>
- * is exceeded, the request is deemed {@link #hasPostError invalid} and no further
- * processing is performed on the form or fields. Instead the form will display
- * the appropriate error message for the invalid request. See {@link #validate()}
- * for details of the error message properties.
+ * <b>Note:</b> if the <tt>maximum request size</tt> or <tt>maximum file size</tt>
+ * is exceeded, the request is deemed invalid ({@link #hasPostError hasPostError}
+ * will return true), and no further processing is performed on the form or fields.
+ * Instead the form will display the appropriate error message for the invalid request.
+ * See {@link #validate()} for details of the error message properties.
  * <p/>
  * <b>JavaScript Validation</b>
  * <p/>

Modified: incubator/click/trunk/click/framework/src/org/apache/click/util/ContainerUtils.java
URL: http://svn.apache.org/viewvc/incubator/click/trunk/click/framework/src/org/apache/click/util/ContainerUtils.java?rev=737344&r1=737343&r2=737344&view=diff
==============================================================================
--- incubator/click/trunk/click/framework/src/org/apache/click/util/ContainerUtils.java (original)
+++ incubator/click/trunk/click/framework/src/org/apache/click/util/ContainerUtils.java Sat Jan 24 12:20:14 2009
@@ -79,7 +79,7 @@
     }
 
     /**
-     * Return the list of input Fields (TextField, Select, Radio, Checkbox etc.)
+     * Return the list of input Fields (TextField, Select, Radio, Checkbox etc).
      * for the given Container, recursively including any Fields contained in
      * child containers. The list of returned fields will exclude any
      * <tt>Button</tt>, <tt>FieldSet</tt> and <tt>Label</tt> fields.