You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@myfaces.apache.org by sk...@apache.org on 2005/11/25 01:29:19 UTC

svn commit: r348838 [1/2] - in /myfaces/impl/trunk: src/java/org/apache/myfaces/application/ src/java/org/apache/myfaces/application/jsp/ src/java/org/apache/myfaces/lifecycle/ tld/ tld/entities/ tld/entities/html_attributes/

Author: skitching
Date: Thu Nov 24 16:28:55 2005
New Revision: 348838

URL: http://svn.apache.org/viewcvs?rev=348838&view=rev
Log:
Add descriptions for all attributes. For attributes available on
multiple components this involves replacing the inline declaration with
an entity reference to a shared definition. Thanks to Steve Peterson for
the patch. See MYFACES-866.

Added:
    myfaces/impl/trunk/tld/entities/ui_table_renderer_attributes.xml   (with props)
Modified:
    myfaces/impl/trunk/src/java/org/apache/myfaces/application/ApplicationImpl.java
    myfaces/impl/trunk/src/java/org/apache/myfaces/application/jsp/JspStateManagerImpl.java
    myfaces/impl/trunk/src/java/org/apache/myfaces/lifecycle/LifecycleImpl.java
    myfaces/impl/trunk/tld/entities/html_anchor_attributes.xml
    myfaces/impl/trunk/tld/entities/html_attributes/datafld_datasrc_dataformatas.xml
    myfaces/impl/trunk/tld/entities/html_button_attributes.xml
    myfaces/impl/trunk/tld/entities/html_event_handler_attributes.xml
    myfaces/impl/trunk/tld/entities/html_form_attributes.xml
    myfaces/impl/trunk/tld/entities/html_img_attributes.xml
    myfaces/impl/trunk/tld/entities/html_input_attributes.xml
    myfaces/impl/trunk/tld/entities/html_input_checkbox_attributes.xml
    myfaces/impl/trunk/tld/entities/html_input_radio_attributes.xml
    myfaces/impl/trunk/tld/entities/html_label_attributes.xml
    myfaces/impl/trunk/tld/entities/html_select_attributes.xml
    myfaces/impl/trunk/tld/entities/html_table_attributes.xml
    myfaces/impl/trunk/tld/entities/html_textarea_attributes.xml
    myfaces/impl/trunk/tld/entities/html_universal_attributes.xml
    myfaces/impl/trunk/tld/entities/spec_img_attributes.xml
    myfaces/impl/trunk/tld/entities/standard_command_button_attributes.xml
    myfaces/impl/trunk/tld/entities/standard_data_table_attributes.xml
    myfaces/impl/trunk/tld/entities/standard_output_label_attributes.xml
    myfaces/impl/trunk/tld/entities/standard_panel_grid_attributes.xml
    myfaces/impl/trunk/tld/entities/standard_select_many_checkbox_attributes.xml
    myfaces/impl/trunk/tld/entities/ui_command_attributes.xml
    myfaces/impl/trunk/tld/entities/ui_component_attributes.xml
    myfaces/impl/trunk/tld/entities/ui_data_attributes.xml
    myfaces/impl/trunk/tld/entities/ui_graphic_attributes.xml
    myfaces/impl/trunk/tld/entities/ui_input_attributes.xml
    myfaces/impl/trunk/tld/entities/ui_message_attributes.xml
    myfaces/impl/trunk/tld/entities/ui_messages_attributes.xml
    myfaces/impl/trunk/tld/entities/ui_output_attributes.xml
    myfaces/impl/trunk/tld/entities/ui_parameter_attributes.xml
    myfaces/impl/trunk/tld/entities/ui_select_item_attributes.xml
    myfaces/impl/trunk/tld/entities/ui_select_items_attributes.xml
    myfaces/impl/trunk/tld/entities/validator_min_max_attributes.xml
    myfaces/impl/trunk/tld/myfaces_core.tld
    myfaces/impl/trunk/tld/myfaces_html.tld

Modified: myfaces/impl/trunk/src/java/org/apache/myfaces/application/ApplicationImpl.java
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/src/java/org/apache/myfaces/application/ApplicationImpl.java?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/src/java/org/apache/myfaces/application/ApplicationImpl.java (original)
+++ myfaces/impl/trunk/src/java/org/apache/myfaces/application/ApplicationImpl.java Thu Nov 24 16:28:55 2005
@@ -429,9 +429,15 @@
         }
         else
         {
+            try {
             UIComponent component = createComponent(componentType);
             valueBinding.setValue(facesContext, component);
             return component;
+            } catch(FacesException ex) {
+                log.error("Exception while creating component of type [" + componentType + "]"
+                        + " for binding [" + valueBinding.getExpressionString() + "]");
+                throw ex;
+            }
         }
     }
 

Modified: myfaces/impl/trunk/src/java/org/apache/myfaces/application/jsp/JspStateManagerImpl.java
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/src/java/org/apache/myfaces/application/jsp/JspStateManagerImpl.java?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/src/java/org/apache/myfaces/application/jsp/JspStateManagerImpl.java (original)
+++ myfaces/impl/trunk/src/java/org/apache/myfaces/application/jsp/JspStateManagerImpl.java Thu Nov 24 16:28:55 2005
@@ -55,7 +55,9 @@
 import org.apache.myfaces.renderkit.RendererUtils;
 
 /**
- * Default StateManager implementation.
+ * Default StateManager implementation for use when views are defined
+ * via tags in JSP pages.
+ * 
  * @author Thomas Spiegl (latest modification by $Author$)
  * @author Manfred Geiler
  * @version $Revision$ $Date$
@@ -106,6 +108,12 @@
         return serializedComponentStates;
     }
 
+    /**
+     * Return an object which contains info about the UIComponent type
+     * of each node in the view tree. This allows an identical UIComponent
+     * tree to be recreated later, though all the components will have
+     * just default values for their members.
+     */
     protected Object getTreeStructureToSave(FacesContext facesContext)
     {
         UIViewRoot viewRoot = facesContext.getViewRoot();
@@ -117,10 +125,20 @@
         return tsm.buildTreeStructureToSave(viewRoot);
     }
 
