You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by gv...@apache.org on 2006/02/25 17:00:14 UTC

svn commit: r380942 - /struts/shale/trunk/clay-plugin/src/conf/clay-config_1_0.dtd

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: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org