You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@myfaces.apache.org by lu...@apache.org on 2008/05/24 20:17:59 UTC

svn commit: r659857 [3/4] - in /myfaces/core/trunk: api/ api/src/main/java/javax/faces/component/ api/src/main/java/javax/faces/component/html/ api/src/main/java/javax/faces/convert/ api/src/main/java/javax/faces/validator/ api/src/main/java/javax/face...

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/convert/BigIntegerConverter.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/convert/BigIntegerConverter.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/convert/BigIntegerConverter.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/convert/BigIntegerConverter.java Sat May 24 11:17:47 2008
@@ -25,6 +25,8 @@
 /**
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFConverter
+ *
  * @author Thomas Spiegl (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/convert/BooleanConverter.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/convert/BooleanConverter.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/convert/BooleanConverter.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/convert/BooleanConverter.java Sat May 24 11:17:47 2008
@@ -24,6 +24,8 @@
 /**
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFConverter
+ * 
  * @author Thomas Spiegl (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/convert/ByteConverter.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/convert/ByteConverter.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/convert/ByteConverter.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/convert/ByteConverter.java Sat May 24 11:17:47 2008
@@ -24,6 +24,8 @@
 /**
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFConverter
+ *
  * @author Thomas Spiegl (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/convert/CharacterConverter.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/convert/CharacterConverter.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/convert/CharacterConverter.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/convert/CharacterConverter.java Sat May 24 11:17:47 2008
@@ -24,6 +24,8 @@
 /**
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFConverter
+ *
  * @author Thomas Spiegl (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/convert/DateTimeConverter.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/convert/DateTimeConverter.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/convert/DateTimeConverter.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/convert/DateTimeConverter.java Sat May 24 11:17:47 2008
@@ -26,10 +26,18 @@
 import javax.faces.component.StateHolder;
 import javax.faces.component.UIComponent;
 import javax.faces.context.FacesContext;
-
 /**
+ * This tag associates a date time converter with the nearest parent UIComponent.
+ * 
+ * Unless otherwise specified, all attributes accept static values or EL expressions.
+ * 
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFConverter
+ *   name="f:convertDateTime"
+ *   bodyContent="empty"
+ *   tagClass="org.apache.myfaces.taglib.core.ConvertDateTimeTag"
+ *
  * @author Thomas Spiegl (latest modification by $Author$)
  * @version $Revision$ $Date$
  */
@@ -154,6 +162,13 @@
 	}
 
 	// GETTER & SETTER
+	
+    /**
+     * The style of the date.  Values include: default, short, medium, 
+     * long, and full.
+     * 
+     * @JSFProperty
+     */
 	public String getDateStyle() {
 		return _dateStyle != null ? _dateStyle : Style.DEFAULT.getName();
 	}
@@ -163,6 +178,11 @@
 		_dateStyle = dateStyle;
 	}
 
+    /**
+     * The name of the locale to be used, instead of the default.
+     * 
+     * @JSFProperty
+     */
 	public Locale getLocale() {
 		if (_locale != null)
 			return _locale;
@@ -174,6 +194,11 @@
 		_locale = locale;
 	}
 
+    /**
+     * A custom Date formatting pattern, in the format used by java.text.SimpleDateFormat.
+     * 
+     * @JSFProperty
+     */
 	public String getPattern() {
 		return _pattern;
 	}
@@ -182,6 +207,12 @@
 		_pattern = pattern;
 	}
 
+    /**
+     * The style of the time.  Values include:  default, short, medium, long, 
+     * and full.
+     * 
+     * @JSFProperty
+     */
 	public String getTimeStyle() {
 		return _timeStyle != null ? _timeStyle : Style.DEFAULT.getName();
 	}
@@ -191,6 +222,15 @@
 		_timeStyle = timeStyle;
 	}
 
+    /**
+     * The time zone to use instead of GMT (the default timezone). When
+     * this value is a value-binding to a TimeZone instance, that
+     * timezone is used. Otherwise this value is treated as a String
+     * containing a timezone id, ie as the ID parameter of method
+     * java.util.TimeZone.getTimeZone(String).
+     * 
+     * @JSFProperty
+     */
 	public TimeZone getTimeZone() {
 		return _timeZone != null ? _timeZone : TIMEZONE_DEFAULT;
 	}
@@ -207,6 +247,13 @@
 		_transient = aTransient;
 	}
 
+    /**
+     * Specifies whether the date, time, or both should be 
+     * parsed/formatted.  Values include:  date, time, and both.
+     * Default based on setting of timeStyle and dateStyle.
+     * 
+     * @JSFProperty
+     */
 	public String getType() {
 		return _type != null ? _type : Type.DATE.getName();
 	}

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/convert/DoubleConverter.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/convert/DoubleConverter.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/convert/DoubleConverter.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/convert/DoubleConverter.java Sat May 24 11:17:47 2008
@@ -24,6 +24,8 @@
 /**
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFConverter
+ *
  * @author Thomas Spiegl (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/convert/FloatConverter.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/convert/FloatConverter.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/convert/FloatConverter.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/convert/FloatConverter.java Sat May 24 11:17:47 2008
@@ -24,6 +24,8 @@
 /**
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFConverter
+ *
  * @author Thomas Spiegl (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/convert/IntegerConverter.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/convert/IntegerConverter.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/convert/IntegerConverter.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/convert/IntegerConverter.java Sat May 24 11:17:47 2008
@@ -24,6 +24,8 @@
 /**
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFConverter
+ *
  * @author Thomas Spiegl (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/convert/LongConverter.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/convert/LongConverter.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/convert/LongConverter.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/convert/LongConverter.java Sat May 24 11:17:47 2008
@@ -24,6 +24,8 @@
 /**
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFConverter
+ *
  * @author Thomas Spiegl (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/convert/NumberConverter.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/convert/NumberConverter.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/convert/NumberConverter.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/convert/NumberConverter.java Sat May 24 11:17:47 2008
@@ -29,8 +29,18 @@
 import java.util.Locale;
 
 /**
+ * This tag creates a number formatting converter and associates it
+ * with the nearest parent UIComponent.
+ * 
+ * Unless otherwise specified, all attributes accept static values or EL expressions.
+ * 
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFConverter
+ *   name="f:convertNumber"
+ *   bodyContent="empty"
+ *   tagClass="org.apache.myfaces.taglib.core.ConvertNumberTag"
+ *
  * @author Thomas Spiegl (latest modification by $Author$)
  * @version $Revision$ $Date$
  */
@@ -252,6 +262,12 @@
     }
 
     // GETTER & SETTER
+    
+    /**
+     * ISO 4217 currency code
+     * 
+     * @JSFProperty
+     */    
     public String getCurrencyCode()
     {
         return _currencyCode != null ?
@@ -264,6 +280,12 @@
         _currencyCode = currencyCode;
     }
 
+    /**
+     * The currency symbol used to format a currency value.  Defaults
+     * to the currency symbol for locale.
+     * 
+     * @JSFProperty
+     */
     public String getCurrencySymbol()
     {
         return _currencySymbol != null ?
@@ -276,6 +298,11 @@
         _currencySymbol = currencySymbol;
     }
 