+    /**
+     * Given a tree of UIComponent objects created the default constructor
+     * for each node, retrieve saved state info (from either the client or
+     * the server) and walk the tree restoring the members of each node
+     * from the saved state information.
+     */
     protected void restoreComponentState(FacesContext facesContext,
                                          UIViewRoot uiViewRoot,
             String renderKitId)
     {
+        //===========================================
+        // first, locate the saved state information
+        //===========================================
+        
         Object serializedComponentStates;
         if (isSavingStateInClient(facesContext))
         {
@@ -160,9 +178,13 @@
             uiViewRoot.setRenderKitId(renderKitId);
         }
 
+        // now ask the view root component to restore its state
         uiViewRoot.processRestoreState(facesContext, serializedComponentStates);
     }
 
+    /**
+     * See getTreeStructureToSave.
+     */
     protected UIViewRoot restoreTreeStructure(FacesContext facesContext,
                                               String viewId,
             String renderKitId)

Modified: myfaces/impl/trunk/src/java/org/apache/myfaces/lifecycle/LifecycleImpl.java
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/src/java/org/apache/myfaces/lifecycle/LifecycleImpl.java?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/src/java/org/apache/myfaces/lifecycle/LifecycleImpl.java (original)
+++ myfaces/impl/trunk/src/java/org/apache/myfaces/lifecycle/LifecycleImpl.java Thu Nov 24 16:28:55 2005
@@ -453,6 +453,16 @@
     }
 
 
+    /**
+     * Walk the component tree, executing any component-bindings to reattach
+     * components to their backing beans. Also, any UIInput component is
+     * marked as Valid.
+     * <p>
+     *  Note that this method effectively breaks encapsulation; instead of
+     *  asking each component to update itself and its children, this
+     * method just reaches into each component. That makes it impossible
+     * for any component to customise its behaviour at this point.
+     */
     private static void recursivelyHandleComponentReferencesAndSetValid(FacesContext facesContext,
                                                                         UIComponent root)
     {
@@ -469,10 +479,10 @@
             if (component instanceof UIInput)
             {
                 ((UIInput)component).setValid(true);
-        }
+            }
 
             recursivelyHandleComponentReferencesAndSetValid(facesContext, component);
-    }
+        }
     }
 
     public void addPhaseListener(PhaseListener phaseListener)

Modified: myfaces/impl/trunk/tld/entities/html_anchor_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/html_anchor_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/html_anchor_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/html_anchor_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,29 +1,53 @@
-<!-- HTML 4.0 anchor (=a) attributes -->
-        <attribute><name>accesskey</name>   <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>charset</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>coords</name>      <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
+        <!-- HTML 4.0 anchor (=a) attributes -->
+        &html_accesskey_attribute;
+        &html_charset_attribute;
+        &html_tabindex_attribute;
+        &html_focusblur_attribute;
+        &html_type_attribute;
+        &html_target_attribute;
+
+        <attribute>
+            <name>coords</name>
+            <required>false</required>
+            <rtexprvalue>false</rtexprvalue>
+            <type>java.lang.String</type>
+            <description>Specifies the coordinates of regions within a client side image map.</description>
+        </attribute>
+
         <!-- "href" is a special LinkRenderer attribute -->
-        <attribute><name>hreflang</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
+        <attribute>
+            <name>hreflang</name>
+            <required>false</required>
+            <rtexprvalue>false</rtexprvalue>
+            <type>java.lang.String</type>
+            <description>Specifies the language of the linked resource.</description>
+        </attribute>
+
         <!-- "name" cannot be set by user -->
-        <attribute><name>rel</name>         <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>rev</name>         <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>shape</name>       <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>tabindex</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>type</name>        <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <!--todo: is in JSF API of HtmlCommandLink and HtmlOutputLink, but there is no corresponding tag in HTML 4.0.. What to do?-->
         <attribute>
-            <name>onblur</name>
+            <name>rel</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
+            <type>java.lang.String</type>
+            <description>
+                Specifies the relationship between the current document and
+                the linked resource.
+            </description>
         </attribute>
-        <!--todo: is in JSF API of HtmlCommandLink and HtmlOutputLink, but there is no corresponding tag in HTML 4.0.. What to do?-->
         <attribute>
-            <name>onfocus</name>
+            <name>rev</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
+            <type>java.lang.String</type>
+            <description>
+                Specifies the type(s) describing the reverse link for the linked
+                resource.
+            </description>
         </attribute>
         <attribute>
-            <name>target</name>
+            <name>shape</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
+            <type>java.lang.String</type>
+            <description>Specifies the shape of a region in a client side image map.</description>
         </attribute>

Modified: myfaces/impl/trunk/tld/entities/html_attributes/datafld_datasrc_dataformatas.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/html_attributes/datafld_datasrc_dataformatas.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/html_attributes/datafld_datasrc_dataformatas.xml (original)
+++ myfaces/impl/trunk/tld/entities/html_attributes/datafld_datasrc_dataformatas.xml Thu Nov 24 16:28:55 2005
@@ -1,18 +1,18 @@
-<attribute>
-    <name>datafld</name>
-    <required>false</required>
-    <rtexprvalue>false</rtexprvalue>
-    <description>Reserved for future use.</description>
-</attribute>
-<attribute>
-    <name>datasrc</name>
-    <required>false</required>
-    <rtexprvalue>false</rtexprvalue>
-    <description>Reserved for future use.</description>
-</attribute>
-<attribute>
-    <name>dataformatas</name>
-    <required>false</required>
-    <rtexprvalue>false</rtexprvalue>
-    <description>Reserved for future use.</description>
-</attribute>
+        <attribute>
+            <name>datafld</name>
+            <required>false</required>
+            <rtexprvalue>false</rtexprvalue>
+            <description>Reserved for future use.</description>
+        </attribute>
+        <attribute>
+            <name>datasrc</name>
+            <required>false</required>
+            <rtexprvalue>false</rtexprvalue>
+            <description>Reserved for future use.</description>
+        </attribute>
+        <attribute>
+            <name>dataformatas</name>
+            <required>false</required>
+            <rtexprvalue>false</rtexprvalue>
+            <description>Reserved for future use.</description>
+        </attribute>

