[seam-commits] Seam SVN: r15186 - in branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui: component and 4 other directories.

seam-commits at lists.jboss.org seam-commits at lists.jboss.org
Wed Oct 3 05:49:23 EDT 2012 

Author: manaRH
Date: 2012-10-03 05:49:22 -0400 (Wed, 03 Oct 2012)
New Revision: 15186

Modified:
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/DocumentStoreUtils.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIAction.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UICache.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIConversationId.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIConversationPropagation.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDecorate.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDecorateAware.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDefaultAction.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDownload.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIEnumItem.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIEqualityValidator.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFileUpload.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFormattedText.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFragment.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UILabel.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UILink.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIMessage.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIResource.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISeamCommandBase.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISelectItems.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISelection.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISpan.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIStyle.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UITaskId.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIValidateAll.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicBooleanConverter.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicIntegerConverter.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicLongConverter.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/DateTimeConverter.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/EnumConverter.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/NoSelectionConverter.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/GraphicImageRendererBase.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UIGraphicImage.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageBlur.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageSize.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageType.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/handler/CommandButtonParameterComponentHandler.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/handler/DecorateHandler.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/validator/EqualityValidator.java
   branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/validator/ModelValidator.java
Log:
JBSEAM-4958

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/DocumentStoreUtils.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/DocumentStoreUtils.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/DocumentStoreUtils.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -19,6 +19,12 @@
 import org.jboss.seam.navigation.Pages;
 import org.jboss.seam.ui.component.UIResource;
 
+/**
+ * Helper class for DocumentStore 
+ * 
+ * @author mnovotny
+ *
+ */
 public class DocumentStoreUtils
 {
     private static final int BUFFER_SIZE = 32768;

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIAction.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIAction.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIAction.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -27,7 +27,7 @@
 import org.jboss.seam.navigation.Pages;
 import org.jboss.seam.navigation.SafeActions;
 
-/*
+/**
  * This is a support component and is not processed by the CDK (doesn't appear in faces-config)
  *
  */

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UICache.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UICache.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UICache.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -32,7 +32,7 @@
 
 
 /**
- * JSF component class
+ * JSF component class for Seam UICache
  * 
  */
 @JsfComponent(description=@Description(displayName="org.jboss.seam.ui.Cache",value="Cache the rendered page fragment using the installed cache provider."),

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIConversationId.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIConversationId.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIConversationId.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -35,10 +35,10 @@
 
 
 /**
- * JSF component class
+ * JSF component class which addd the conversation id to JSF link or button (e.g. <h:commandLink/>, <s:button/>)
  *
  */
- at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.ConversationId",value="Add the conversation id to JSF link or button (e.g. <h:commandLink />, <s:button />)."),
+ at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.ConversationId",value="Add the conversation id to JSF link or button (e.g. &lt;h:commandLink/&gt;, &lt;s:button/&gt;)."),
 family="org.jboss.seam.ui.ConversationId", type="org.jboss.seam.ui.ConversationId",generate="org.jboss.seam.ui.component.html.HtmlConversationId", 
 tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="conversationId"),
 attributes = {"javax.faces.component.UIParameter.xml", "conversationId.xml"})

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIConversationPropagation.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIConversationPropagation.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIConversationPropagation.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -31,7 +31,8 @@
 import org.richfaces.cdk.annotations.Tag;
 
 /**
- * JSF component class
+ * JSF component class for customization of the conversation propagation in a command link or a button
+ * 
  *
  */
 @JsfComponent(description=@Description(displayName="org.jboss.seam.ui.ConversationPropagation",value="Customize the conversation propagation for a command link or button (or similar JSF control)."),

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDecorate.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDecorate.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDecorate.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -13,6 +13,11 @@
 import org.richfaces.cdk.annotations.Tag;
 
 
+/**
+ * "Decorates" a JSF input field when validation fails or when required="true" is set
+ * @author mnovotny
+ *
+ */
 @JsfComponent(description=@Description(displayName="org.jboss.seam.ui.Decorate",value="\"Decorate\" a JSF input field when validation fails or when required=\"true\" is set."),
 family="org.jboss.seam.ui.Decorate", type="org.jboss.seam.ui.Decorate",generate="org.jboss.seam.ui.component.html.HtmlDecorate", 
 tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="decorate", handler="org.jboss.seam.ui.handler.DecorateHandler"), 

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDecorateAware.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDecorateAware.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDecorateAware.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -3,7 +3,8 @@
 /**
  * Component that is aware of being used from a facet by s:decorate
  */
-public interface UIDecorateAware {
+public interface UIDecorateAware 
+{
     /**
     * Method called by DecorateRendererBase when it's about to render a subtree containing this component.
     */

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDefaultAction.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDefaultAction.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDefaultAction.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -11,10 +11,12 @@
 import org.richfaces.cdk.annotations.Tag;
 
 /**
+ * Simulates pressing the action source when 'enter' is pressed
+ * 
  * @author mnovotny
  *
  */
- at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.DefaultAction",value="Simulate pressing the action source when 'enter' is pressed."),
+ at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.DefaultAction",value="Simulates pressing the action source when 'enter' is pressed."),
 family="org.jboss.seam.ui.DefaultAction", type="org.jboss.seam.ui.DefaultAction",generate="org.jboss.seam.ui.component.html.HtmlDefaultAction", 
 tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="defaultAction"),
 renderer = @JsfRenderer(type="org.jboss.seam.ui.DefaultActionRenderer", family="org.jboss.seam.ui.DefaultActionRenderer"))

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDownload.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDownload.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDownload.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -7,11 +7,12 @@
 import org.richfaces.cdk.annotations.Tag;
 
 /**
+ * JSF Component for Link which is able to download a file
  * 
  * @author Daniel Roth
  * 
  */
- at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.Download",value="Link for downloading a file"),
+ at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.Download",value="JSF Component for Link which is able to download a file"),
 family="org.jboss.seam.ui.Download", type="org.jboss.seam.ui.Download",generate="org.jboss.seam.ui.component.html.HtmlDownload", 
 tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="download"), 
 renderer = @JsfRenderer(type="org.jboss.seam.ui.DownloadRenderer", family="org.jboss.seam.ui.DownloadRenderer"),

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIEnumItem.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIEnumItem.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIEnumItem.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -10,7 +10,7 @@
 import org.richfaces.cdk.annotations.Tag;
 
 /**
- * JSF component class
+ * JSF component class for creating SelectItem from an enum value
  * 
  */
 @JsfComponent(description=@Description(displayName="org.jboss.seam.ui.EnumItem",value="Creates a SelectItem from an enum value."),

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIEqualityValidator.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIEqualityValidator.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIEqualityValidator.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -9,7 +9,7 @@
 import org.richfaces.cdk.annotations.Tag;
 
 /**
- * UIComponent for validator 
+ * JSF Component for validation of all child JSF input fields against the bound properties using Bean Validation 
  * 
  * @author Daniel Roth
  */

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFileUpload.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFileUpload.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFileUpload.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -15,7 +15,8 @@
 import org.richfaces.cdk.annotations.Tag;
 
 /**
- * JSF component class
+ * JSF component class which renders a file upload control. 
+ * This control must be used within a form with an encoding type of multipart/form-data
  * 
  */
 @JsfComponent(description=@Description(displayName="org.jboss.seam.ui.FileUpload",value="Renders a file upload control. This control must be used within a form with an encoding type of multipart/form-data"),

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFormattedText.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFormattedText.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFormattedText.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -39,10 +39,10 @@
 import antlr.RecognitionException;
 
 /**
- * JSF component class
+ * JSF component class which outputs Seam Text. Parse errors generate WARN level log messages.
  *
  */
- at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.FormattedText",value="Output Seam Text. Parse errors generate WARN level log messages."),
+ at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.FormattedText",value="Outputs Seam Text. Parse errors generate WARN level log messages."),
 family="org.jboss.seam.ui.FormattedText", type="org.jboss.seam.ui.FormattedText",generate="org.jboss.seam.ui.component.html.HtmlFormattedText", 
 tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="formattedText"),
 renderer = @JsfRenderer(type="org.jboss.seam.ui.FormattedTextRenderer", family="org.jboss.seam.ui.FormattedTextRenderer"),

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFragment.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFragment.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFragment.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -30,7 +30,7 @@
 import org.richfaces.cdk.annotations.Tag;
 
 /**
- * JSF component class
+ * JSF component class which surrounds a page fragment and allows you to apply render/not render without any html output
  *
  */
 @JsfComponent(description=@Description(displayName="org.jboss.seam.ui.Fragment",value="Surround a page fragment, allows you to apply render/not render without any html output."),

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UILabel.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UILabel.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UILabel.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -8,7 +8,13 @@
 import org.richfaces.cdk.annotations.JsfComponent;
 import org.richfaces.cdk.annotations.Tag;
 
- at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.Label",value="A label associated with the nearest JSF input component"),
+/**
+ * JSF Component which renders a label associated with the nearest JSF input component
+ * 
+ * @author mnovotny
+ *
+ */
+ at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.Label",value="A label associated with the nearest JSF input component."),
 family="javax.faces.Output", type="org.jboss.seam.ui.Label",generate="org.jboss.seam.ui.component.html.HtmlLabel", 
 tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="label"), 
 attributes = {"label.xml" })

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UILink.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UILink.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UILink.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -29,7 +29,8 @@
 
 
 /**
- * JSF component class
+ * JSF component class which renders a link that supports invocation of an action with control over conversation propagation. 
+ * It does not submit the form.
  *
  */
 @JsfComponent(description=@Description(displayName="org.jboss.seam.ui.Link",value="A link that supports invocation of an action with control over conversation propagation. Does not submit the form."),

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIMessage.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIMessage.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIMessage.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -30,7 +30,8 @@
 import org.richfaces.cdk.annotations.Tag;
 
 /**
- * JSF component class
+ * 
+ * JSF component class which decorates a JSF input field with the validation error message.
  *
  */
 @JsfComponent(description=@Description(displayName="org.jboss.seam.ui.Message",value="Decorate a JSF input field with the validation error message."),

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIResource.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIResource.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIResource.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -13,6 +13,8 @@
 import org.richfaces.cdk.annotations.Tag;
 
 /**
+ * JSF Component which can use a data in form as inputstream, 
+ * java.util.File or byte[] and a content-type, this tag sends the data to the browser
  * @author Daniel Roth
  */
 @JsfComponent(description=@Description(displayName="org.jboss.seam.ui.Resource",value="Given a data in form of an inputstream, java.util.File or byte[] and a content-type, this tag sends the data to the browser"),

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISeamCommandBase.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISeamCommandBase.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISeamCommandBase.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -20,8 +20,13 @@
 import org.jboss.seam.core.PropagationType;
 import org.jboss.seam.navigation.Pages;
 import org.jboss.seam.ui.util.ViewUrlBuilder;
-import org.jboss.seam.ui.util.cdk.MethodBindingToMethodExpression;
 
+/**
+ * Parent of all Seam command like JSF components 
+ * 
+ * @author mnovotny
+ *
+ */
 public abstract class UISeamCommandBase extends UIOutput implements ActionSource2
 {
 

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISelectItems.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISelectItems.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISelectItems.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -23,7 +23,9 @@
 
 
 /**
- * @auth Pete Muir
+ * JSF Component which creates a List<SelectItem> from a List, Set, DataModel or Array.
+ * 
+ * @author Pete Muir
  *
  */
 @JsfComponent(description=@Description(displayName="org.jboss.seam.ui.SelectItems",value="Creates a List<SelectItem> from a List, Set, DataModel or Array."),

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISelection.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISelection.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISelection.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -32,10 +32,10 @@
 import org.richfaces.cdk.annotations.Tag;
 
 /**
- * JSF component class
+ * JSF component class which inserts a parameter that can be bound to a data model
  *
  */
- at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.Selection", value=""),
+ at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.Selection", value="It inserts a parameter that can be bound to a data model"),
 family="org.jboss.seam.ui.Selection", type="org.jboss.seam.ui.Selection",generate="org.jboss.seam.ui.component.html.HtmlSelection", 
 tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="selection"),
 attributes = {"selection.xml" })

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISpan.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISpan.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISpan.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -6,7 +6,12 @@
 import org.richfaces.cdk.annotations.JsfRenderer;
 import org.richfaces.cdk.annotations.Tag;
 
- at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.Span",value="Render a HTML <span>"),
+/**
+ * Renders a HTML &lt;span&gt;
+ * @author mnovotny
+ *
+ */
+ at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.Span",value="Render a HTML &lt;span&gt;"),
 family="org.jboss.seam.ui.Span", type="org.jboss.seam.ui.Span",generate="org.jboss.seam.ui.component.html.HtmlSpan", 
 tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="span"), 
 renderer = @JsfRenderer(type="org.jboss.seam.ui.SpanRenderer", family="org.jboss.seam.ui.SpanRenderer"),

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIStyle.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIStyle.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIStyle.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -8,7 +8,12 @@
 import org.richfaces.cdk.annotations.JsfRenderer;
 import org.richfaces.cdk.annotations.Tag;
 
- at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.Div",value="<![CDATA[Render a HTML <div>.]]>"),
+/**
+ * JSF Component which renders a HTML &lt;div&gt;
+ * @author mnovotny
+ *
+ */
+ at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.Div",value="Render a HTML &lt;div&gt;"),
 family="org.jboss.seam.ui.Div", type="org.jboss.seam.ui.Div",generate="org.jboss.seam.ui.component.html.HtmlDiv", 
 tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="div"), 
 renderer = @JsfRenderer(type="org.jboss.seam.ui.DivRenderer", family="org.jboss.seam.ui.DivRenderer"))

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UITaskId.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UITaskId.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UITaskId.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -31,7 +31,7 @@
 import org.richfaces.cdk.annotations.Tag;
 
 /**
- * JSF component class
+ * JSF component class for adding of task id to an output link (or similar JSF control), when the task is available via #{task}.
  *
  */
 @JsfComponent(description=@Description(displayName="org.jboss.seam.ui.TaskId",value="Add the task id to an output link (or similar JSF control), when the task is available via #{task}."),

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIValidateAll.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIValidateAll.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIValidateAll.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -8,10 +8,10 @@
 import org.richfaces.cdk.annotations.Tag;
 
 /**
- * JSF component class
+ * JSF component class which validates all child JSF input fields against the bound properties using Bean validation 
  * 
  */
- at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.ValidateAll",value="<![CDATA[Validate all child JSF input fields against the bound propertys using Hibernate Validator.]]>"),
+ at JsfComponent(description=@Description(displayName="org.jboss.seam.ui.ValidateAll",value="Validate all child JSF input fields against the bound propertys using Hibernate Validator."),
 family="org.jboss.seam.ui.ValidateAll", type="org.jboss.seam.ui.ValidateAll",generate="org.jboss.seam.ui.component.html.HtmlValidateAll", 
 tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="validateAll"), 
 renderer = @JsfRenderer(type="org.jboss.seam.ui.ValidateAllRenderer", family="org.jboss.seam.ui.ValidateAllRenderer"))

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicBooleanConverter.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicBooleanConverter.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicBooleanConverter.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -10,6 +10,7 @@
 import javax.faces.convert.FacesConverter;
 
 /**
+ * Converter for java.util.concurrent.atomic.AtomicBoolean 
  * @author Dennis Byrne
  */
 @FacesConverter(value="org.jboss.seam.ui.AtomicBooleanConverter")

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicIntegerConverter.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicIntegerConverter.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicIntegerConverter.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -9,6 +9,7 @@
 import javax.faces.convert.FacesConverter;
 
 /**
+ *  Converter for java.util.concurrent.atomic.AtomicInteger
  * @author Dennis Byrne
  */
 @FacesConverter(value="org.jboss.seam.ui.AtomicIntegerConverter")

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicLongConverter.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicLongConverter.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicLongConverter.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -9,6 +9,8 @@
 import javax.faces.convert.FacesConverter;
 
 /**
+ *  Converter for java.util.concurrent.atomic.AtomicLong
+ * 
  * @author Dennis Byrne
  */
 @FacesConverter(value="org.jboss.seam.ui.AtomicLongConverter")

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/DateTimeConverter.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/DateTimeConverter.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/DateTimeConverter.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -26,7 +26,12 @@
 import javax.faces.convert.FacesConverter;
 
 import org.jboss.seam.contexts.Contexts;
