jakarta-taglibs-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From pier...@apache.org
Subject cvs commit: jakarta-taglibs/standard/conf x.tld fmt.tld c.tld sql.tld
Date Mon, 04 Aug 2003 22:30:40 GMT
pierred     2003/08/04 15:30:40

  Modified:    standard/conf x.tld fmt.tld c.tld sql.tld
  Log:
  Added descriptions in the TLDs.
  
  Revision  Changes    Path
  1.16      +153 -0    jakarta-taglibs/standard/conf/x.tld
  
  Index: x.tld
  ===================================================================
  RCS file: /home/cvs/jakarta-taglibs/standard/conf/x.tld,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -r1.15 -r1.16
  --- x.tld	2 Apr 2003 20:50:50 -0000	1.15
  +++ x.tld	4 Aug 2003 22:30:40 -0000	1.16
  @@ -39,11 +39,20 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.xml.ExprTag</tag-class>
       <body-content>empty</body-content>
       <attribute>
  +        <description>
  +XPath expression to be evaluated.
  +        </description>
           <name>select</name>
           <required>true</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Determines whether characters &lt;,&gt;,&amp;,'," in the
  +resulting string should be converted to their
  +corresponding character entity codes. Default
  +value is true.
  +        </description>
           <name>escapeXml</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -59,16 +68,28 @@
       <tag-class>org.apache.taglibs.standard.tag.common.xml.IfTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +The test condition that tells whether or not the
  +body content should be processed.
  +        </description>
           <name>select</name>
           <required>true</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable for the
  +resulting value of the test condition. The type
  +of the scoped variable is Boolean.
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope for var.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
  @@ -83,34 +104,62 @@
       <tag-class>org.apache.taglibs.standard.tag.common.xml.ForEachTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Name of the exported scoped variable for the
  +current item of the iteration. This scoped variable
  +has nested visibility. Its type depends on the
  +result of the XPath expression in the select
  +attribute.
  +        </description>
   	<name>var</name>
   	<required>false</required>
   	<rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +XPath expression to be evaluated.
  +        </description>
   	<name>select</name>
   	<required>true</required>
   	<rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Iteration begins at the item located at the
  +specified index. First item of the collection has
  +index 0.
  +        </description>
   	<name>begin</name>
   	<required>false</required>
   	<rtexprvalue>true</rtexprvalue>
   	<type>int</type>
       </attribute>
       <attribute>
  +        <description>
  +Iteration ends at the item located at the specified
  +index (inclusive).
  +        </description>
   	<name>end</name>
   	<required>false</required>
   	<rtexprvalue>true</rtexprvalue>
   	<type>int</type>
       </attribute>
       <attribute>
  +        <description>
  +Iteration will only process every step items of
  +the collection, starting with the first one.
  +        </description>
   	<name>step</name>
   	<required>false</required>
   	<rtexprvalue>true</rtexprvalue>
   	<type>int</type>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable for the
  +status of the iteration. Object exported is of type
  +javax.servlet.jsp.jstl.core.LoopTagStatus. This scoped variable has nested visibility.
  +        </description>
   	<name>varStatus</name>
   	<required>false</required>
   	<rtexprvalue>false</rtexprvalue>
  @@ -136,11 +185,17 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.xml.ParamTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Name of the transformation parameter.
  +        </description>
           <name>name</name>
           <required>true</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Value of the parameter.
  +        </description>
           <name>value</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -156,41 +211,73 @@
       <tei-class>org.apache.taglibs.standard.tei.XmlParseTEI</tei-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Name of the exported scoped variable for
  +the parsed XML document. The type of the
  +scoped variable is implementation
  +dependent.
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable for
  +the parsed XML document. The type of the
  +scoped variable is
  +org.w3c.dom.Document.
  +        </description>
           <name>varDom</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope for var.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope for varDom.
  +        </description>
           <name>scopeDom</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Deprecated. Use attribute 'doc' instead.
  +        </description>
           <name>xml</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Source XML document to be parsed.
  +        </description>
           <name>doc</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +The system identifier (URI) for parsing the
  +XML document.
  +        </description>
           <name>systemId</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Filter to be applied to the source
  +document.
  +        </description>
           <name>filter</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -205,16 +292,28 @@
       <tag-class>org.apache.taglibs.standard.tag.common.xml.SetTag</tag-class>
       <body-content>empty</body-content>
       <attribute>
  +        <description>
  +Name of the exported scoped variable to hold
  +the value specified in the action. The type of the
  +scoped variable is whatever type the select
  +expression evaluates to.
  +        </description>
           <name>var</name>
           <required>true</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +XPath expression to be evaluated.
  +        </description>
   	<name>select</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope for var.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
  @@ -231,46 +330,95 @@
       <tei-class>org.apache.taglibs.standard.tei.XmlTransformTEI</tei-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Name of the exported
  +scoped variable for the
  +transformed XML
  +document. The type of the
  +scoped variable is
  +org.w3c.dom.Document.
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope for var.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Result
  +Object that captures or
  +processes the transformation
  +result.
  +        </description>
           <name>result</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Deprecated. Use attribute
  +'doc' instead.
  +        </description>
           <name>xml</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Source XML document to be
  +transformed. (If exported by
  +&lt;x:set&gt;, it must correspond
  +to a well-formed XML
  +document, not a partial
  +document.)
  +        </description>
           <name>doc</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Deprecated. Use attribute
  +'docSystemId' instead.
  +        </description>
           <name>xmlSystemId</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +The system identifier (URI)
  +for parsing the XML
  +document.
  +        </description>
           <name>docSystemId</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +javax.xml.transform.Source
  +Transformation stylesheet as
  +a String, Reader, or
  +Source object.
  +        </description>
   	<name>xslt</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +The system identifier (URI)
  +for parsing the XSLT
  +stylesheet.
  +        </description>
   	<name>xsltSystemId</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -286,6 +434,11 @@
       <tag-class>org.apache.taglibs.standard.tag.common.xml.WhenTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +The test condition that tells whether or
  +not the body content should be
  +processed
  +        </description>
           <name>select</name>
           <required>true</required>
           <rtexprvalue>false</rtexprvalue>
  
  
  
  1.30      +267 -0    jakarta-taglibs/standard/conf/fmt.tld
  
  Index: fmt.tld
  ===================================================================
  RCS file: /home/cvs/jakarta-taglibs/standard/conf/fmt.tld,v
  retrieving revision 1.29
  retrieving revision 1.30
  diff -u -r1.29 -r1.30
  --- fmt.tld	25 Mar 2003 19:43:21 -0000	1.29
  +++ fmt.tld	4 Aug 2003 22:30:40 -0000	1.30
  @@ -28,6 +28,10 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.fmt.RequestEncodingTag</tag-class>
       <body-content>empty</body-content>
       <attribute>
  +        <description>
  +Name of character encoding to be applied when
  +decoding request parameters.
  +        </description>
           <name>value</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -42,16 +46,35 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.fmt.SetLocaleTag</tag-class>
       <body-content>empty</body-content>
       <attribute>
  +        <description>
  +A String value is interpreted as the
  +printable representation of a locale, which
  +must contain a two-letter (lower-case)
  +language code (as defined by ISO-639),
  +and may contain a two-letter (upper-case)
  +country code (as defined by ISO-3166).
  +Language and country codes must be
  +separated by hyphen (-) or underscore
  +(_).        
  +	</description>
           <name>value</name>
           <required>true</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Vendor- or browser-specific variant.
  +See the java.util.Locale javadocs for
  +more information on variants.
  +        </description>
           <name>variant</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope of the locale configuration variable.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
  @@ -67,6 +90,15 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.fmt.TimeZoneTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +The time zone. A String value is interpreted as
  +a time zone ID. This may be one of the time zone
  +IDs supported by the Java platform (such as
  +"America/Los_Angeles") or a custom time zone
  +ID (such as "GMT-8"). See
  +java.util.TimeZone for more information on
  +supported time zone formats.
  +        </description>
           <name>value</name>
           <required>true</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -81,16 +113,34 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.fmt.SetTimeZoneTag</tag-class>
       <body-content>empty</body-content>
       <attribute>
  +        <description>
  +The time zone. A String value is interpreted as
  +a time zone ID. This may be one of the time zone
  +IDs supported by the Java platform (such as
  +"America/Los_Angeles") or a custom time zone
  +ID (such as "GMT-8"). See java.util.TimeZone for
  +more information on supported time zone
  +formats.
  +        </description>
           <name>value</name>
           <required>true</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable which
  +stores the time zone of type
  +java.util.TimeZone.
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope of var or the time zone configuration
  +variable.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
  @@ -105,11 +155,23 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.fmt.BundleTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Resource bundle base name. This is the bundle's
  +fully-qualified resource name, which has the same
  +form as a fully-qualified class name, that is, it uses
  +"." as the package component separator and does not
  +have any file type (such as ".class" or ".properties")
  +suffix.
  +        </description>
           <name>basename</name>
           <required>true</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Prefix to be prepended to the value of the message
  +key of any nested &lt;fmt:message&gt; action.
  +        </description>
           <name>prefix</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -125,16 +187,34 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.fmt.SetBundleTag</tag-class>
       <body-content>empty</body-content>
       <attribute>
  +        <description>
  +Resource bundle base name. This is the bundle's
  +fully-qualified resource name, which has the same
  +form as a fully-qualified class name, that is, it uses
  +"." as the package component separator and does not
  +have any file type (such as ".class" or ".properties")
  +suffix.
  +        </description>
           <name>basename</name>
           <required>true</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable which stores
  +the i18n localization context of type
  +javax.servlet.jsp.jstl.fmt.LocalizationC
  +ontext.
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope of var or the localization context
  +configuration variable.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
  @@ -149,21 +229,35 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.fmt.MessageTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Message key to be looked up.
  +        </description>
           <name>key</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Localization context in whose resource
  +bundle the message key is looked up.
  +        </description>
           <name>bundle</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable
  +which stores the localized message.
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope of var.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
  @@ -179,6 +273,9 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.fmt.ParamTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Argument used for parametric replacement.
  +        </description>
           <name>value</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -193,61 +290,110 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.fmt.FormatNumberTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Numeric value to be formatted.
  +        </description>
           <name>value</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Specifies whether the value is to be
  +formatted as number, currency, or
  +percentage.
  +        </description>
           <name>type</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Custom formatting pattern.
  +        </description>
           <name>pattern</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +ISO 4217 currency code. Applied only
  +when formatting currencies (i.e. if type is
  +equal to "currency"); ignored otherwise.
  +        </description>
           <name>currencyCode</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Currency symbol. Applied only when
  +formatting currencies (i.e. if type is equal
  +to "currency"); ignored otherwise.
  +        </description>
           <name>currencySymbol</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Specifies whether the formatted output
  +will contain any grouping separators.
  +        </description>
           <name>groupingUsed</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Maximum number of digits in the integer
  +portion of the formatted output.
  +        </description>
           <name>maxIntegerDigits</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Minimum number of digits in the integer
  +portion of the formatted output.
  +        </description>
           <name>minIntegerDigits</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Maximum number of digits in the
  +fractional portion of the formatted output.
  +        </description>
           <name>maxFractionDigits</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Minimum number of digits in the
  +fractional portion of the formatted output.
  +        </description>
           <name>minFractionDigits</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable
  +which stores the formatted result as a
  +String.
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope of var.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
  @@ -262,36 +408,69 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.fmt.ParseNumberTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +String to be parsed.
  +        </description>
           <name>value</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Specifies whether the string in the value
  +attribute should be parsed as a number,
  +currency, or percentage.
  +        </description>
           <name>type</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Custom formatting pattern that determines
  +how the string in the value attribute is to be
  +parsed.
  +        </description>
           <name>pattern</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Locale whose default formatting pattern (for
  +numbers, currencies, or percentages,
  +respectively) is to be used during the parse
  +operation, or to which the pattern specified
  +via the pattern attribute (if present) is
  +applied.
  +        </description>
           <name>parseLocale</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Specifies whether just the integer portion of
  +the given value should be parsed.
  +        </description>
           <name>integerOnly</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable which
  +stores the parsed result (of type
  +java.lang.Number).
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope of var.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
  @@ -306,41 +485,79 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.fmt.FormatDateTag</tag-class>
       <body-content>empty</body-content>
       <attribute>
  +        <description>
  +Date and/or time to be formatted.
  +        </description>
           <name>value</name>
           <required>true</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Specifies whether the time, the date, or both
  +the time and date components of the given
  +date are to be formatted. 
  +        </description>
           <name>type</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Predefined formatting style for dates. Follows
  +the semantics defined in class
  +java.text.DateFormat. Applied only
  +when formatting a date or both a date and
  +time (i.e. if type is missing or is equal to
  +"date" or "both"); ignored otherwise.
  +        </description>
           <name>dateStyle</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Predefined formatting style for times. Follows
  +the semantics defined in class
  +java.text.DateFormat. Applied only
  +when formatting a time or both a date and
  +time (i.e. if type is equal to "time" or "both");
  +ignored otherwise.
  +        </description>
           <name>timeStyle</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Custom formatting style for dates and times.
  +        </description>
           <name>pattern</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Time zone in which to represent the formatted
  +time.
  +        </description>
           <name>timeZone</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable which
  +stores the formatted result as a String.
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope of var.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
  @@ -355,46 +572,96 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.fmt.ParseDateTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Date string to be parsed.
  +        </description>
           <name>value</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Specifies whether the date string in the
  +value attribute is supposed to contain a
  +time, a date, or both.
  +        </description>
           <name>type</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Predefined formatting style for days
  +which determines how the date
  +component of the date string is to be
  +parsed. Applied only when formatting a
  +date or both a date and time (i.e. if type
  +is missing or is equal to "date" or "both");
  +ignored otherwise.
  +        </description>
           <name>dateStyle</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Predefined formatting styles for times
  +which determines how the time
  +component in the date string is to be
  +parsed. Applied only when formatting a
  +time or both a date and time (i.e. if type
  +is equal to "time" or "both"); ignored
  +otherwise.
  +        </description>
           <name>timeStyle</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Custom formatting pattern which
  +determines how the date string is to be
  +parsed.
  +        </description>
           <name>pattern</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Time zone in which to interpret any time
  +information in the date string.
  +        </description>
           <name>timeZone</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Locale whose predefined formatting styles
  +for dates and times are to be used during
  +the parse operation, or to which the
  +pattern specified via the pattern
  +attribute (if present) is applied.
  +        </description>
           <name>parseLocale</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable in
  +which the parsing result (of type
  +java.util.Date) is stored.
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope of var.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
  
  
  
  1.25      +179 -10   jakarta-taglibs/standard/conf/c.tld
  
  Index: c.tld
  ===================================================================
  RCS file: /home/cvs/jakarta-taglibs/standard/conf/c.tld,v
  retrieving revision 1.24
  retrieving revision 1.25
  diff -u -r1.24 -r1.25
  --- c.tld	25 Mar 2003 19:43:21 -0000	1.24
  +++ c.tld	4 Aug 2003 22:30:40 -0000	1.25
  @@ -29,6 +29,11 @@
       <tag-class>org.apache.taglibs.standard.tag.common.core.CatchTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Name of the exported scoped variable for the
  +exception thrown from a nested action. The type of the
  +scoped variable is the type of the exception thrown.
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
  @@ -56,17 +61,29 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.core.IfTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +The test condition that determines whether or
  +not the body content should be processed.
  +        </description>
           <name>test</name>
           <required>true</required>
           <rtexprvalue>true</rtexprvalue>
   	<type>boolean</type>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable for the
  +resulting value of the test condition. The type
  +of the scoped variable is Boolean.        
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope for var.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
  @@ -83,31 +100,56 @@
       <tei-class>org.apache.taglibs.standard.tei.ImportTEI</tei-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +The URL of the resource to import.
  +        </description>
           <name>url</name>
           <required>true</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable for the
  +resource's content. The type of the scoped
  +variable is String.
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope for var.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable for the
  +resource's content. The type of the scoped
  +variable is Reader.
  +        </description>
           <name>varReader</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the context when accessing a relative
  +URL resource that belongs to a foreign
  +context.
  +        </description>
           <name>context</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Character encoding of the content at the input
  +resource.
  +        </description>
           <name>charEncoding</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -125,35 +167,71 @@
       <tei-class>org.apache.taglibs.standard.tei.ForEachTEI</tei-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Collection of items to iterate over.
  +        </description>
   	<name>items</name>
   	<required>false</required>
   	<rtexprvalue>true</rtexprvalue>
   	<type>java.lang.Object</type>
       </attribute>
       <attribute>
  +        <description>
  +If items specified:
  +Iteration begins at the item located at the
  +specified index. First item of the collection has
  +index 0.
  +If items not specified:
  +Iteration begins with index set at the value
  +specified.
  +        </description>
   	<name>begin</name>
   	<required>false</required>
   	<rtexprvalue>true</rtexprvalue>
   	<type>int</type>
       </attribute>
       <attribute>
  +        <description>
  +If items specified:
  +Iteration ends at the item located at the
  +specified index (inclusive).
  +If items not specified:
  +Iteration ends when index reaches the value
  +specified.
  +        </description>
   	<name>end</name>
   	<required>false</required>
   	<rtexprvalue>true</rtexprvalue>
   	<type>int</type>
       </attribute>
       <attribute>
  +        <description>
  +Iteration will only process every step items of
  +the collection, starting with the first one.
  +        </description>
   	<name>step</name>
   	<required>false</required>
   	<rtexprvalue>true</rtexprvalue>
   	<type>int</type>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable for the
  +current item of the iteration. This scoped
  +variable has nested visibility. Its type depends
  +on the object of the underlying collection.
  +        </description>
   	<name>var</name>
   	<required>false</required>
   	<rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable for the
  +status of the iteration. Object exported is of type
  +javax.servlet.jsp.jstl.core.LoopTagStatus. This scoped variable has nested
  +visibility.
  +        </description>
   	<name>varStatus</name>
   	<required>false</required>
   	<rtexprvalue>false</rtexprvalue>
  @@ -168,41 +246,73 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.core.ForTokensTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +String of tokens to iterate over.
  +        </description>
   	<name>items</name>
   	<required>true</required>
   	<rtexprvalue>true</rtexprvalue>
   	<type>java.lang.String</type>
       </attribute>
       <attribute>
  +        <description>
  +The set of delimiters (the characters that
  +separate the tokens in the string).
  +        </description>
   	<name>delims</name>
   	<required>true</required>
   	<rtexprvalue>true</rtexprvalue>
   	<type>java.lang.String</type>
       </attribute>
       <attribute>
  +        <description>
  +Iteration begins at the token located at the
  +specified index. First token has index 0.
  +        </description>
   	<name>begin</name>
   	<required>false</required>
   	<rtexprvalue>true</rtexprvalue>
   	<type>int</type>
       </attribute>
       <attribute>
  +        <description>
  +Iteration ends at the token located at the
  +specified index (inclusive).
  +        </description>
   	<name>end</name>
   	<required>false</required>
   	<rtexprvalue>true</rtexprvalue>
   	<type>int</type>
       </attribute>
       <attribute>
  +        <description>
  +Iteration will only process every step tokens
  +of the string, starting with the first one.
  +        </description>
   	<name>step</name>
   	<required>false</required>
   	<rtexprvalue>true</rtexprvalue>
   	<type>int</type>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable for the
  +current item of the iteration. This scoped
  +variable has nested visibility.
  +        </description>
   	<name>var</name>
   	<required>false</required>
   	<rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the exported scoped variable for the
  +status of the iteration. Object exported is of
  +type
  +javax.servlet.jsp.jstl.core.LoopTag
  +Status. This scoped variable has nested
  +visibility.
  +        </description>
   	<name>varStatus</name>
   	<required>false</required>
   	<rtexprvalue>false</rtexprvalue>
  @@ -217,16 +327,28 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.core.OutTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Expression to be evaluated.
  +        </description>
           <name>value</name>
           <required>true</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Default value if the resulting value is null.
  +        </description>
           <name>default</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Determines whether characters &lt;,&gt;,&amp;,'," in the
  +resulting string should be converted to their
  +corresponding character entity codes. Default value is
  +true.
  +        </description>
           <name>escapeXml</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -253,11 +375,17 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.core.ParamTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Name of the query string parameter.
  +        </description>
           <name>name</name>
           <required>true</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Value of the parameter.
  +        </description>
           <name>value</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -272,21 +400,18 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.core.RedirectTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  -        <name>var</name>
  -        <required>false</required>
  -        <rtexprvalue>false</rtexprvalue>
  -    </attribute>
  -    <attribute>
  -        <name>scope</name>
  -        <required>false</required>
  -        <rtexprvalue>false</rtexprvalue>
  -    </attribute>
  -    <attribute>
  +        <description>
  +The URL of the resource to redirect to.
  +        </description>
           <name>url</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the context when redirecting to a relative URL
  +resource that belongs to a foreign context.
  +        </description>
           <name>context</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -301,11 +426,17 @@
       <tag-class>org.apache.taglibs.standard.tag.common.core.RemoveTag</tag-class>
       <body-content>empty</body-content>
       <attribute>
  +        <description>
  +Name of the scoped variable to be removed.
  +        </description>
           <name>var</name>
           <required>true</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope for var.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
  @@ -320,26 +451,45 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.core.SetTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Name of the exported scoped variable to hold the value
  +specified in the action. The type of the scoped variable is
  +whatever type the value expression evaluates to.
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Expression to be evaluated.
  +        </description>
           <name>value</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Target object whose property will be set. Must evaluate to
  +a JavaBeans object with setter property property, or to a
  +java.util.Map object.
  +        </description>
           <name>target</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the property to be set in the target object.
  +        </description>
           <name>property</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope for var.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
  @@ -354,21 +504,36 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.core.UrlTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Name of the exported scoped variable for the
  +processed url. The type of the scoped variable is
  +String.
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope for var.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +URL to be processed.
  +        </description>
           <name>value</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Name of the context when specifying a relative URL
  +resource that belongs to a foreign context.
  +        </description>
           <name>context</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -384,6 +549,10 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.core.WhenTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +The test condition that determines whether or not the
  +body content should be processed.
  +        </description>
           <name>test</name>
           <required>true</required>
           <rtexprvalue>true</rtexprvalue>
  
  
  
  1.28      +100 -0    jakarta-taglibs/standard/conf/sql.tld
  
  Index: sql.tld
  ===================================================================
  RCS file: /home/cvs/jakarta-taglibs/standard/conf/sql.tld,v
  retrieving revision 1.27
  retrieving revision 1.28
  diff -u -r1.27 -r1.28
  --- sql.tld	25 Mar 2003 19:43:21 -0000	1.27
  +++ sql.tld	4 Aug 2003 22:30:40 -0000	1.28
  @@ -29,11 +29,22 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.sql.TransactionTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +DataSource associated with the database to access. A
  +String value represents a relative path to a JNDI
  +resource or the parameters for the JDBC
  +DriverManager facility.
  +        </description>
           <name>dataSource</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Transaction isolation level. If not specified, it is the
  +isolation level the DataSource has been configured
  +with.
  +        </description>
           <name>isolation</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -49,31 +60,62 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.sql.QueryTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Name of the exported scoped variable for the
  +query result. The type of the scoped variable is
  +javax.servlet.jsp.jstl.sql.
  +Result (see Chapter 16 "Java APIs").
  +        </description>
           <name>var</name>
           <required>true</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope of var.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +SQL query statement.
  +        </description>
           <name>sql</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Data source associated with the database to
  +query. A String value represents a relative path
  +to a JNDI resource or the parameters for the
  +DriverManager class.
  +        </description>
           <name>dataSource</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +The returned Result object includes the rows
  +starting at the specified index. The first row of
  +the original query result set is at index 0. If not
  +specified, rows are included starting from the
  +first row at index 0.
  +        </description>
           <name>startRow</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +The maximum number of rows to be included in
  +the query result. If not specified, or set to -1, no
  +limit on the maximum number of rows is
  +enforced.
  +        </description>
           <name>maxRows</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -89,21 +131,38 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.sql.UpdateTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Name of the exported scoped variable for the result
  +of the database update. The type of the scoped
  +variable is java.lang.Integer.
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Scope of var.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +SQL update statement.
  +        </description>
           <name>sql</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Data source associated with the database to update.
  +A String value represents a relative path to a JNDI
  +resource or the parameters for the JDBC
  +DriverManager class.
  +        </description>
           <name>dataSource</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -118,6 +177,9 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.sql.ParamTag</tag-class>
       <body-content>JSP</body-content>
       <attribute>
  +        <description>
  +Parameter value.
  +        </description>
           <name>value</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -132,11 +194,18 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.sql.DateParamTag</tag-class>
       <body-content>empty</body-content>
       <attribute>
  +        <description>
  +Parameter value for DATE, TIME, or
  +TIMESTAMP column in a database table.
  +        </description>
           <name>value</name>
           <required>true</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +One of "date", "time" or "timestamp".
  +        </description>
           <name>type</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  @@ -151,36 +220,67 @@
       <tag-class>org.apache.taglibs.standard.tag.rt.sql.SetDataSourceTag</tag-class>
       <body-content>empty</body-content>
       <attribute>
  +        <description>
  +Name of the exported scoped variable
  +for the data source specified. Type can
  +be String or DataSource.
  +        </description>
           <name>var</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +If var is specified, scope of the
  +exported variable. Otherwise, scope of
  +the data source configuration variable.
  +        </description>
           <name>scope</name>
           <required>false</required>
           <rtexprvalue>false</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +Data source. If specified as a string, it
  +can either be a relative path to a JNDI
  +resource, or a JDBC parameters string
  +as defined in Section 10.1.1.
  +        </description>
           <name>dataSource</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +JDBC parameter: driver class name.
  +        </description>
           <name>driver</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +JDBC parameter: URL associated with
  +the database.
  +        </description>
           <name>url</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +JDBC parameter: database user on
  +whose behalf the connection to the
  +database is being made.
  +        </description>
           <name>user</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
       </attribute>
       <attribute>
  +        <description>
  +JDBC parameter: user password
  +        </description>
           <name>password</name>
           <required>false</required>
           <rtexprvalue>true</rtexprvalue>
  
  
  

Mime
View raw message