Modified: myfaces/impl/trunk/tld/entities/html_button_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/html_button_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/html_button_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/html_button_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,11 +1,17 @@
-<!-- HTML 4.0 button attributes -->
-        <attribute><name>accesskey</name>   <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>alt</name>         <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>disabled</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onblur</name>      <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onchange</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onfocus</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onselect</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>size</name>        <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>tabindex</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>type</name>        <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
+        <!-- HTML 4.0 button attributes -->
+        &html_accesskey_attribute;
+        &html_alt_attribute;
+        &html_disabled_attribute;
+        &html_focus_blur_attributes;
+        &html_onselect_attribute;
+        &html_onchange_attribute;
+        &html_tabindex_attribute;
+        &html_type_attribute;
+        <attribute>
+            <name>size</name>
+            <required>false</required>
+            <rtexprvalue>false</rtexprvalue>
+            <type>java.lang.String</type>
+            <description>The initial width of this control.</description>
+        </attribute>
+

Modified: myfaces/impl/trunk/tld/entities/html_event_handler_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/html_event_handler_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/html_event_handler_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/html_event_handler_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,11 +1,61 @@
 <!-- HTML 4.0 event-handler attributes -->
-        <attribute><name>onclick</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>ondblclick</name> <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>onmousedown</name><required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>onmouseup</name>  <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>onmouseover</name><required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>onmousemove</name><required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>onmouseout</name> <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>onkeypress</name> <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>onkeydown</name>  <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>onkeyup</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
+<attribute>
+	<name>onclick</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>Specifies a script to be invoked when the element is clicked.</description>
+</attribute>
+<attribute>
+	<name>ondblclick</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>Specifies a script to be invoked when the element is double-clicked.</description>
+</attribute>
+<attribute>
+	<name>onmousedown</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>Specifies a script to be invoked when the pointing device is pressed over this element.</description>
+</attribute>
+<attribute>
+	<name>onmouseup</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>Specifies a script to be invoked when the pointing device is released over this element.</description>
+</attribute>
+<attribute>
+	<name>onmouseover</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>Specifies a script to be invoked when the pointing device is moved into this element.</description>
+</attribute>
+<attribute>
+	<name>onmousemove</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>Specifies a script to be invoked when the pointing device is moved while it is in this element.</description>
+</attribute>
+<attribute>
+	<name>onmouseout</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>Specifies a script to be invoked when the pointing device is moves out of this element.</description>
+</attribute>
+<attribute>
+	<name>onkeypress</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>Specifies a script to be invoked when a key is pressed over this element.</description>
+</attribute>
+<attribute>
+	<name>onkeydown</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>Specifies a script to be invoked when a key is pressed down over this element.</description>
+</attribute>
+<attribute>
+	<name>onkeyup</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>Specifies a script to be invoked when a key is released over this element.</description>
+</attribute>

Modified: myfaces/impl/trunk/tld/entities/html_form_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/html_form_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/html_form_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/html_form_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,7 +1,40 @@
 <!-- HTML 4.0 form attributes -->
-        <attribute><name>accept</name>          <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>acceptCharset</name>   <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>enctype</name>         <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>onreset</name>         <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>onsubmit</name>        <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>target</name>          <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
+&html_target_attribute;
+<attribute>
+    <name>accept</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <description>
+        Provides a comma-separated list of content types that the 
+        server processing this form can handle.
+    </description>
+</attribute>
+<attribute>
+    <name>acceptCharset</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <description>
+        The list of character encodings accepted by the server for this
+        form.
+    </description>
+</attribute>
+<attribute>
+    <name>enctype</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <description>
+        The content type used to submit this form to the server.
+    </description>
+</attribute>
+<attribute>
+    <name>onreset</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <description>Specifies a script to be invoked when this form is reset.</description>
+</attribute>
+<attribute>
+    <name>onsubmit</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <description>Specifies a script to be invoked when this form is submitted.</description>
+</attribute>

Modified: myfaces/impl/trunk/tld/entities/html_img_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/html_img_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/html_img_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/html_img_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,25 +1,17 @@
 <!-- HTML 4.0 img attributes that are not part of the JSF 1.1 specification -->
-        <attribute>
-            <name>align</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-            <type>java.lang.String</type>
-        </attribute>
-        <attribute>
-            <name>border</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-            <type>java.lang.String</type>
-        </attribute>
+&html_align_attribute;
+&html_border_attribute;
         <attribute>
             <name>hspace</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
+            <description>Specifies the amount of white space to be inserted to the left and right of this element, in undefined units.  Deprecated in HTML 4.01.</description>
         </attribute>
         <attribute>
             <name>vspace</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
+            <description>Specifies the amount of white space to be inserted above and below this element, in undefined units.  Deprecated in HTML 4.01.</description>
         </attribute>

Modified: myfaces/impl/trunk/tld/entities/html_input_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/html_input_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/html_input_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/html_input_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,13 +1,24 @@
 <!-- HTML 4.0 input attributes -->
-        <attribute><name>accesskey</name>   <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>align</name>       <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>alt</name>         <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>disabled</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>maxlength</name>   <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onblur</name>      <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onchange</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onfocus</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onselect</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>readonly</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>size</name>        <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>tabindex</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
\ No newline at end of file
+&html_accesskey_attribute;
+&html_align_attribute;
+&html_alt_attribute;
+&html_disabled_attribute;
+&html_focus_blur_attributes;
+&html_onchange_attribute;
+&html_onselect_attribute;
+&html_readonly_attribute;
+&html_tabindex_attribute;
+<attribute>
+	<name>maxlength</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<type>java.lang.String</type>
+	<description>The maximum number of characters allowed to be entered.</description>
+</attribute>
+<attribute>
+	<name>size</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<type>java.lang.String</type>
+	<description>The initial width of this control, in characters.</description>
+</attribute>

Modified: myfaces/impl/trunk/tld/entities/html_input_checkbox_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/html_input_checkbox_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/html_input_checkbox_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/html_input_checkbox_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,13 +1,10 @@
-<!-- HTML 4.0 input attributes for type "checkbox" -->
-        <attribute><name>accesskey</name>   <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>alt</name>         <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>datafld</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>datasrc</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>dataformatas</name><required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>disabled</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onblur</name>      <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onchange</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onfocus</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onselect</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>readonly</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>tabindex</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
+        <!-- HTML 4.0 input attributes for type "checkbox" -->
+        &html_accesskey_attribute;
+        &html_alt_attribute;
+        &html_datafld_datasrc_dataformatas;
+        &html_disabled_attribute;
+        &html_focus_blur_attributes;
+        &html_onchange_attribute;
+        &html_onselect_attribute;
+        &html_readonly_attribute;
+        &html_tabindex_attribute;