+    /**
+     * Specifies whether output will contain grouping separators.  Default: true.
+     * 
+     * @JSFProperty
+     */
     public boolean isGroupingUsed()
     {
         return _groupingUsed;
@@ -286,6 +313,11 @@
         _groupingUsed = groupingUsed;
     }
 
+    /**
+     * Specifies whether only the integer part of the input will be parsed.  Default: false.
+     * 
+     * @JSFProperty
+     */
     public boolean isIntegerOnly()
     {
         return _integerOnly;
@@ -296,6 +328,12 @@
         _integerOnly = integerOnly;
     }
 
+    /**
+     * The name of the locale to be used, instead of the default as
+     * specified in the faces configuration file.
+     * 
+     * @JSFProperty
+     */
     public Locale getLocale()
     {
         if (_locale != null) return _locale;
@@ -308,6 +346,11 @@
         _locale = locale;
     }
 
+    /**
+     * The maximum number of digits in the fractional portion of the number.
+     * 
+     * @JSFProperty
+     */
     public int getMaxFractionDigits()
     {
         return _maxFractionDigits;
@@ -319,6 +362,11 @@
         _maxFractionDigits = maxFractionDigits;
     }
 
+    /**
+     * The maximum number of digits in the integer portion of the number.
+     * 
+     * @JSFProperty
+     */
     public int getMaxIntegerDigits()
     {
         return _maxIntegerDigits;
@@ -330,6 +378,11 @@
         _maxIntegerDigits = maxIntegerDigits;
     }
 
+    /**
+     * The minimum number of digits in the fractional portion of the number.
+     * 
+     * @JSFProperty
+     */
     public int getMinFractionDigits()
     {
         return _minFractionDigits;
@@ -341,6 +394,11 @@
         _minFractionDigits = minFractionDigits;
     }
 
+    /**
+     * The minimum number of digits in the integer portion of the number.
+     * 
+     * @JSFProperty
+     */
     public int getMinIntegerDigits()
     {
         return _minIntegerDigits;
@@ -352,6 +410,11 @@
         _minIntegerDigits = minIntegerDigits;
     }
 
+    /**
+     * A custom Date formatting pattern, in the format used by java.text.SimpleDateFormat.
+     * 
+     * @JSFProperty
+     */
     public String getPattern()
     {
         return _pattern;
@@ -372,6 +435,12 @@
         _transient = aTransient;
     }
 
