Author: gvanmatre
Date: Sat Feb 25 08:00:12 2006
New Revision: 380942

URL: http://svn.apache.org/viewcvs?rev=380942&view=rev
Log:
Added "description" element for describing elements.

Modified:
    struts/shale/trunk/clay-plugin/src/conf/clay-config_1_0.dtd

Modified: struts/shale/trunk/clay-plugin/src/conf/clay-config_1_0.dtd
URL: 
http://svn.apache.org/viewcvs/struts/shale/trunk/clay-plugin/src/conf/clay-config_1_0.dtd?rev=380942&r1=380941&r2=380942&view=diff
==============================================================================
--- struts/shale/trunk/clay-plugin/src/conf/clay-config_1_0.dtd (original)
+++ struts/shale/trunk/clay-plugin/src/conf/clay-config_1_0.dtd Sat Feb 25 
08:00:12 2006
@@ -34,6 +34,12 @@
 -->
 
 <!--
+    The "description" element contains a textual description of the element
+    it is nested in.
+-->
+<!ELEMENT description ANY>
+
+<!--
    The BindingType enumeration defines how Expression Language (EL) binding is 
    handled.
    VB - Use Value Binding
@@ -73,6 +79,9 @@
   The "set" node represents an individual meta attribute that should be 
applied to the "component" 
   or "element" nodes. 
   
+  description - The "description" element contains a textual description of 
the element
+    it is nested in.
+  
   name - The attribute name that corresponds to a component property.  The 
parent "attributes" node
          container can be inherited.  The "name" attribute acts as the "method 
signature" when 
          resolving inheritance.
@@ -84,7 +93,7 @@
   value - This attribute holds the value of the named attribute. A literal 
string value or a dynamic bound 
          expression.  
 -->
-<!ELEMENT set EMPTY>
+<!ELEMENT set (description*)>
 <!ATTLIST set
        name CDATA #REQUIRED
        bindingType %BindingType; #IMPLIED
@@ -94,6 +103,9 @@
 <!--
   A "component" represents a single top-level simple component or a subtree of 
components.
   
+  description - The "description" element contains a textual description of 
the element
+       it is nested in.
+  
   attributes - A container to hold attributes that will be applied to the 
target component.
   
   symbols - A container to hold tokens that are replaced within attribute 
values.  
@@ -147,7 +159,7 @@
       than the children collection.  
    
 -->
-<!ELEMENT component  (attributes?, symbols?, converter?, validator*, 
actionListener*, valueChangeListener*, element*)>
+<!ELEMENT component   (description*, attributes?, symbols?, converter?, 
validator*, actionListener*, valueChangeListener*, element*)>
 <!ATTLIST component jsfid CDATA #REQUIRED
        extends CDATA #IMPLIED
        componentType CDATA #IMPLIED
@@ -162,7 +174,10 @@
    to the "component".  The renderId is the unique namespace within the owning 
"component" or "element".
    The key difference between an element and component is that a component can 
be reused within
    any number of compositions where an element is the structure for defining 
the composition.
-   
+  
+  description - The "description" element contains a textual description of 
the element
+       it is nested in.
+     
   attributes - A container to hold attributes that will be applied to the 
target component.  These
        attributes will override and extend attributes in the top-level 
component which is specified
        by the "jsfid" attribute.
@@ -211,7 +226,7 @@
       another type of component. 
       
 -->
-<!ELEMENT element  (attributes?, symbols?, converter?, validator*, 
actionListener*, valueChangeListener*, element*)>
+<!ELEMENT element (description*, attributes?, symbols?, converter?, 
validator*, actionListener*, valueChangeListener*, element*)>
 <!ATTLIST element
        renderId CDATA #REQUIRED
        jsfid CDATA #REQUIRED
@@ -225,23 +240,37 @@
   node can exist under a "component" or "element" node.  A converter can only 
be
   assigned to a JSF component implementing the ValueHolder interfaces.
   
+  description - The "description" element contains a textual description of 
the element
+     it is nested in.
+
+  attributes - A container to hold attributes that will be applied to the 
target converter.  These
+       attributes will override and extend attributes in the top-level 
component which is specified
+       by the "jsfid" attribute.
+  
   jsfid - The top-level component that defines a converter. The componentType
      attribute of this component will should be a converter-id registered in
      the faces-config.xml file.
 -->
-<!ELEMENT converter (attributes?)>
+<!ELEMENT converter (description*, attributes?)>
 <!ATTLIST converter jsfid CDATA #REQUIRED>
 
 <!--
   A "actionListener" node is the meta component definition for a JSF action 
listener.  This 
   node can exist under a "component" or "element" node.  A action listener can 
only be
   assigned to a JSF component implementing the ActionSource interfaces.
+
+  description - The "description" element contains a textual description of 
the element
+     it is nested in.
+
+  attributes - A container to hold attributes that will be applied to the 
target actionListener.  These
+       attributes will override and extend attributes in the top-level 
component which is specified
+       by the "jsfid" attribute.
   
   jsfid - The top-level component that defines a converter. The componentType
      attribute of this component will should be a fully qualified class name
      of the java class implementing the ActionListener interfaces.
 -->
-<!ELEMENT actionListener (attributes?)>
+<!ELEMENT actionListener (description*, attributes?)>
 <!ATTLIST actionListener jsfid CDATA #REQUIRED>
 
 <!--
@@ -249,23 +278,37 @@
   node can exist under a "component" or "element" node.  A converter can only 
be
   assigned to a JSF component implementing the EditableValueHolder interfaces.
   
+  description - The "description" element contains a textual description of 
the element
+     it is nested in.
+
+  attributes - A container to hold attributes that will be applied to the 
target validator.  These
+       attributes will override and extend attributes in the top-level 
component which is specified
+       by the "jsfid" attribute.
+ 
   jsfid - The top-level component that defines a validator. The componentType
      attribute of this component will should be a validator-id registered in
      the faces-config.xml file.
 -->
-<!ELEMENT validator (attributes?)>
+<!ELEMENT validator (description*, attributes?)>
 <!ATTLIST validator jsfid CDATA #REQUIRED>
 
 <!--
   A "valueChangeListener" node is the meta component definition for a JSF 
value change listener. 
   This node can exist under a "component" or "element" node.  A value change 
listener can only be
   assigned to a JSF component implementing the EditableValueHolder interfaces.
+ 
+  description - The "description" element contains a textual description of 
the element
+     it is nested in.
+
+  attributes - A container to hold attributes that will be applied to the 
target valueChangeListener.  These
+       attributes will override and extend attributes in the top-level 
component which is specified
+       by the "jsfid" attribute.
   
   jsfid - The top-level component that defines a value change listener. The 
componentType
      attribute of this component will should be a fully qualified class name
      of the java class implementing the ValueChangeListener interfaces.
 -->
-<!ELEMENT valueChangeListener (attributes?)>
+<!ELEMENT valueChangeListener (description*, attributes?)>
 <!ATTLIST valueChangeListener jsfid CDATA #REQUIRED>
 
 <!-- 



---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to