Modified: myfaces/impl/trunk/tld/entities/html_input_radio_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/html_input_radio_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/html_input_radio_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/html_input_radio_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,13 +1,10 @@
 <!-- HTML 4.0 input attributes for type "radio" -->
-        <attribute><name>accesskey</name>   <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>alt</name>         <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>datafld</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>datasrc</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>dataformatas</name><required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>disabled</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onblur</name>      <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onchange</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onfocus</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onselect</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>readonly</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>tabindex</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
+&html_accesskey_attribute;
+&html_alt_attribute;
+&html_disable_attribute;
+&html_focus_blur_attributes;
+&html_onchange_attribute;
+&html_onselect_attribute;
+&html_readonly_attribute;
+&html_tabindex_attribute;
+&html_datafld_datasrc_dataformatas;

Modified: myfaces/impl/trunk/tld/entities/html_label_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/html_label_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/html_label_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/html_label_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,5 +1,4 @@
 <!-- HTML 4.0 label attributes -->
-        <attribute><name>accesskey</name>   <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
+&html_accesskey_attribute;
+&html_focus_blur_attributes;
         <!-- "for" is a specific LabelRenderer attribute -->
-        <attribute><name>onblur</name>      <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>onfocus</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>

Modified: myfaces/impl/trunk/tld/entities/html_select_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/html_select_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/html_select_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/html_select_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,21 +1,10 @@
 <!-- HTML 4.0 select attributes -->
-        <attribute><name>datafld</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>datasrc</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>dataformatas</name><required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>disabled</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
+&html_focus_blur_attributes;
+&html_onchange_attribute;
+&html_tabindex_attribute;
+&html_readonly_attribute;
+&html_disabled_attribute;
+&html_datafld_datasrc_dataformatas;
         <!-- "multiple" cannot be set manually -->
         <!-- "name" cannot be set manually -->
-        <attribute><name>onblur</name>      <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>onchange</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>onfocus</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
         <!-- "size" cannot be set directly for it is a MenuRenderer specific attribute -->
-        <attribute><name>tabindex</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute>
-            <name>readonly</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-            <type>java.lang.String</type>
-            <description>Flag indicating that this component will prohibit
-          changes by the user.  The element may receive focus
-          unless it has also been disabled.</description>
-        </attribute>
\ No newline at end of file

Modified: myfaces/impl/trunk/tld/entities/html_table_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/html_table_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/html_table_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/html_table_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,13 +1,62 @@
 <!-- HTML 4.0 table attributes -->
-        <attribute><name>align</name>           <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>border</name>          <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>bgcolor</name>         <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>cellpadding</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>cellspacing</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>datafld</name>         <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>datasrc</name>         <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>dataformatas</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>frame</name>           <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>rules</name>           <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>summary</name>         <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>width</name>           <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
+&html_align_attribute;
+&html_border_attribute;
+&html_bgcolor_attribute;
+&html_datafld_datasrc_dataformatas_attributes;
+
+<attribute>
+    <name>cellpadding</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <description>
+        Specifies the amount of empty space between the cell border and
+        its contents.  It can be either a pixel length or a percentage.
+    </description>
+</attribute>
+<attribute>
+    <name>cellspacing</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <description>
+        Specifies the amount of space between the cells of the table.
+        It can be either a pixel length or a percentage of available 
+        space.
+    </description>
+</attribute>
+<attribute>
+    <name>frame</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <description>
+        Controls what part of the frame that surrounds a table is 
+        visible.  Values include:  void, above, below, hsides, lhs, 
+        rhs, vsides, box, and border.
+    </description>
+</attribute>
+<attribute>
+    <name>rules</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <description>
+        Controls how rules are rendered between cells.  Values include:
+        none, groups, rows, cols, and all.
+    </description>
+</attribute>
+<attribute>
+    <name>summary</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <description>
+        Provides a summary of the contents of the table, for
+        accessibility purposes.
+    </description>
+</attribute>
+<attribute>
+    <name>width</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <description>
+        Specifies the desired width of the table, as a pixel length or
+        a percentage of available space.
+    </description>
+</attribute>

Modified: myfaces/impl/trunk/tld/entities/html_textarea_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/html_textarea_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/html_textarea_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/html_textarea_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,14 +1,23 @@
 <!-- HTML 4.0 textarea attributes -->
-        <attribute><name>accesskey</name>   <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>cols</name>        <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>datafld</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>datasrc</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>dataformatas</name><required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>disabled</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onblur</name>      <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onchange</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onfocus</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>onselect</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>readonly</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>rows</name>        <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
-        <attribute><name>tabindex</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue><type>java.lang.String</type></attribute>
+&html_datafld_datasrc_dataformatas_attributes;
+&html_accesskey_attribute;
+&html_disabled_attribute;
+&html_focus_blur_attribute;
+&html_onchange_attribute;
+&html_onselect_attribute;
+&html_tabindex_attribute;
+&html_readonly_attribute;
+<attribute>
+    <name>cols</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <type>java.lang.String</type>
+    <description>The width of this element, in characters.</description>
+</attribute>
+<attribute>
+    <name>rows</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <type>java.lang.String</type>
+    <description>The height of this element, in characters.</description>
+</attribute>

Modified: myfaces/impl/trunk/tld/entities/html_universal_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/html_universal_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/html_universal_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/html_universal_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,11 +1,31 @@
 <!-- HTML 4.0 universal attributes -->