+    /**
+     * The type of formatting/parsing to be performed.  Values include:
+     * number, currency, and percent.  Default: number.
+     * 
+     * @JSFProperty
+     */
     public String getType()
     {
         return _type;

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/convert/ShortConverter.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/convert/ShortConverter.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/convert/ShortConverter.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/convert/ShortConverter.java Sat May 24 11:17:47 2008
@@ -24,6 +24,8 @@
 /**
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFConverter
+ *
  * @author Thomas Spiegl (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/validator/DoubleRangeValidator.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/validator/DoubleRangeValidator.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/validator/DoubleRangeValidator.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/validator/DoubleRangeValidator.java Sat May 24 11:17:47 2008
@@ -23,8 +23,21 @@
 import javax.faces.context.FacesContext;
 
 /**
+ * Creates a validator and associateds it with the nearest parent
+ * UIComponent.  When invoked, the validator ensures that values are
+ * valid doubles that lie within the minimum and maximum values specified.
+ * 
+ * Commonly associated with a h:inputText entity.
+ * 
+ * Unless otherwise specified, all attributes accept static values or EL expressions.
+ * 
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFValidator
+ *   name="f:validateDoubleRange"
+ *   bodyContent="empty"
+ *   tagClass="org.apache.myfaces.taglib.core.ValidateDoubleRangeTag" 
+ *
  * @author Manfred Geiler (latest modification by $Author$)
  * @author Thomas Spiegl
  * @version $Revision$ $Date$
@@ -124,6 +137,12 @@
 
 
     // GETTER & SETTER
+    
+    /** 
+     * The largest value that should be considered valid.
+     * 
+     * @JSFProperty
+     */
     public double getMaximum()
     {
         return _maximum != null ? _maximum.doubleValue() : Double.MAX_VALUE;
@@ -134,6 +153,11 @@
         _maximum = new Double(maximum);
     }
 
+    /**
+     * The smallest value that should be considered valid.
+     *  
+     * @JSFProperty
+     */
     public double getMinimum()
     {
         return _minimum != null ? _minimum.doubleValue() : Double.MIN_VALUE;

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/validator/LengthValidator.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/validator/LengthValidator.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/validator/LengthValidator.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/validator/LengthValidator.java Sat May 24 11:17:47 2008
@@ -23,8 +23,22 @@
 import javax.faces.context.FacesContext;
 
 /**
+ * Creates a validator and associateds it with the nearest parent
+ * UIComponent.  When invoked, the validator ensures that values are
+ * valid strings with a length that lies within the minimum and maximum
+ * values specified.
+ * 
+ * Commonly associated with a h:inputText entity.
+ * 
+ * Unless otherwise specified, all attributes accept static values or EL expressions.
+ * 
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFValidator
+ *   name="f:validateLength"
+ *   bodyContent="empty"
+ *   tagClass="org.apache.myfaces.taglib.core.ValidateLengthTag" 
+ *
  * @author Manfred Geiler (latest modification by $Author$)
  * @author Thomas Spiegl
  * @version $Revision$ $Date$
@@ -95,6 +109,12 @@
     }
 
     // SETTER & GETTER
+    
+    /** 
+     * The largest value that should be considered valid.
+     * 
+     * @JSFProperty
+     */
     public int getMaximum()
     {
         return _maximum != null ? _maximum.intValue() : 0;
@@ -105,6 +125,11 @@
         _maximum = new Integer(maximum);
     }
 
+    /**
+     * The smallest value that should be considered valid.
+     *  
+     * @JSFProperty
+     */
     public int getMinimum()
     {
         return _minimum != null ? _minimum.intValue() : 0;

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/validator/LongRangeValidator.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/validator/LongRangeValidator.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/validator/LongRangeValidator.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/validator/LongRangeValidator.java Sat May 24 11:17:47 2008
@@ -21,10 +21,22 @@
 import javax.faces.component.StateHolder;
 import javax.faces.component.UIComponent;
 import javax.faces.context.FacesContext;
-
 /**
+ * Creates a validator and associateds it with the nearest parent
+ * UIComponent.  When invoked, the validator ensures that values
+ * are valid longs that lie within the minimum and maximum values specified.
+ * 
+ * Commonly associated with a h:inputText entity.
+ * 
+ * Unless otherwise specified, all attributes accept static values or EL expressions.
+ * 
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFValidator
+ *   name="f:validateLongRange"
+ *   bodyContent="empty"
+ *   tagClass="org.apache.myfaces.taglib.core.ValidateLongRangeTag" 
+ *
  * @author Manfred Geiler (latest modification by $Author$)
  * @author Thomas Spiegl
  * @version $Revision$ $Date$
@@ -124,6 +136,12 @@
 
 
      // GETTER & SETTER
+    
+    /** 
+     * The largest value that should be considered valid.
+     * 
+     * @JSFProperty
+     */    
     public long getMaximum()
     {
         return _maximum != null ? _maximum.longValue() : Long.MAX_VALUE;
@@ -134,6 +152,11 @@
         _maximum = new Long(maximum);
     }
 
+    /**
+     * The smallest value that should be considered valid.
+     *  
+     * @JSFProperty
+     */
     public long getMinimum()
     {
         return _minimum != null ? _minimum.longValue() : Long.MIN_VALUE;

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/webapp/AttributeTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/webapp/AttributeTag.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/webapp/AttributeTag.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/webapp/AttributeTag.java Sat May 24 11:17:47 2008
@@ -26,8 +26,35 @@
 import javax.servlet.jsp.tagext.TagSupport;
 
 /**
+ * This tag associates an attribute with the nearest parent
+ * UIComponent. 
+ * &lt;p&gt;
+ * When the value is not an EL expression, this tag has the same effect
+ * as calling component.getAttributes.put(name, value). When the attribute
+ * name specified matches a standard property of the component, that
+ * property is set. However it is also valid to assign attributes
+ * to components using any arbitrary name; the component itself won't
+ * make any use of these but other objects such as custom renderers,
+ * validators or action listeners can later retrieve the attribute
+ * from the component by name.
+ * &lt;p&gt;
+ * When the value is an EL expression, this tag has the same effect
+ * as calling component.setValueBinding. A call to method
+ * component.getAttributes().get(name) will then cause that
+ * expression to be evaluated and the result of the expression is
+ * returned, not the original EL expression string.
+ * &lt;p&gt;
+ * See the javadoc for UIComponent.getAttributes for more details.
+ * &lt;p&gt;
+ * Unless otherwise specified, all attributes accept static values
+ * or EL expressions.
+ * 
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFJspTag 
+ *   name="f:attribute"
+ *   bodyContent="empty"
+ * 
  * @author Manfred Geiler (latest modification by $Author$)
  * @version $Revision$ $Date$
  */
@@ -38,11 +65,23 @@
     private String _name;
     private String _value;
 
+    /**
+     * The name of the attribute.
+     * 
+     * @JSFJspAttribute
+     *   required="true"
+     */
     public void setName(String name)
     {
         _name = name;
     }
 
+    /**
+     * The attribute's value.
+     * 
+     * @JSFJspAttribute
+     *   required="true"
+     */
     public void setValue(String value)
     {
         _value = value;

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/webapp/ConverterTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/webapp/ConverterTag.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/webapp/ConverterTag.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/webapp/ConverterTag.java Sat May 24 11:17:47 2008
@@ -29,8 +29,15 @@
 import javax.servlet.jsp.tagext.TagSupport;
 
 /**
+ * This tag creates an instance of the specified Converter, and
+ * associates it with the nearest parent UIComponent.
+ * 
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFJspTag
+ *   name="f:converter"
+ *   bodyContent="empty"
+ *   
  * @author Manfred Geiler (latest modification by $Author$)
  * @version $Revision$ $Date$
  */
@@ -45,6 +52,12 @@
         super();
     }
 
+    /**
+     * The converter's registered ID.
+     * 
+     * @JSFJspAttribute
+     *   required="true"
+     */
     public void setConverterId(String converterId)
     {
         _converterId = converterId;

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/webapp/FacetTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/webapp/FacetTag.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/webapp/FacetTag.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/webapp/FacetTag.java Sat May 24 11:17:47 2008
@@ -22,8 +22,19 @@
 import javax.servlet.jsp.tagext.TagSupport;
 
 /**
+ * This tag adds its child as a facet of the nearest parent UIComponent.
+ * A child consisting of multiple elements should be nested within a
+ * container component (i.e., within an h:panelGroup for HTML library
+ * components).
+ * 
+ * Unless otherwise specified, all attributes accept static values or EL expressions.
+ * 
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFJspTag
+ *   name="f:facet"
+ *   bodyContent="JSP"
+ *   
  * @author Manfred Geiler (latest modification by $Author$)
  * @version $Revision$ $Date$
  */
@@ -38,6 +49,12 @@
         return _name;
     }
 
+    /**
+     * The name of the facet to be created.  This must be a static value.
+     * 
+     * @JSFJspAttribute
+     *   required="true"
+     */
     public void setName(String name)
     {
         _name = name;

Modified: myfaces/core/trunk/api/src/main/java/javax/faces/webapp/ValidatorTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/java/javax/faces/webapp/ValidatorTag.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/api/src/main/java/javax/faces/webapp/ValidatorTag.java (original)
+++ myfaces/core/trunk/api/src/main/java/javax/faces/webapp/ValidatorTag.java Sat May 24 11:17:47 2008
@@ -29,8 +29,31 @@
 import javax.servlet.jsp.tagext.TagSupport;
 
 /**
+ * Creates a validator and associates it with the nearest parent
+ * UIComponent.  During the validation phase (or the apply-request-values
+ * phase for immediate components), if the associated component has any
+ * submitted value and the conversion of that value to the required
+ * type has succeeded then the specified validator type is
+ * invoked to test the validity of the converted value.
+ * &lt;p&gt;
+ * Commonly associated with an h:inputText entity, but may be applied to
+ * any input component.
+ * &lt;p&gt;
+ * Some validators may allow the component to use attributes to define
+ * component-specific validation constraints; see the f:attribute tag.
+ * See also the "validator" attribute of all input components, which
+ * allows a component to specify an arbitrary validation &lt;i&gt;method&lt;/i&gt;
+ * (rather than a registered validation type, as this tag does).
+ * &lt;p&gt;
+ * Unless otherwise specified, all attributes accept static values
+ * or EL expressions.
+ * 
  * see Javadoc of <a href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF Specification</a>
  *
+ * @JSFJspTag
+ *   name="f:validator"
+ *   bodyContent="empty"
+ *   
  * @author Manfred Geiler (latest modification by $Author$)
  * @version $Revision$ $Date$
  */
@@ -40,6 +63,12 @@
     private static final long serialVersionUID = 8794036166323016663L;
     private String _validatorId;
 
+    /**
+     * The registered ID of the desired Validator.
+     * 
+     * @JSFJspAttribute
+     *   required="true"
+     */
     public void setValidatorId(String validatorId)
     {
         _validatorId = validatorId;

Added: myfaces/core/trunk/api/src/main/resources/META-INF/componentClass11.vm
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/api/src/main/resources/META-INF/componentClass11.vm?rev=659857&view=auto
==============================================================================
--- myfaces/core/trunk/api/src/main/resources/META-INF/componentClass11.vm (added)
+++ myfaces/core/trunk/api/src/main/resources/META-INF/componentClass11.vm Sat May 24 11:17:47 2008
@@ -0,0 +1,217 @@
+// WARNING: This file was automatically generated. Do not edit it directly,
+//          or you will lose your changes.
+/*
+ *  Licensed to the Apache Software Foundation (ASF) under one
+ *  or more contributor license agreements.  See the NOTICE file
+ *  distributed with this work for additional information
+ *  regarding copyright ownership.  The ASF licenses this file
+ *  to you under the Apache License, Version 2.0 (the
+ *  "License"); you may not use this file except in compliance
+ *  with the License.  You may obtain a copy of the License at
+ * 
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ *  Unless required by applicable law or agreed to in writing,
+ *  software distributed under the License is distributed on an
+ *  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ *  KIND, either express or implied.  See the License for the
+ *  specific language governing permissions and limitations
+ *  under the License.
+ */
+package ${component.packageName};
+
+import javax.faces.component.UIComponent;
+import javax.faces.el.ValueBinding;
+import javax.faces.context.FacesContext;
+$utils.importTagClasses($component)
+
+public class ${utils.getClassFromFullClass($component.className)} extends $component.superClassName
+#if ($component.implements)
+    implements $component.implements
+#end
+{
+#if ($component.serialuid)
+    private static final long serialVersionUID = ${component.serialuid}; 
+#end  
+
+##    static public final String COMPONENT_FAMILY =
+##        "$component.family";
+    static public final String COMPONENT_TYPE =
+        "$component.type";
+
+#if ($innersource)
+    //BEGIN CODE COPIED FROM $component.classSource 
+$innersource
+    //END CODE COPIED FROM $component.classSource
+#end
+
+    public ${utils.getClassFromFullClass($component.className)}()
+    {
+#if ($component.rendererType)
+#if ($component.rendererType == "")
+        setRendererType(null);
+#else
+        setRendererType("$component.rendererType");
+#end
+#else
+        setRendererType(null);
+#end
+    }
+
+## On myfaces 1.1 the family is inherited, so this could be commented    
+##    public String getFamily()
+##    {
+##        return COMPONENT_FAMILY;
+##    }
+    
+#set ($propertyList = ${component.propertyComponentList})
+
+#foreach( $property in $propertyList )
+#set ($field = $property.fieldName)
+#set ($type = $utils.getClassFromFullClass($property.className))
+#if($utils.getDefaultValueField($property)) 
+#set ($defaultValue = $utils.getDefaultValueField($property))
+#else
+#set ($defaultValue = false)
+#end
+    // Property: $property.name
+#if ($property.isLiteralOnly() || $property.isTagExcluded() )
+    private $type $field #if($defaultValue) = $defaultValue;#{else};#{end} 
+#else
+    private $type $field;
+#end
+#if($utils.isPrimitiveClass($type) && !$property.isTagExcluded() )
+    private boolean ${field}Set;
+    
+#if ($property.isSetMethod())
+    $property.setMethodScope boolean $utils.getPrefixedPropertyName("isSet", $property.name)()
+    {
+        return ${field}Set;
+    }
+#end
+#end
+#if($property.isLocalMethod())
+#if("boolean" == $type)
+#set ($methodName = $utils.getPrefixedPropertyName("isLocal", $property.name))
+#else
+#set ($methodName = $utils.getPrefixedPropertyName("getLocal", $property.name))
+#end
+    final $property.localMethodScope $type ${methodName}()
+    {
+        return $field;
+    }
+     
+#end
+    public $type $utils.getMethodReaderFromProperty($property.name, $type)()
+    {
+#if ($property.isTagExcluded() || $property.isLiteralOnly())
+        return $field;
+#else
+#if ($utils.isPrimitiveClass($type))
+        if (${field}Set)
+#else
+        if ($field != null)
+#end
+        {
+            return $field;
+        }
+        ValueBinding vb = getValueBinding("$property.name");
+        if (vb != null)
+        {
+#if ($utils.isPrimitiveClass($type))
+            return ($utils.castIfNecessary($type) vb.getValue(getFacesContext())).${type}Value();
+#else
+#set ($pritype = $utils.getPrimitiveType($property.className))
+#if ($utils.isPrimitiveClass($pritype))
+            Object value = vb == null ? null : vb.getValue(getFacesContext());
+            if (!(value instanceof $type)){
+                value = ${type}.valueOf(value.toString());
+            }            
+            return $utils.castIfNecessary($type) value;
+#else
+            return $utils.castIfNecessary($type) vb.getValue(getFacesContext());
+#end
+#end
+        }
+#if ($defaultValue)
+        return $defaultValue; 
+#elseif ($utils.isPrimitiveClass($type))
+        return $utils.primitiveDefaultValue($type);
+#else       
+        return null;
+#end
+#end
+    }
+
+    public void $utils.getPrefixedPropertyName("set", $property.name)($type $utils.getVariableFromName($property.name))
+    {
+        this.$field = $utils.getVariableFromName($property.name);
+#if ($utils.isPrimitiveClass($type) && !$property.isTagExcluded() )
+        this.${field}Set = true;        
+#end
+    }
+#end
+
+    public Object saveState(FacesContext facesContext)
+    {
+#set ($primitiveCount = $propertyList.size() + 1)
+#foreach( $property in $propertyList )
+#if($utils.isPrimitiveClass($property.className))
+#set ($primitiveCount = $primitiveCount + 1)
+#end
+#end
+        Object[] values = new Object[$primitiveCount];
+        values[0] = super.saveState(facesContext);
+#set ($arrayIndex = 0)
+#foreach( $property in $propertyList )
+#set ($field = $property.fieldName)
+#set ($type = $property.className)
+#set ($arrayIndex = $arrayIndex + 1)
+#if ($property.jspName == "validator" && $property.isMethodBinding() )
+        values[$arrayIndex] = saveAttachedState(facesContext,${field}List);
+#elseif ( $property.isStateHolder() )## || $utils.isConverter($type)
+        values[$arrayIndex] = saveAttachedState(facesContext,$field);
+#elseif($utils.isPrimitiveClass($type))
+        values[$arrayIndex] = ${utils.getBoxedClass($type)}.valueOf($field);
+#else
+        values[$arrayIndex] = $field;
+#end
+#if($utils.isPrimitiveClass($type) && !$property.isTagExcluded())
+#set ($arrayIndex = $arrayIndex + 1)
+        values[$arrayIndex] = Boolean.valueOf(${field}Set);
+#end
+#end
+        return values; 
+    }
+
+    public void restoreState(FacesContext facesContext, Object state)
+    {
+        Object[] values = (Object[])state;
+        super.restoreState(facesContext,values[0]);
+#set ($arrayIndex = 0)
+#foreach( $property in $propertyList )
+#set ($field = $property.fieldName)
+#set ($type = $property.className)
+#set ($arrayIndex = $arrayIndex + 1)
+#if ( $property.isStateHolder() )
+#if ($property.jspName == "validator" && $property.isMethodBinding() )
+        ${field}List = (List<Validator>) restoreAttachedState(facesContext,values[$arrayIndex]);
+#elseif ($utils.isList($type))
+        $field = (List) restoreAttachedState(facesContext,values[$arrayIndex]);
+#else
+        $field = $utils.castIfNecessary($type) restoreAttachedState(facesContext,values[$arrayIndex]); 
+#end
+#elseif ($utils.isConverter($type)) 
+        $field = (Converter) restoreAttachedState(facesContext,values[$arrayIndex]);
+#elseif ($utils.isPrimitiveClass($type))
+        $field = ($utils.castIfNecessary($type) values[$arrayIndex]).${type}Value();
+#else
+        $field = $utils.castIfNecessary($type) values[$arrayIndex];
+#end
+#if($utils.isPrimitiveClass($type) && !$property.isTagExcluded() )
+#set ($arrayIndex = $arrayIndex + 1)
+        ${field}Set = ((Boolean) values[$arrayIndex]).booleanValue();
+#end
+#end
+    }
+}

Modified: myfaces/core/trunk/impl/pom.xml
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/pom.xml?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/pom.xml (original)
+++ myfaces/core/trunk/impl/pom.xml Sat May 24 11:17:47 2008
@@ -21,6 +21,9 @@
     <resources>
       <resource>
         <directory>src/main/resources</directory>
+        <excludes>
+            <exclude>**/*.vm</exclude>
+        </excludes>
       </resource>
       <resource>
         <directory>src/main/resources-facesconfig</directory>
@@ -28,6 +31,85 @@
     </resources>
     <plugins>
       <plugin>
+        <groupId>org.apache.myfaces.buildtools</groupId>
+        <artifactId>myfaces-builder-plugin</artifactId>
+        <version>1.0.1-SNAPSHOT</version>
+        <executions>
+          <execution>
+            <goals>
+              <goal>build-metadata</goal>
+            </goals>
+          </execution>
+          <execution>
+            <id>maketags</id>
+            <configuration>
+                <packageContains>org.apache</packageContains>
+                <typePrefix>javax.faces</typePrefix>
+                <modelIds>
+                    <modelId>myfaces-api</modelId>
+                </modelIds>
+            </configuration>
+            <goals>
+                <goal>make-tags</goal>
+            </goals>
+          </execution>
+          <execution>
+          	<id>makefacesconfig</id>
+          	<configuration>
+          		<xmlFile>org/apache/myfaces/resource/standard-faces-config.xml</xmlFile>
+          		<modelIds>
+          		    <modelId>myfaces-api</modelId>
+          		    <modelId>myfaces-impl</modelId>
+          		</modelIds>
+          	</configuration>
+          	<goals>
+          		<goal>make-config</goal>
+          	</goals>
+          </execution>
+          <execution>
+            <id>makehtmltld</id>
+            <configuration>
+                <xmlFile>META-INF/myfaces_html.tld</xmlFile>
+                <xmlBaseFile>src/main/conf/META-INF/myfaces_html-base.tld</xmlBaseFile>
+                <templateFile>myfaces_html.vm</templateFile>
+                <params>
+                   <shortname>h</shortname>
+                   <uri>http://java.sun.com/jsf/html</uri>
+                   <displayname>JSF HTML tag library.</displayname>
+                   <description>This tag library implements the standard JSF HTML tags.</description>
+                </params>
+                <modelIds>
+                    <modelId>myfaces-api</modelId>
+                </modelIds>
+            </configuration>
+            <goals>
+                <goal>make-config</goal>
+            </goals>
+          </execution>
+          <execution>
+            <id>makecoretld</id>
+            <configuration>
+                <xmlFile>META-INF/myfaces_core.tld</xmlFile>
+                <xmlBaseFile>src/main/conf/META-INF/myfaces_core-base.tld</xmlBaseFile>
+                <templateFile>myfaces_core.vm</templateFile>
+                <modelIds>
+                    <modelId>myfaces-api</modelId>
+                    <modelId>myfaces-impl</modelId>
+                </modelIds>
+                <params>
+                    <shortname>f</shortname>
+                    <uri>http://java.sun.com/jsf/core</uri>
+                    <displayname>JSF core tag library.</displayname>
+                    <description>This tag library implements the standard JSF core tags.</description>
+                </params>
+            </configuration>
+            <goals>
+                <goal>make-config</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>        
+      <plugin>
         <artifactId>maven-source-plugin</artifactId>
         <version>2.0.4</version>
         <executions>
@@ -40,6 +122,7 @@
         </executions>
       </plugin>
  
+      <!-- 
       <plugin>
         <groupId>org.codehaus.mojo</groupId>
         <artifactId>xslt-maven-plugin</artifactId>
@@ -58,6 +141,7 @@
           <destDir>target/classes/META-INF</destDir>
         </configuration>
       </plugin>
+       -->
       <plugin>
         <!--
           - The shared-impl project generates a modified version of the "shared" module
@@ -144,6 +228,7 @@
       <id>generate-site</id>
       <build>
         <plugins>
+          <!-- 
           <plugin>
             <groupId>org.codehaus.mojo</groupId>
             <artifactId>xslt-maven-plugin</artifactId>
@@ -175,6 +260,36 @@
               </execution>
             </executions>
           </plugin>
+           -->
+           <!-- 
+	      <plugin>
+	        <groupId>org.apache.myfaces.buildtools</groupId>
+	        <artifactId>myfaces-builder-plugin</artifactId>
+	        <version>1.0.1-SNAPSHOT</version>
+	        <executions>
+	          <execution>
+	            <goals>
+	              <goal>build-metadata</goal>
+	            </goals>
+	          </execution>
+	          <execution>
+	            <id>makehtmltld</id>
+	            <configuration>
+	                <xmlFile>classes/META-INF/myfaces_html.tld</xmlFile>
+	                <xmlBaseFile>src/main/conf/META-INF/myfaces_html-base.tld</xmlBaseFile>
+	                <templateFile>myfaces_html.vm</templateFile>
+	                
+	                <modelIds>
+	                    <modelId>myfaces-api</modelId>
+	                </modelIds>
+	            </configuration>
+	            <goals>
+	                <goal>make-config</goal>
+	            </goals>
+	          </execution>          
+	        </executions>
+	      </plugin>
+	       -->           
         </plugins>
       </build>
       <reporting>
@@ -183,7 +298,7 @@
             <groupId>net.sourceforge.maven-taglib</groupId>
             <artifactId>maven-taglib-plugin</artifactId>
             <configuration>
-              <taglib.src.dir>${basedir}/target/tlddoc-site</taglib.src.dir>
+              <taglib.src.dir>${basedir}/target/classes/META-INF</taglib.src.dir>
               <tldDocDir>${basedir}/target/site/tlddoc</tldDocDir>
             </configuration>
           </plugin>
@@ -208,6 +323,7 @@
       </activation>
       <build>
         <plugins>
+          <!-- 
           <plugin>
             <groupId>org.codehaus.mojo</groupId>
             <artifactId>xslt-maven-plugin</artifactId>
@@ -239,6 +355,7 @@
               </execution>
             </executions>
           </plugin>
+           -->
           <plugin>
             <artifactId>maven-javadoc-plugin</artifactId>
             <version>2.3</version>
@@ -264,7 +381,7 @@
               </execution>
             </executions>
             <configuration>
-              <taglib.src.dir>${basedir}/target/tlddoc-site</taglib.src.dir>
+              <taglib.src.dir>${basedir}/target/classes/META-INF</taglib.src.dir>
               <tldDocDir>${basedir}/target/tlddoc</tldDocDir>
             </configuration>
           </plugin>

Modified: myfaces/core/trunk/impl/src/main/conf/META-INF/faces-config-base.xml
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/conf/META-INF/faces-config-base.xml?rev=659857&r1=659752&r2=659857&view=diff
==============================================================================
    (empty)

Modified: myfaces/core/trunk/impl/src/main/conf/META-INF/myfaces_core-base.tld
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/conf/META-INF/myfaces_core-base.tld?rev=659857&r1=659752&r2=659857&view=diff
==============================================================================
    (empty)

Modified: myfaces/core/trunk/impl/src/main/conf/META-INF/myfaces_html-base.tld
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/conf/META-INF/myfaces_html-base.tld?rev=659857&r1=659752&r2=659857&view=diff
==============================================================================
    (empty)

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlButtonRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlButtonRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlButtonRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlButtonRenderer.java Sat May 24 11:17:47 2008
@@ -22,6 +22,12 @@
 
 
 /**
+ * 
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Command"
+ *   type="javax.faces.Button"
+ * 
  * @author Manfred Geiler (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlCheckboxRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlCheckboxRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlCheckboxRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlCheckboxRenderer.java Sat May 24 11:17:47 2008
@@ -22,6 +22,17 @@
 
 
 /**
+ * 
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.SelectBoolean"
+ *   type="javax.faces.Checkbox"
+ *   
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.SelectMany"
+ *   type="javax.faces.Checkbox"
+ *
  * @author Thomas Spiegl (latest modification by $Author$)
  * @author Anton Koinov
  * @version $Revision$ $Date$

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlFormRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlFormRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlFormRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlFormRenderer.java Sat May 24 11:17:47 2008
@@ -22,6 +22,12 @@
 
 
 /**
+ * 
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Form"
+ *   type="javax.faces.Form"
+ *   
  * @author Manfred Geiler (latest modification by $Author$)
  * @author Thomas Spiegl
  * @author Anton Koinov

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlFormatRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlFormatRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlFormatRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlFormatRenderer.java Sat May 24 11:17:47 2008
@@ -38,6 +38,11 @@
 import java.util.List;
 
 /**
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Output"
+ *   type="javax.faces.Format"
+ * 
  * @author Manfred Geiler (latest modification by $Author$)
  * @author Thomas Spiegl
  * @version $Revision$ $Date$

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlGridRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlGridRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlGridRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlGridRenderer.java Sat May 24 11:17:47 2008
@@ -24,6 +24,11 @@
 /**
  * X-CHECKED: tlddoc h:panelGrid 1.0 final
  *
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Panel"
+ *   type="javax.faces.Grid"
+ *
  * @author Manfred Geiler (latest modification by $Author$)
  * @author Thomas Spiegl
  * @version $Revision$ $Date$

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlGroupRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlGroupRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlGroupRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlGroupRenderer.java Sat May 24 11:17:47 2008
@@ -22,6 +22,11 @@
 
 
 /**
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Panel"
+ *   type="javax.faces.Group"
+ *   
  * @author Thomas Spiegl (latest modification by $Author$)
  * @author Manfred Geiler
  * @version $Revision$ $Date$

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlHiddenRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlHiddenRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlHiddenRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlHiddenRenderer.java Sat May 24 11:17:47 2008
@@ -34,6 +34,11 @@
 
 
 /**
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Input"
+ *   type="javax.faces.Hidden"
+ *   
  * @author Thomas Spiegl (latest modification by $Author$)
  * @author Anton Koinov
  * @version $Revision$ $Date$

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlImageRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlImageRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlImageRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlImageRenderer.java Sat May 24 11:17:47 2008
@@ -22,6 +22,11 @@
 
 
 /**
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Graphic"
+ *   type="javax.faces.Image"
+ *   
  * @author Thomas Spiegl (latest modification by $Author$)
  * @author Anton Koinov
  * @version $Revision$ $Date$

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlLabelRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlLabelRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlLabelRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlLabelRenderer.java Sat May 24 11:17:47 2008
@@ -36,6 +36,11 @@
 
 
 /**
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Output"
+ *   type="javax.faces.Label"
+ *   
  * @author Thomas Spiegl (latest modification by $Author$)
  * @author Anton Koinov
  * @author Martin Marinschek

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlLinkRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlLinkRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlLinkRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlLinkRenderer.java Sat May 24 11:17:47 2008
@@ -22,6 +22,16 @@
 
 
 /**
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Output"
+ *   type="javax.faces.Link"
+ *   
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Command"
+ *   type="javax.faces.Link"
+ * 
  * @author Manfred Geiler (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlListboxRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlListboxRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlListboxRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlListboxRenderer.java Sat May 24 11:17:47 2008
@@ -22,6 +22,16 @@
 
 
 /**
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.SelectOne"
+ *   type="javax.faces.Listbox"
+ *   
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.SelectMany"
+ *   type="javax.faces.Listbox"
+ *   
  * @author Manfred Geiler (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlMenuRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlMenuRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlMenuRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlMenuRenderer.java Sat May 24 11:17:47 2008
@@ -22,6 +22,16 @@
 
 
 /**
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.SelectOne"
+ *   type="javax.faces.Menu"
+ *   
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.SelectMany"
+ *   type="javax.faces.Menu"
+ *   
  * @author Manfred Geiler (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlMessageRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlMessageRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlMessageRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlMessageRenderer.java Sat May 24 11:17:47 2008
@@ -26,6 +26,11 @@
 import java.io.IOException;
 
 /**
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Message"
+ *   type="javax.faces.Message"
+ * 
  * @author Manfred Geiler (latest modification by $Author$)
  * @author Thomas Spiegl
  * @version $Revision$ $Date$

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlMessagesRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlMessagesRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlMessagesRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlMessagesRenderer.java Sat May 24 11:17:47 2008
@@ -26,7 +26,10 @@
 import java.io.IOException;
 
 /**
- *
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Messages"
+ *   type="javax.faces.Messages"
  *
  * @author Manfred Geiler (latest modification by $Author$)
  * @author Thomas Spiegl

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlRadioRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlRadioRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlRadioRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlRadioRenderer.java Sat May 24 11:17:47 2008
@@ -22,6 +22,11 @@
 
 
 /**
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.SelectOne"
+ *   type="javax.faces.Radio"
+ * 
  * @author Manfred Geiler (latest modification by $Author$)
  * @author Thomas Spiegl
  * @version $Revision$ $Date$

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlRenderKitImpl.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlRenderKitImpl.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlRenderKitImpl.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlRenderKitImpl.java Sat May 24 11:17:47 2008
@@ -35,6 +35,9 @@
 
 
 /**
+ * @JSFRenderKit
+ *   renderKitId = "HTML_BASIC"
+ * 
  * @author Manfred Geiler (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlSecretRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlSecretRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlSecretRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlSecretRenderer.java Sat May 24 11:17:47 2008
@@ -22,6 +22,11 @@
 
 
 /**
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Input"
+ *   type="javax.faces.Secret"
+ *   
  * @author Manfred Geiler (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlTableRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlTableRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlTableRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlTableRenderer.java Sat May 24 11:17:47 2008
@@ -22,6 +22,11 @@
 
 
 /**
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Data"
+ *   type="javax.faces.Table"
+ * 
  * @author Thomas Spiegl (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlTextRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlTextRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlTextRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlTextRenderer.java Sat May 24 11:17:47 2008
@@ -22,6 +22,16 @@
 
 
 /**
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Input"
+ *   type="javax.faces.Text"
+ *   
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Output"
+ *   type="javax.faces.Text"
+ *   
  * @author Manfred Geiler (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlTextareaRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlTextareaRenderer.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlTextareaRenderer.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/renderkit/html/HtmlTextareaRenderer.java Sat May 24 11:17:47 2008
@@ -22,6 +22,11 @@
 
 
 /**
+ * @JSFRenderer
+ *   renderKitId="HTML_BASIC"
+ *   family="javax.faces.Input"
+ *   type="javax.faces.Textarea"
+ *   
  * @author Manfred Geiler (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/ActionListenerTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/ActionListenerTag.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/ActionListenerTag.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/ActionListenerTag.java Sat May 24 11:17:47 2008
@@ -29,8 +29,17 @@
 import javax.servlet.jsp.JspException;
 import javax.servlet.jsp.tagext.Tag;
 import javax.servlet.jsp.tagext.TagSupport;
-
 /**
+ * This tag creates an instance of the specified ActionListener, and
+ * associates it with the nearest parent UIComponent.
+ * 
+ * Unless otherwise specified, all attributes accept static values
+ * or EL expressions.
+ * 
+ * @JSFJspTag
+ *   name="f:actionListener"
+ *   bodyContent="empty"
+ *   
  * @author Manfred Geiler (latest modification by $Author$)
  * @version $Revision$ $Date$
  */
@@ -45,6 +54,12 @@
     {
     }
 
+    /**
+     * The fully qualified class name of the ActionListener class.
+     * 
+     * @JSFJspAttribute
+     *   required="true"
+     */
     public void setType(String type)
     {
         _type = type;

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/LoadBundleTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/LoadBundleTag.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/LoadBundleTag.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/LoadBundleTag.java Sat May 24 11:17:47 2008
@@ -38,13 +38,14 @@
 
 import org.apache.commons.logging.Log;
 import org.apache.commons.logging.LogFactory;
-
 /**
- * TODO:
- * We should find a way to save loaded bundles in the state, because otherwise
- * on the next request the bundle map will not be present before the render phase
- * and value bindings that reference to the bundle will always log annoying
- * "Variable 'xxx' could not be resolved" error messages.
+ * Loads a resource bundle and saves it as a variable in the request scope.
+ * 
+ * Unless otherwise specified, all attributes accept static values or EL expressions.
+ * 
+ * @JSFJspTag
+ *   name="f:loadBundle"
+ *   bodyContent="empty"
  *
  * @author Manfred Geiler (latest modification by $Author$)
  * @version $Revision$ $Date$
@@ -52,6 +53,14 @@
 public class LoadBundleTag
         extends TagSupport
 {
+ /*
+ * TODO:
+ * We should find a way to save loaded bundles in the state, because otherwise
+ * on the next request the bundle map will not be present before the render phase
+ * and value bindings that reference to the bundle will always log annoying
+ * "Variable 'xxx' could not be resolved" error messages.
+ */
+    
     private static final long serialVersionUID = -8892145684062838928L;
 
     private static final Log log = LogFactory.getLog(LoadBundleTag.class);
@@ -59,11 +68,24 @@
     private String _basename;
     private String _var;
 
+    /**
+     * The base name of the resource bundle.
+     * 
+     * @JSFJspAttribute
+     *   required="true"
+     */
     public void setBasename(String basename)
     {
         _basename = basename;
     }
 
+    /**
+     * The name of the variable in request scope that the resources
+     * are saved to.  This must be a static value.
+     *  
+     * @JSFJspAttribute
+     *   required="true"
+     */
     public void setVar(String var)
     {
         _var = var;

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/SubviewTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/SubviewTag.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/SubviewTag.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/SubviewTag.java Sat May 24 11:17:47 2008
@@ -22,6 +22,30 @@
 import javax.faces.component.UINamingContainer;
 
 /**
+ * This tag associates a set of UIComponents with the nearest parent
+ * UIComponent.  It acts as a naming container to make the IDs of its
+ * component elements unique.
+ * 
+ * Unless otherwise specified, all attributes accept static values or EL expressions.
+ * 
+ * @JSFJspTag
+ *   name="f:subview"
+ *   bodyContent="JSP" 
+ * @JSFJspAttribute
+ *   name="id"
+ *   className="java.lang.String"
+ *   required="true"
+ *   longDescription="The developer-assigned ID of this component."
+ * @JSFJspAttribute
+ *   name="binding"
+ *   className="java.lang.String"
+ *   longDescription="Identifies a backing bean property to bind to this component instance."
+ * @JSFJspAttribute
+ *   name="rendered"
+ *   className="java.lang.String"
+ *   longDescription="A boolean value that indicates whether this component should be rendered."
+ *   
+ *   
  * @author Thomas Spiegl (latest modification by $Author$)
  * @version $Revision$ $Date$
  */

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/ValueChangeListenerTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/ValueChangeListenerTag.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/ValueChangeListenerTag.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/ValueChangeListenerTag.java Sat May 24 11:17:47 2008
@@ -31,6 +31,23 @@
 import javax.servlet.jsp.tagext.TagSupport;
 
 /**
+ * Adds the specified ValueChangeListener to the nearest parent
+ * UIComponent (which is expected to be a UIInput component).
+ * Whenever the form containing the parent UIComponent is submitted,
+ * an instance of the specified type is created. If the submitted
+ * value from the component is different from the component's current
+ * value then a ValueChangeEvent is queued. When the ValueChangeEvent
+ * is processed (at end of the validate phase for non-immediate components,
+ * or at end of the apply-request-values phase for immediate components)
+ * the object's processValueChange method is invoked.
+ * &lt;p&gt;
+ * Unless otherwise specified, all attributes accept static values
+ * or EL expressions.
+ * 
+ * @JSFJspTag
+ *   name="f:valueChangeListener"
+ *   bodyContent="empty"
+ *   
  * @author Manfred Geiler (latest modification by $Author$)
  * @version $Revision$ $Date$
  */
@@ -46,6 +63,11 @@
     {
     }
 
+    /**
+     * The name of a Java class that implements ValueChangeListener.
+     * 
+     * @JSFJspAttribute
+     */
     public void setType(String type)
     {
         _type = type;

Modified: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/VerbatimTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/VerbatimTag.java?rev=659857&r1=659856&r2=659857&view=diff
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/VerbatimTag.java (original)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/core/VerbatimTag.java Sat May 24 11:17:47 2008
@@ -27,6 +27,17 @@
 import javax.servlet.jsp.tagext.BodyContent;
 
 /**
+ * Outputs its body as verbatim text. No JSP tags within the verbatim
+ * tag (including JSF tags) are evaluated; the content is treated
+ * simply as literal text to be copied to the response.
+ * &lt;p&gt;
+ * Unless otherwise specified, all attributes accept static values
+ * or EL expressions.
+ * 
+ * @JSFJspTag
+ *   name="f:verbatim"
+ *   bodyContent="JSP" 
+ *   
  * @author Manfred Geiler (latest modification by $Author$)
  * @version $Revision$ $Date$
  */
@@ -66,6 +77,11 @@
         component.setTransient(true);
     }
 
+    /**
+     * If true, generated markup is escaped.  Default:  false.
+     * 
+     * @JSFJspAttribute
+     */
     public void setEscape(String escape)
     {
         _escape = escape;

Added: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlColumnTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlColumnTag.java?rev=659857&view=auto
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlColumnTag.java (added)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlColumnTag.java Sat May 24 11:17:47 2008
@@ -0,0 +1,44 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.myfaces.taglib.html;
+
+import org.apache.myfaces.shared_impl.taglib.html.HtmlComponentBodyTagBase;
+
+import javax.faces.component.UIColumn;
+
+
+/**
+ * @author Thomas Spiegl (latest modification by $Author$)
+ * @version $Revision$ $Date$
+ */
+public class _HtmlColumnTag
+        extends HtmlComponentBodyTagBase
+{
+    public String getComponentType()
+    {
+        return UIColumn.COMPONENT_TYPE;
+    }
+
+    public String getRendererType()
+    {
+        return null;
+    }
+
+    // UIComponent attributes --> already implemented in UIComponentTagBase
+}

Propchange: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlColumnTag.java
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlColumnTag.java
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlCommandButtonTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlCommandButtonTag.java?rev=659857&view=auto
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlCommandButtonTag.java (added)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlCommandButtonTag.java Sat May 24 11:17:47 2008
@@ -0,0 +1,43 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.myfaces.taglib.html;
+
+import org.apache.myfaces.shared_impl.taglib.html.HtmlCommandButtonTagBase;
+
+import javax.faces.component.html.HtmlCommandButton;
+
+
+/**
+ * @author Manfred Geiler (latest modification by $Author$)
+ * @author Martin Marinschek
+ * @version $Revision$ $Date$
+ */
+public class _HtmlCommandButtonTag
+    extends HtmlCommandButtonTagBase
+{
+    public String getComponentType()
+    {
+        return HtmlCommandButton.COMPONENT_TYPE;
+    }
+
+    public String getRendererType()
+    {
+        return "javax.faces.Button";
+    }
+}

Propchange: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlCommandButtonTag.java
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlCommandButtonTag.java
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlCommandLinkTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlCommandLinkTag.java?rev=659857&view=auto
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlCommandLinkTag.java (added)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlCommandLinkTag.java Sat May 24 11:17:47 2008
@@ -0,0 +1,43 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.myfaces.taglib.html;
+
+import org.apache.myfaces.shared_impl.taglib.html.HtmlCommandLinkTagBase;
+
+import javax.faces.component.html.HtmlCommandLink;
+
+
+/**
+ * @author Manfred Geiler (latest modification by $Author$)
+ * @author Martin Marinschek
+ * @version $Revision$ $Date$
+ */
+public class _HtmlCommandLinkTag
+    extends HtmlCommandLinkTagBase
+{
+    public String getComponentType()
+    {
+        return HtmlCommandLink.COMPONENT_TYPE;
+    }
+
+    public String getRendererType()
+    {
+        return "javax.faces.Link";
+    }
+}

Propchange: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlCommandLinkTag.java
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlCommandLinkTag.java
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlDataTableTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlDataTableTag.java?rev=659857&view=auto
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlDataTableTag.java (added)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlDataTableTag.java Sat May 24 11:17:47 2008
@@ -0,0 +1,41 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.myfaces.taglib.html;
+
+import org.apache.myfaces.shared_impl.taglib.html.HtmlDataTableTagBase;
+
+import javax.faces.component.html.HtmlDataTable;
+
+/**
+ * @author Thomas Spiegl (latest modification by $Author$)
+ * @version $Revision$ $Date$
+ */
+public class _HtmlDataTableTag
+        extends HtmlDataTableTagBase
+{
+    public String getComponentType()
+    {
+        return HtmlDataTable.COMPONENT_TYPE;
+    }
+
+    public String getRendererType()
+    {
+        return "javax.faces.Table";
+    }
+}

Propchange: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlDataTableTag.java
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlDataTableTag.java
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlFormTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlFormTag.java?rev=659857&view=auto
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlFormTag.java (added)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlFormTag.java Sat May 24 11:17:47 2008
@@ -0,0 +1,41 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.myfaces.taglib.html;
+
+import org.apache.myfaces.shared_impl.taglib.html.HtmlFormTagBase;
+
+import javax.faces.component.html.HtmlForm;
+
+/**
+ * @author Manfred Geiler (latest modification by $Author$)
+ * @version $Revision$ $Date$
+ */
+public class _HtmlFormTag
+        extends HtmlFormTagBase
+{
+    public String getComponentType()
+    {
+        return HtmlForm.COMPONENT_TYPE;
+    }
+
+    public String getRendererType()
+    {
+        return "javax.faces.Form";
+    }
+}

Propchange: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlFormTag.java
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlFormTag.java
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlGraphicImageTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlGraphicImageTag.java?rev=659857&view=auto
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlGraphicImageTag.java (added)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlGraphicImageTag.java Sat May 24 11:17:47 2008
@@ -0,0 +1,43 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.myfaces.taglib.html;
+
+import org.apache.myfaces.shared_impl.taglib.html.HtmlGraphicImageTagBase;
+
+import javax.faces.component.html.HtmlGraphicImage;
+
+
+/**
+ * @author Manfred Geiler (latest modification by $Author$)
+ * @author Martin Marinschek
+ * @version $Revision$ $Date$
+ */
+public class _HtmlGraphicImageTag
+    extends HtmlGraphicImageTagBase
+{
+    public String getComponentType()
+    {
+        return HtmlGraphicImage.COMPONENT_TYPE;
+    }
+
+    public String getRendererType()
+    {
+        return "javax.faces.Image";
+    }
+}

Propchange: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlGraphicImageTag.java
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlGraphicImageTag.java
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlInputHiddenTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlInputHiddenTag.java?rev=659857&view=auto
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlInputHiddenTag.java (added)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlInputHiddenTag.java Sat May 24 11:17:47 2008
@@ -0,0 +1,37 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.myfaces.taglib.html;
+
+import org.apache.myfaces.shared_impl.taglib.html.HtmlInputHiddenTagBase;
+
+import javax.faces.component.html.HtmlInputHidden;
+
+/**
+ * @author Manfred Geiler
+ * @author Martin Marinschek
+ * @version $Revision$ $Date$
+ */
+public class _HtmlInputHiddenTag
+        extends HtmlInputHiddenTagBase
+{
+    public String getComponentType()
+    {
+        return HtmlInputHidden.COMPONENT_TYPE;
+    }
+}

Propchange: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlInputHiddenTag.java
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlInputHiddenTag.java
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Added: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlInputSecretTag.java
URL: http://svn.apache.org/viewvc/myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlInputSecretTag.java?rev=659857&view=auto
==============================================================================
--- myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlInputSecretTag.java (added)
+++ myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlInputSecretTag.java Sat May 24 11:17:47 2008
@@ -0,0 +1,43 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.myfaces.taglib.html;
+
+import org.apache.myfaces.shared_impl.taglib.html.HtmlInputSecretTagBase;
+
+import javax.faces.component.html.HtmlInputSecret;
+
+
+/**
+ * @author Manfred Geiler (latest modification by $Author$)
+ * @author Martin Marinschek
+ * @version $Revision$ $Date$
+ */
+public class _HtmlInputSecretTag
+        extends HtmlInputSecretTagBase
+{
+    public String getComponentType()
+    {
+        return HtmlInputSecret.COMPONENT_TYPE;
+    }
+
+    public String getRendererType()
+    {
+        return "javax.faces.Secret";
+    }
+}

Propchange: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlInputSecretTag.java
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: myfaces/core/trunk/impl/src/main/java/org/apache/myfaces/taglib/html/_HtmlInputSecretTag.java
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL