From 26ccd99889a57a3d40398927000b328d6467ba5d Mon Sep 17 00:00:00 2001
From: Jeremy Grelle <jgrelle@vmware.com>
Date: Thu, 12 Mar 2009 14:46:50 +0000
Subject: [PATCH] Tag documentation updates.

---
 .../main/resources/META-INF/faces-config.xml  | 11 ------
 .../main/resources/META-INF/spring-faces.tld  | 39 +++++++++++++++++++
 .../resources/META-INF/springfaces.taglib.xml |  8 ----
 3 files changed, 39 insertions(+), 19 deletions(-)

diff --git a/spring-faces/src/main/resources/META-INF/faces-config.xml b/spring-faces/src/main/resources/META-INF/faces-config.xml
index a03e4bc2..b08197b6 100644
--- a/spring-faces/src/main/resources/META-INF/faces-config.xml
+++ b/spring-faces/src/main/resources/META-INF/faces-config.xml
@@ -57,11 +57,6 @@
   		<component-class>org.springframework.faces.ui.DynamicComponent</component-class>
   	</component>
   	
-  	<component>
-    	<component-type>spring.faces.DojoElementDecoration</component-type>
-    	<component-class>org.springframework.faces.ui.SpringJavascriptElementDecoration</component-class>
-  	</component>
-  	
 	<component>
     	<component-type>spring.faces.DojoClientTextValidator</component-type>
     	<component-class>org.springframework.faces.ui.DojoClientTextValidator</component-class>
@@ -119,12 +114,6 @@
 			<renderer-class>org.springframework.faces.ui.DojoWidgetRenderer</renderer-class>
 		</renderer>
 		
-		<renderer>
-			<component-family>spring.faces.Decoration</component-family>
-			<renderer-type>spring.faces.DojoElementDecorationRenderer</renderer-type>
-			<renderer-class>org.springframework.faces.ui.DojoElementDecorationRenderer</renderer-class>
-		</renderer>
-		
 		<renderer>
 			<component-family>spring.faces.DynamicComponent</component-family>
 			<renderer-type>spring.faces.ValidateAllRenderer</renderer-type>
diff --git a/spring-faces/src/main/resources/META-INF/spring-faces.tld b/spring-faces/src/main/resources/META-INF/spring-faces.tld
index 0d5fe59d..0378fd7a 100644
--- a/spring-faces/src/main/resources/META-INF/spring-faces.tld
+++ b/spring-faces/src/main/resources/META-INF/spring-faces.tld
@@ -19,7 +19,46 @@
         <name>includeStyles</name>
         <tag-class></tag-class>
         <body-content>empty</body-content>
+        <attribute>
+            <description>
+                <![CDATA[<p>The dojo theme to include when importing the CSS stylesheets.</p>  
+                <p>This can be either one of the pre-packaged Dojo themes or it can be a completely custom one that follows
+                the necessary Dojo conventions.</p>]]>
+            </description>
+            <name>theme</name>
+            <required>false</required>
+            <deferred-value>
+                <type>java.lang.String</type>
+            </deferred-value>
+        </attribute>
+        <attribute>
+            <description>
+                <![CDATA[<p>The path to the Dojo theme to include when importing the CSS stylesheets.  Defaults to 
+                /dijit/themes/</p>  
+                <p>Note that the theme name will be appended to any specified path.  For example, if you have 
+                a modified version of the Dojo Tundra theme located at the path /customTheme/tundra/, the proper
+                value of the themePath attribute would be "/customTheme/".</p>]]>
+            </description>
+            <name>themePath</name>
+            <required>false</required>
+            <deferred-value>
+                <type>java.lang.String</type>
+            </deferred-value>
+        </attribute>
     </tag>
+    
+    <tag>
+        <description>
+            <![CDATA[<p>Renders the necessary JavaScript file includes for the Spring Faces components.</p>  
+            <p>Use of this tag in the head section of a page that contains the Spring Faces components is recommended 
+            as a browser performance optimization in keeping with the <a href="http://developer.yahoo.com/performance/">
+            Yahoo performance guidelines</a>.  If this tag is not included, the script includes will be rendered 
+            inline with the first instance of a Spring Faces component that requires theme.</p>]]>
+        </description>
+        <name>includeScripts</name>
+        <tag-class></tag-class>
+        <body-content>empty</body-content>
+    </tag>     
 
     <tag>
         <description>
diff --git a/spring-faces/src/main/resources/META-INF/springfaces.taglib.xml b/spring-faces/src/main/resources/META-INF/springfaces.taglib.xml
index b686602e..7eea480e 100644
--- a/spring-faces/src/main/resources/META-INF/springfaces.taglib.xml
+++ b/spring-faces/src/main/resources/META-INF/springfaces.taglib.xml
@@ -54,14 +54,6 @@
 		</component>
 	</tag>
 	
-	<tag>
-		<tag-name>elementDecoration</tag-name>
-		<component>
-			<component-type>spring.faces.DojoElementDecoration</component-type>
-			<renderer-type>spring.faces.DojoElementDecorationRenderer</renderer-type>
-		</component>
-	</tag>
-	
 	<tag>
 		<tag-name>clientTextValidator</tag-name>
 		<component>