-        <attribute><name>dir</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>lang</name>    <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>style</name>   <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute><name>title</name>   <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-        <attribute>
-            <name>styleClass</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-            <description>Corresponds to the HTML class attribute.</description>
-        </attribute>
+<attribute>
+	<name>dir</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).</description>
+</attribute>
+<attribute>
+	<name>lang</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>The base language of this document.</description>
+</attribute>
+<attribute>
+	<name>style</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>CSS styling instructions.</description>
+</attribute>
+<attribute>
+	<name>title</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>An advisory title for this element.  Often used by the user agent as a tooltip.</description>
+</attribute>
+<attribute>
+	<name>styleClass</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>The CSS class for this element.  Corresponds to the HTML 'class' attribute.</description>
+</attribute>

Modified: myfaces/impl/trunk/tld/entities/spec_img_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/spec_img_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/spec_img_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/spec_img_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,27 +1,24 @@
 <!-- The subset of HTML 4.0 img attributes that are supported by the JSF 1.1 specification -->
         <attribute>
-            <name>alt</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-            <type>java.lang.String</type>
-        </attribute>
-        <attribute>
             <name>height</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
+            <description>Overrides the natural height of this image, by specifying height in pixels.</description>
         </attribute>
         <attribute>
             <name>ismap</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
+            <description>Specifies server-side image map handling for this image.</description>
         </attribute>
         <attribute>
             <name>longdesc</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
+            <description>A link to a long description of the image.</description>
         </attribute>
         <!-- "name" attribute cannot be set directly by user -->
         <!-- "src" attribute cannot be set directly, use "url" instead! -->
@@ -30,10 +27,12 @@
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
+            <description>Specifies an image map to use with this image.</description>
         </attribute>
         <attribute>
             <name>width</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
+            <description>Overrides the natural width of this image, by specifying width in pixels.</description>
         </attribute>

Modified: myfaces/impl/trunk/tld/entities/standard_command_button_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/standard_command_button_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/standard_command_button_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/standard_command_button_attributes.xml Thu Nov 24 16:28:55 2005
@@ -8,4 +8,5 @@
             <name>image</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
+            <description>Used to specify the URL of an image that renders in place of the button.</description>
         </attribute>

Modified: myfaces/impl/trunk/tld/entities/standard_data_table_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/standard_data_table_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/standard_data_table_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/standard_data_table_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,5 +1,6 @@
         <!-- all standard attributes of the dataTable tag -->
         &ui_panel_attributes;
+        &ui_table_renderer_attributes;
         &html_universal_attributes;
         &html_event_handler_attributes;
         &html_table_attributes;
@@ -8,41 +9,28 @@
             <name>value</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
-            <description>Supported types see JSF Spec 4.1.3</description>
+            <description>An EL expression that specifies the data model that backs this table.  The value can be of any type.
+            
+            A value of type DataModel is used directly.  Array-like parameters of type java.util.List, array of Object, 
+            java.sql.ResultSet, or javax.servlet.jsp.jstl.sql.Result are wrapped in a DataModel.
+            
+            Other values are wrapped in a DataModel as a single row.</description>
         </attribute>
         <attribute>
             <name>var</name>
             <required>true</required>
             <rtexprvalue>false</rtexprvalue>
+            <description>Defines the name of the request-scope variable that will hold the current row during iteration.  This value must be a static value.</description>
         </attribute>
         <attribute>
             <name>rows</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
+            <description>The number of rows to be displayed.  Specify zero for all remaining rows in the table.</description>
         </attribute>
         <attribute>
             <name>first</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
-        </attribute>
-        <!-- TableRenderer attributes -->
-        <attribute>
-            <name>columnClasses</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-        </attribute>
-        <attribute>
-            <name>footerClass</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-        </attribute>
-        <attribute>
-            <name>headerClass</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-        </attribute>
-        <attribute>
-            <name>rowClasses</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
+            <description>The index of the first row to be displayed, where 0 is the first row.</description>
         </attribute>

Modified: myfaces/impl/trunk/tld/entities/standard_output_label_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/standard_output_label_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/standard_output_label_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/standard_output_label_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,11 +1,12 @@
-        <!-- all standard attributes of the outputLabel tag -->
-        &ui_output_attributes;
-        &html_universal_attributes;
-        &html_event_handler_attributes;
-        &html_label_attributes;
-        <!-- LabelRenderer attributes -->
-        <attribute>
-          <name>for</name>
-          <required>false</required>
-          <rtexprvalue>false</rtexprvalue>
-        </attribute>
+<!-- all standard attributes of the outputLabel tag -->
+&ui_output_attributes;
+&html_universal_attributes;
+&html_event_handler_attributes;
+&html_label_attributes;
+<!-- LabelRenderer attributes -->
+<attribute>
+  <name>for</name>
+  <required>false</required>
+  <rtexprvalue>false</rtexprvalue>
+  <description>The client ID of the target input element of this label.</description>
+</attribute>

Modified: myfaces/impl/trunk/tld/entities/standard_panel_grid_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/standard_panel_grid_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/standard_panel_grid_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/standard_panel_grid_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,30 +1,13 @@
-        &ui_panel_attributes;
-        &html_universal_attributes;
-        &html_event_handler_attributes;
-        &html_table_attributes;
-        <!-- GridRenderer attributes -->
-        <attribute>
-            <name>columnClasses</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-        </attribute>
-        <attribute>
-            <name>columns</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-        </attribute>
-        <attribute>
-            <name>footerClass</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-        </attribute>
-        <attribute>
-            <name>headerClass</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-        </attribute>
-        <attribute>
-            <name>rowClasses</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-        </attribute>
+&ui_panel_attributes;
+&html_universal_attributes;
+&html_event_handler_attributes;
+&html_table_attributes;
+&ui_table_renderer_attributes;
+
+<!-- GridRenderer attributes -->
+<attribute>
+    <name>columns</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <description>Specifies the number of columns in the grid.</description>
+</attribute>