-
+/**
+ *  Extended DateTimeConverter which set Timezone from Seam web application config
+ * 
+ * @author mnovotny
+ *
+ */
 @FacesConverter("org.jboss.seam.ui.DateTimeConverter")
 public class DateTimeConverter extends javax.faces.convert.DateTimeConverter{
 	

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/EnumConverter.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/EnumConverter.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/EnumConverter.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -8,6 +8,12 @@
 import javax.faces.convert.ConverterException;
 import javax.faces.convert.FacesConverter;
 
+/**
+ * Converter for Enums
+ * 
+ * @author mnovotny
+ *
+ */
 @FacesConverter(value="org.jboss.seam.ui.EnumConverter")
 public class EnumConverter implements javax.faces.convert.Converter
 {

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/NoSelectionConverter.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/NoSelectionConverter.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/NoSelectionConverter.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -6,6 +6,12 @@
 import javax.faces.convert.ConverterException;
 import javax.faces.convert.FacesConverter;
 
+/**
+ * Converter for no selection value item  
+ * 
+ * @author mnovotny
+ *
+ */
 @FacesConverter(value="org.jboss.sema.ui.NoSelectionConverter")
 public class NoSelectionConverter implements Converter
 {

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/GraphicImageRendererBase.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/GraphicImageRendererBase.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/GraphicImageRendererBase.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -11,6 +11,12 @@
 import org.jboss.seam.ui.util.cdk.RendererBase;
 import org.richfaces.cdk.annotations.JsfRenderer;
 
+/**
+ * Renderer for image based components
+ * 
+ * @author mnovotny
+ *
+ */
 @JsfRenderer(type="org.jboss.seam.ui.graphicImage.GraphicImageRenderer", family="org.jboss.seam.ui.GraphicImageRenderer")
 public class GraphicImageRendererBase extends RendererBase
 {

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UIGraphicImage.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UIGraphicImage.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UIGraphicImage.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -8,6 +8,11 @@
 import org.richfaces.cdk.annotations.JsfRenderer;
 import org.richfaces.cdk.annotations.Tag;
 
+/**
+ * Outputs an image to the view. You can specify the file as a path, a java.io.File, java.io.InputStream, java.net.URL or byte[]
+ * @author mnovotny
+ *
+ */
 @JsfComponent(description=@Description(displayName="org.jboss.seam.ui.graphicImage.GraphicImage",value="Output an image to the view. You can specify the file as a path, a java.io.File, java.io.InputStream, java.net.URL or byte[]"),
 family="org.jboss.seam.ui.graphicImage.GraphicImage", type="org.jboss.seam.ui.graphicImage.GraphicImage",generate="org.jboss.seam.ui.component.html.HtmlGraphicImage", 
 tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="graphicImage"), 

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageBlur.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageBlur.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageBlur.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -9,6 +9,12 @@
 import org.richfaces.cdk.annotations.JsfComponent;
 import org.richfaces.cdk.annotations.Tag;
 
+/**
+ * JSF Component which nestes in a &lt;s:graphicImage&gt;.Transforms an image by applying a blur.
+ * 
+ * @author mnovotny
+ *
+ */
 @JsfComponent(description=@Description(displayName="org.jboss.seam.ui.graphicImage.TransformImageBlur",value="Nested in a s:graphicImage. Transform an image by applying a blur."),
 family="org.jboss.seam.ui.graphicImage.TransformImageBlur", type="org.jboss.seam.ui.graphicImage.TransformImageBlur",generate="org.jboss.seam.ui.component.html.HtmlTransformImageBlur", 
 tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="transformImageBlur"), 

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageSize.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageSize.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageSize.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -9,6 +9,13 @@
 import org.richfaces.cdk.annotations.JsfComponent;
 import org.richfaces.cdk.annotations.Tag;
 
+/**
+ * 
+ * JSF Component which nestes in a &lt;s:graphicImage&gt;.Transforms an image by altering the size.
+ * 
+ * @author mnovotny
+ *
+ */
 @JsfComponent(description=@Description(displayName="org.jboss.seam.ui.graphicImage.TransformImageSize",value="Nested in a s:graphicImage. Transform an image by altering the size."),
 family="org.jboss.seam.ui.graphicImage.TransformImageSize", type="org.jboss.seam.ui.graphicImage.TransformImageSize",generate="org.jboss.seam.ui.component.html.HtmlTransformImageSize", 
 tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="transformImageSize"), 

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageType.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageType.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageType.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -9,6 +9,12 @@
 import org.richfaces.cdk.annotations.JsfComponent;
 import org.richfaces.cdk.annotations.Tag;
 
+/**
+ * JSF Component which nestes in a &lt;s:graphicImage&gt;.Transform an image by changing it's type.
+ * 
+ * @author mnovotny
+ *
+ */
 @JsfComponent(description=@Description(displayName="org.jboss.seam.ui.graphicImage.TransformImageType",value="Nested in a s:graphicImage. Transform an image by changing it's type."),
 family="org.jboss.seam.ui.graphicImage.TransformImageType", type="org.jboss.seam.ui.graphicImage.TransformImageType",generate="org.jboss.seam.ui.component.html.HtmlTransformImageType", 
 tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="transformImageType"), 

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/handler/CommandButtonParameterComponentHandler.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/handler/CommandButtonParameterComponentHandler.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/handler/CommandButtonParameterComponentHandler.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -9,7 +9,7 @@
 import static org.jboss.seam.ui.util.cdk.RendererBase.getUtils;
 
 /**
- * If user didn't specify id on button, do it for them (we need one rendered)
+ * Command button based parameter handler. If user didn't specify id on button, do it for them (we need one rendered)
  * 
  * @author Pete Muir
  *

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/handler/DecorateHandler.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/handler/DecorateHandler.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/handler/DecorateHandler.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -9,6 +9,12 @@
 import javax.faces.view.facelets.ComponentHandler;
 import javax.faces.view.facelets.FaceletContext;
 
+/**
+ * Decorating handler 
+ * 
+ * @author mnovotny
+ *
+ */
 public class DecorateHandler extends ComponentHandler
 {
    private com.sun.faces.facelets.tag.ui.DecorateHandler delegate;

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/validator/EqualityValidator.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/validator/EqualityValidator.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/validator/EqualityValidator.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -22,7 +22,7 @@
 import org.jboss.seam.ui.component.UIDecorate;
 
 /**
- * Validate two fields are equal
+ * Validates two fields are equal
  * 
  * @author pmuir
  * @author Daniel Roth

Modified: branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/validator/ModelValidator.java
===================================================================
--- branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/validator/ModelValidator.java	2012-10-03 08:55:42 UTC (rev 15185)
+++ branches/community/Seam_2_3/jboss-seam-ui/src/main/java/org/jboss/seam/ui/validator/ModelValidator.java	2012-10-03 09:49:22 UTC (rev 15186)
@@ -15,7 +15,7 @@
 import javax.validation.ConstraintViolation; 
 
 /**
- * Validates using Hibernate Validator model-based annotations.
+ * Validates model using Bean Validation annotations .
  * 
  * @author Gavin King
  * @author Jacob Hookom

More information about the seam-commits mailing list