Modified: myfaces/impl/trunk/tld/entities/standard_select_many_checkbox_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/standard_select_many_checkbox_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/standard_select_many_checkbox_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/standard_select_many_checkbox_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,16 +1,27 @@
-        <!-- all standard attributes of the selectManyCheckbox tag -->
-        &ui_select_many_attributes;
-        &html_universal_attributes;
-        &html_event_handler_attributes;
-        &html_input_checkbox_attributes;
-        <!-- CheckboxListRenderer attributes -->
-        <attribute>
-            <name>layout</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-            <type>java.lang.String</type>
-            <description>see JSF Spec. 8.5.9</description>
-        </attribute>
-        <!--TODO: disabledClass, enabledClass -->
-        <attribute><name>enabledClass</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
-         <attribute><name>disabledClass</name>     <required>false</required>  <rtexprvalue>false</rtexprvalue></attribute>
+<!-- all standard attributes of the selectManyCheckbox tag -->
+&ui_select_many_attributes;
+&html_universal_attributes;
+&html_event_handler_attributes;
+&html_input_checkbox_attributes;
+<!-- CheckboxListRenderer attributes -->
+<attribute>
+	<name>layout</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<type>java.lang.String</type>
+	<description>Controls the layout direction of the child elements.  Values include:  
+	lineDirection (vertical) and pageDirection (horzontal).</description>
+</attribute>
+<!--TODO: disabledClass, enabledClass -->
+<attribute>
+	<name>enabledClass</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>The CSS class assigned to the label element for enabled choices.</description>
+</attribute>
+<attribute>
+	<name>disabledClass</name>
+	<required>false</required>
+	<rtexprvalue>false</rtexprvalue>
+	<description>The CSS class assigned to the label element for enabled choices.</description>
+</attribute>

Modified: myfaces/impl/trunk/tld/entities/ui_command_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/ui_command_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/ui_command_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/ui_command_attributes.xml Thu Nov 24 16:28:55 2005
@@ -5,26 +5,33 @@
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>MethodBinding pointing at the application action to be invoked, if this UIComponent is activated by the user, during the Apply Request Values or Invoke Application phase of the request processing lifecycle, depending on the value of the immediate property.</description>
+            <description>A method binding EL expression that identifies an action method to be invoked if this component is activated by the user.  
+            An action method accepts no parameters and has a String return value, called the action outcome, that identifies the next view displayed.
+            The phase that this event is fired in can be controlled via the immediate attribute.</description>
         </attribute>
         <attribute>
             <name>actionListener</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>MethodBinding pointing at method acception an ActionEvent with return type void.</description>
+            <description>A method binding EL expression that identifies an action listener method to be invoked if this component is activated by the user.
+            An action listener method accepts a parameter of type javax.faces.event.ActionEvent and returns void.
+            The phase that this event is fired in can be controlled via the immediate attribute.
+            </description>
         </attribute>
         <attribute>
             <name>immediate</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>True means, that the default ActionListener should be executed immediately (i.e. during Apply Request Values phase of the request processing lifecycle), rather than waiting until the Invoke Application phase.</description>
+            <description>A boolean value that identifies the phase during which action events should fire.
+            During normal event processing, action methods and action listener methods are fired during the "invoke application" phase of request processing.
+            If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase.</description>
         </attribute>
         <attribute>
             <name>value</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>Initial value to set when rendered for the first time.</description>
+            <description>The initial value of this component.</description>
         </attribute>

Modified: myfaces/impl/trunk/tld/entities/ui_component_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/ui_component_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/ui_component_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/ui_component_attributes.xml Thu Nov 24 16:28:55 2005
@@ -4,19 +4,22 @@
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>Every component may have an unique id. Automatically created if omitted.</description>
+            <description>The developer-assigned ID of this component.  The ID must be unique within the scope of the tag's 
+            enclosing naming container (e.g., h:form or f:subview).  This value must be a static value.
+            </description>
         </attribute>
         <attribute>
             <name>rendered</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>If false, this component will not be rendered.</description>
+            <description>A boolean value that indicates whether this component should be rendered.</description>
         </attribute>
         <attribute>
             <name>binding</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>Component binding.</description>
+            <description>Identifies a backing bean property, of type UIComponent,
+            to bind to this component instance.  This value must be a static value.</description>
         </attribute>

Modified: myfaces/impl/trunk/tld/entities/ui_data_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/ui_data_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/ui_data_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/ui_data_attributes.xml Thu Nov 24 16:28:55 2005
@@ -4,19 +4,19 @@
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>The zero-relative row number of the first row to be displayed.</description>
+            <description>The index of the first row to be displayed, where 0 is the first row.</description>
         </attribute>
         <attribute>
             <name>rows</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>The number of rows to be displayed, or zero for all remaining rows in the table.</description>
+            <description>The number of rows to be displayed.  Specify zero for all remaining rows in the table.</description>
         </attribute>
         <attribute>
             <name>var</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>The request-scope attribute under which the data object for the current row will be exposed when iterating.</description>
+            <description>Defines the name of the request-scope variable that will hold the current row during iteration.</description>
         </attribute>

Modified: myfaces/impl/trunk/tld/entities/ui_graphic_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/ui_graphic_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/ui_graphic_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/ui_graphic_attributes.xml Thu Nov 24 16:28:55 2005
@@ -5,12 +5,14 @@
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>URL of the image (see JSF.4.1.5).</description>
+            <description>The URL of the image to be displayed.  If the URL starts with a '/', it is relative to the context path of the
+            web application.</description>
         </attribute>
         <attribute>
             <name>value</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>URL of the image (see JSF.4.1.5).</description>
+            <description>The URL of the image.  If the URL starts with a '/', it is relative to the context path of the
+            web application.</description>
         </attribute>

Modified: myfaces/impl/trunk/tld/entities/ui_input_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/ui_input_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/ui_input_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/ui_input_attributes.xml Thu Nov 24 16:28:55 2005
@@ -5,26 +5,35 @@
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description> Flag indicating that this component's value must be converted and validated immediately (that is, during Apply Request Values phase), rather than waiting until Process Validations phase.</description>
+            <description>A boolean value that identifies the phase during which value change events should fire.
+            During normal event processing, value change events are fired during the "invoke application" phase of request processing.
+            If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase.</description>
         </attribute>
         <attribute>
             <name>required</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>If true, this component will be checked for non-empty input.</description>
+            <description>A boolean value that indicates whether an input value is required.
+            
+            If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted.</description>
         </attribute>
         <attribute>
             <name>validator</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>MethodBinding pointing at a method that will be called during Process Validations phase of the request processing lifecycle, to validate the current value of this component.</description>
+            <description>
+            A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates
+            the component's local value.
+            </description>
         </attribute>
         <attribute>
             <name>valueChangeListener</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>Listener for value changes.</description>
+            <description>A method binding EL expression, accepting a ValueChangeEvent parameter and returning void,
+            that identifies a value change handler method that is invoked if this component is modified.
+            The phase that this handler is fired in can be controlled via the immediate attribute.</description>
         </attribute>

Modified: myfaces/impl/trunk/tld/entities/ui_message_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/ui_message_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/ui_message_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/ui_message_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,26 +1,28 @@
-        <!-- UIMessage attributes -->
-        &ui_component_attributes;
-        <attribute>
-            <name>for</name>
-            <required>true</required>
-            <rtexprvalue>false</rtexprvalue>
-            <type>java.lang.String</type>
-            <description>The client identifier of the component for which this component represents associated message(s).</description>
-        </attribute>
-        <attribute>
-            <name>showSummary</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-            <type>java.lang.String</type>
-            <description>Indicates whether the summary of the associated message(s) should be displayed.
-                         Default is: true</description>
-        </attribute>
-        <attribute>
-            <name>showDetail</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-            <type>java.lang.String</type>
-            <description>Indicates whether the detail of the associated message(s) should be displayed.
-                         Default is: false</description>
-        </attribute>
+<!-- UIMessage attributes -->
+&ui_component_attributes;
+<attribute>
+    <name>for</name>
+    <required>true</required>
+    <rtexprvalue>false</rtexprvalue>
+    <type>java.lang.String</type>
+    <description>An EL expression, returning a String, with the unique ID of the component 
+    for which messages should be displayed.  This string has the same format as that accepted by the 
+    UIComponent.findComponent() method.</description>
+</attribute>
+<attribute>
+    <name>showSummary</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <type>java.lang.String</type>
+    <description>An EL expression, returning a boolean, that controls whether the summary text
+    of the associated messages is displayed.  Default: true.</description>
+</attribute>
+<attribute>
+    <name>showDetail</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <type>java.lang.String</type>
+    <description>An EL expression, returning a boolean, that controls whether the detail text
+    of the associated messages is displayed.  Default: false.</description>
+</attribute>
 

Modified: myfaces/impl/trunk/tld/entities/ui_messages_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/ui_messages_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/ui_messages_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/ui_messages_attributes.xml Thu Nov 24 16:28:55 2005
@@ -5,22 +5,23 @@
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>Indicates whether the summary of the message(s) should be displayed.
-                         Default is: true</description>
+            <description>A boolean value that controls whether the summary text
+            of the associated messages is displayed.  Default: true.</description>
         </attribute>
         <attribute>
             <name>showDetail</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>Indicates whether the detail of the message(s) should be displayed.
-                         Default is: false</description>
+            <description>A boolean value that controls whether the detail text
+            of the associated messages is displayed.  Default: false.</description>
         </attribute>
         <attribute>
             <name>globalOnly</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>Indicates whether only global messages (that is, messages with no associated client identifier) should be rendered.
-                         Default is: false</description>
+            <description>A boolean value that controls whether global messages 
+            (those without IDs) should be displayed.  
+            Default: true.</description>
         </attribute>

Modified: myfaces/impl/trunk/tld/entities/ui_output_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/ui_output_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/ui_output_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/ui_output_attributes.xml Thu Nov 24 16:28:55 2005
@@ -5,12 +5,19 @@
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>Initial value to set when rendered for the first time.</description>
+            <description>The initial value of this component.</description>
         </attribute>
         <attribute>
             <name>converter</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>Id of Converter to be used or reference to a Converter.</description>
+            <description>
+                An expression that specifies the Converter for this component.  
+                If the value binding expression is a String, the String is used
+                as an ID to look up a Converter. If the value binding expression
+                is a Converter, uses that instance as the converter.
+            
+                The value can either be a static value (ID case only) or an EL expression.
+            </description>
         </attribute>

Modified: myfaces/impl/trunk/tld/entities/ui_parameter_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/ui_parameter_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/ui_parameter_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/ui_parameter_attributes.xml Thu Nov 24 16:28:55 2005
@@ -1,28 +1,35 @@
-        <!-- UIParameter attributes -->
-        <attribute>
-            <name>binding</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-            <type>java.lang.String</type>
-            <description>Component binding.</description>
-        </attribute>
-        <attribute>
-            <name>id</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-            <type>java.lang.String</type>
-        </attribute>
-        <attribute>
-            <name>name</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-            <type>java.lang.String</type>
-            <description>Name of this parameter</description>
-        </attribute>
-        <attribute>
-            <name>value</name>
-            <required>false</required>
-            <rtexprvalue>false</rtexprvalue>
-            <type>java.lang.String</type>
-            <description>Initial value or value binding.</description>
-        </attribute>
+<!-- UIParameter attributes -->
+<attribute>
+    <name>binding</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <type>java.lang.String</type>
+    <description>An EL value binding that identifies a backing bean property, of type UIComponent,
+    to bind to this component instance.</description>
+</attribute>
+<attribute>
+    <name>id</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <type>java.lang.String</type>
+    <description>
+    Developer-assigned ID of this component.  The ID must be unique within the scope of the tag's 
+    enclosing naming container (e.g., &lt;h:form&gt; or &lt;f:subview&gt;).
+    
+    This must be a static value.
+    </description>
+</attribute>
+<attribute>
+    <name>name</name>
+    <required>false</required>
+    <rtexprvalue>false</rtexprvalue>
+    <type>java.lang.String</type>
+    <description>A String containing the name of the parameter.</description>
+</attribute>
+<attribute>
+    <name>value</name>
+    <required>true</required>
+    <rtexprvalue>false</rtexprvalue>
+    <type>java.lang.String</type>
+    <description>The value of this parameter.</description>
+</attribute>

Modified: myfaces/impl/trunk/tld/entities/ui_select_item_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/ui_select_item_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/ui_select_item_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/ui_select_item_attributes.xml Thu Nov 24 16:28:55 2005
@@ -4,7 +4,8 @@
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>Component binding.</description>
+            <description>A value that identifies a backing bean property, of type UIComponent,
+            to bind to this component instance.</description>
         </attribute>
         <attribute>
             <name>itemDisabled</name>
@@ -18,29 +19,38 @@
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
+            <description>
+            A Developer-assigned ID of this component.  The ID must be unique within the scope of the tag's 
+            enclosing naming container (e.g., &lt;h:form&gt; or &lt;f:subview&gt;).
+            
+            This must be a static value.
+            </description>
         </attribute>
         <attribute>
             <name>itemDescription</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
+            <description>An optional description for this item.</description>
         </attribute>
         <attribute>
             <name>itemLabel</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
+            <description>The locale-specific label that will be displayed to the user for this item.</description>
         </attribute>
         <attribute>
             <name>itemValue</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
+            <description>The value of this item, of the same type as the parent component's value.</description>
         </attribute>
         <attribute>
             <name>value</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>Value reference pointing at a javax.faces.model.SelectItem instance.</description>
+            <description>An EL expression that refers to a javax.faces.model.SelectItem instance.</description>
         </attribute>

Modified: myfaces/impl/trunk/tld/entities/ui_select_items_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/ui_select_items_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/ui_select_items_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/ui_select_items_attributes.xml Thu Nov 24 16:28:55 2005
@@ -4,18 +4,32 @@
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>Component binding.</description>
+            <description>A value that identifies a backing bean property, of type UIComponent,
+            to bind to this component instance. </description>
         </attribute>
         <attribute>
             <name>id</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
+            <description>
+            A Developer-assigned ID of this component.  The ID must be unique within the scope of the tag's 
+            enclosing naming container (e.g., &lt;h:form&gt; or &lt;f:subview&gt;).
+            
+            This must be a static value.
+            </description>
         </attribute>
         <attribute>
             <name>value</name>
             <required>false</required>
             <rtexprvalue>false</rtexprvalue>
             <type>java.lang.String</type>
-            <description>Value reference pointing at a List or Array of javax.faces.model.SelectItem instances.</description>
+            <description>An EL expression that specifies the contents of the selection list.  The expression can refer to one of the following:
+            
+            1.  a single SelectItem  
+            2.  an array or Collection of SelectItem instances
+            3.  a Map.  The contents of the Map are used to create SelectItem instances, where the SelectItem's label is the map's key value, 
+            and the SelectItem's value is the map's value.
+            
+            The value properties of each of the SelectItems must be of the same basic type as the parent component's value.</description>
         </attribute>

Added: myfaces/impl/trunk/tld/entities/ui_table_renderer_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/ui_table_renderer_attributes.xml?rev=348838&view=auto
==============================================================================
--- myfaces/impl/trunk/tld/entities/ui_table_renderer_attributes.xml (added)
+++ myfaces/impl/trunk/tld/entities/ui_table_renderer_attributes.xml Thu Nov 24 16:28:55 2005
@@ -0,0 +1,24 @@
+        <attribute>
+            <name>columnClasses</name>
+            <required>false</required>
+            <rtexprvalue>false</rtexprvalue>
+            <description>A comma separated list of CSS class names to apply to td elements in each column.</description>
+        </attribute>
+        <attribute>
+            <name>footerClass</name>
+            <required>false</required>
+            <rtexprvalue>false</rtexprvalue>
+            <description>The CSS class to be applied to footer cells.</description>
+        </attribute>
+        <attribute>
+            <name>headerClass</name>
+            <required>false</required>
+            <rtexprvalue>false</rtexprvalue>
+            <description>The CSS class to be applied to header cells.</description>
+        </attribute>
+        <attribute>
+            <name>rowClasses</name>
+            <required>false</required>
+            <rtexprvalue>false</rtexprvalue>
+            <description>A comma separated list of CSS class names to apply to td elements in each row.</description>
+        </attribute>

Propchange: myfaces/impl/trunk/tld/entities/ui_table_renderer_attributes.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: myfaces/impl/trunk/tld/entities/ui_table_renderer_attributes.xml
------------------------------------------------------------------------------
    svn:executable = *

Propchange: myfaces/impl/trunk/tld/entities/ui_table_renderer_attributes.xml
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Modified: myfaces/impl/trunk/tld/entities/validator_min_max_attributes.xml
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/entities/validator_min_max_attributes.xml?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/entities/validator_min_max_attributes.xml (original)
+++ myfaces/impl/trunk/tld/entities/validator_min_max_attributes.xml Thu Nov 24 16:28:55 2005
@@ -4,10 +4,12 @@
         <required>false</required>
         <rtexprvalue>false</rtexprvalue>
         <type>java.lang.String</type>
+        <description>The smallest value that should be considered valid.</description>
       </attribute>
       <attribute>
         <name>maximum</name>
         <required>false</required>
         <rtexprvalue>false</rtexprvalue>
         <type>java.lang.String</type>
+        <description>The largest value that should be considered valid.</description>
       </attribute>



Re: svn commit: r348838 [1/2] - in /myfaces/impl/trunk: src/java/org/apache/myfaces/application/ src/java/org/apache/myfaces/application/jsp/ src/java/org/apache/myfaces/lifecycle/ tld/ tld/entities/ tld/entities/html_attributes/

Posted by Simon Kitching <sk...@obsidium.com>.
Hi,

Just FYI, I accidentally committed 3 unrelated files (ApplicationImpl, 
JspStateManagerImpl, LifecycleImpl) with this patch. However those 
changes won't do any harm; two are just comment changes and one improves 
logging a bit. I might tidy up the logging one later..

Cheers,

Simon

skitching@apache.org wrote:
> Author: skitching
> Date: Thu Nov 24 16:28:55 2005
> New Revision: 348838
> 
> URL: http://svn.apache.org/viewcvs?rev=348838&view=rev
> Log:
> Add descriptions for all attributes. For attributes available on
> multiple components this involves replacing the inline declaration with
> an entity reference to a shared definition. Thanks to Steve Peterson for
> the patch. See MYFACES-866.
> 
> Added:
>     myfaces/impl/trunk/tld/entities/ui_table_renderer_attributes.xml   (with props)
> Modified:
>     myfaces/impl/trunk/src/java/org/apache/myfaces/application/ApplicationImpl.java
>     myfaces/impl/trunk/src/java/org/apache/myfaces/application/jsp/JspStateManagerImpl.java
>     myfaces/impl/trunk/src/java/org/apache/myfaces/lifecycle/LifecycleImpl.java