You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by ws...@apache.org on 2005/08/19 05:13:13 UTC
svn commit: r233411 [1/3] - in /struts/taglib/trunk/doc: stylesheets/tld.xsl
userGuide/struts-bean.xml userGuide/struts-html.xml
userGuide/struts-logic.xml userGuide/struts-nested.xml
Author: wsmoak
Date: Thu Aug 18 20:12:53 2005
New Revision: 233411
URL: http://svn.apache.org/viewcvs?rev=233411&view=rev
Log:
Final cleanup of source xml documents and stylesheet for converting xml into tld files
- Changed to taglib version 1.3, JSP version 1.2
- Added CDATA sections to preserve HTML markup
- Updated stylesheet to generate JSP 1.2 tld structure
- Stylesheet includes contributions from Greg Ludington (gludington at gmail.com)
Modified:
struts/taglib/trunk/doc/stylesheets/tld.xsl
struts/taglib/trunk/doc/userGuide/struts-bean.xml
struts/taglib/trunk/doc/userGuide/struts-html.xml
struts/taglib/trunk/doc/userGuide/struts-logic.xml
struts/taglib/trunk/doc/userGuide/struts-nested.xml
Modified: struts/taglib/trunk/doc/stylesheets/tld.xsl
URL: http://svn.apache.org/viewcvs/struts/taglib/trunk/doc/stylesheets/tld.xsl?rev=233411&r1=233410&r2=233411&view=diff
==============================================================================
--- struts/taglib/trunk/doc/stylesheets/tld.xsl (original)
+++ struts/taglib/trunk/doc/stylesheets/tld.xsl Thu Aug 18 20:12:53 2005
@@ -8,25 +8,28 @@
<xsl:output
method="xml"
indent="yes"
- doctype-public="-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN"
- doctype-system="http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd"/>
+ doctype-public="-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
+ doctype-system="http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"/>
<xsl:strip-space elements="taglib tag attribute"/>
<!-- Process an entire tag library -->
<xsl:template match="taglib">
<taglib>
<xsl:if test="tlibversion">
- <tlibversion><xsl:value-of select="tlibversion"/></tlibversion>
+ <tlib-version><xsl:value-of select="tlibversion"/></tlib-version>
</xsl:if>
<xsl:if test="jspversion">
- <jspversion><xsl:value-of select="jspversion"/></jspversion>
+ <jsp-version><xsl:value-of select="jspversion"/></jsp-version>
</xsl:if>
<xsl:if test="shortname">
- <shortname><xsl:value-of select="shortname"/></shortname>
+ <short-name><xsl:value-of select="shortname"/></short-name>
</xsl:if>
<xsl:if test="uri">
<uri><xsl:value-of select="uri"/></uri>
</xsl:if>
+ <xsl:if test="info">
+ <description><xsl:value-of select="info"/></description>
+ </xsl:if>
<xsl:apply-templates select="tag"/>
</taglib>
</xsl:template>
@@ -38,16 +41,19 @@
<name><xsl:value-of select="name"/></name>
</xsl:if>
<xsl:if test="tagclass">
- <tagclass><xsl:value-of select="tagclass"/></tagclass>
+ <tag-class><xsl:value-of select="tagclass"/></tag-class>
</xsl:if>
<xsl:if test="teiclass">
- <teiclass><xsl:value-of select="teiclass"/></teiclass>
+ <tei-class><xsl:value-of select="teiclass"/></tei-class>
</xsl:if>
<xsl:if test="bodycontent">
- <bodycontent><xsl:value-of select="bodycontent"/></bodycontent>
+ <body-content><xsl:value-of select="bodycontent"/></body-content>
</xsl:if>
+ <xsl:call-template name="description">
+ <xsl:with-param name="parentNode" select="."/>
+ </xsl:call-template>
<xsl:apply-templates select="attribute"/>
- </tag>
+ </tag>
</xsl:template>
<!-- Process an individual tag attribute -->
@@ -62,10 +68,39 @@
<xsl:if test="rtexprvalue">
<rtexprvalue><xsl:value-of select="rtexprvalue"/></rtexprvalue>
</xsl:if>
- </attribute>
+ <xsl:call-template name="description">
+ <xsl:with-param name="parentNode" select="."/>
+ </xsl:call-template>
+ </attribute>
</xsl:template>
+ <!-- A named template that takes a single parameter, the node
+ which contains summary, info, and since child nodes -->
+ <xsl:template name="description">
+ <xsl:param name="parentNode"/>
+ <description>
+ <!-- Step 1: Print out the summary, if it exists -->
+ <xsl:if test="$parentNode/summary">
+ <p><strong><xsl:value-of select="$parentNode/summary"/></strong></p>
+ </xsl:if>
+ <!-- Step 2a: Print out the text of the info block, if it is plain text -->
+ <xsl:if test="$parentNode/info/text()">
+ <xsl:value-of select="$parentNode/info/text()"/>
+ </xsl:if>
+ <!-- Step 2b: Copy the entire tree under the info block,
+ if it is HTML and not plain text -->
+ <xsl:for-each select="$parentNode/info/child::*">
+ <xsl:copy-of select="."/>
+ </xsl:for-each>
+ <!-- Step 3: print out the since node, if it exists -->
+ <xsl:if test="$parentNode/since">
+ <dl><dt><b>Since:</b></dt>
+ <dd><xsl:value-of select="since"/></dd></dl>
+ </xsl:if>
+ </description>
+ </xsl:template>
+
<!-- Skip irrelevant details -->
- <xsl:template match="properties"/>
+ <xsl:template match="properties|summary|info|since"/>
</xsl:stylesheet>
Modified: struts/taglib/trunk/doc/userGuide/struts-bean.xml
URL: http://svn.apache.org/viewcvs/struts/taglib/trunk/doc/userGuide/struts-bean.xml?rev=233411&r1=233410&r2=233411&view=diff
==============================================================================
--- struts/taglib/trunk/doc/userGuide/struts-bean.xml (original)
+++ struts/taglib/trunk/doc/userGuide/struts-bean.xml Thu Aug 18 20:12:53 2005
@@ -10,12 +10,12 @@
<taglib>
- <tlibversion>1.2</tlibversion>
- <jspversion>1.1</jspversion>
+ <tlibversion>1.3</tlibversion>
+ <jspversion>1.2</jspversion>
<shortname>bean</shortname>
<display-name>Struts Bean Tags</display-name>
<uri>http://struts.apache.org/tags-bean</uri>
- <info>
+ <info><![CDATA[
<p>This tag library contains tags useful in accessing beans and their
properties, as well as defining new beans (based on these accesses)
that are accessible to the remainder of the page via scripting variables
@@ -37,7 +37,7 @@
these tags in the
<a href="../api/org/apache/struts/taglib/bean/package-summary.html#package_description">
Bean Tags Developer's Guide</a>.</p>
- </info>
+ ]]></info>
<tag>
@@ -50,7 +50,7 @@
<tagclass>org.apache.struts.taglib.bean.CookieTag</tagclass>
<teiclass>org.apache.struts.taglib.bean.CookieTei</teiclass>
<bodycontent>empty</bodycontent>
- <info>
+ <info><![CDATA[
<p>Retrieve the value of the specified request cookie (as a single
value or multiple values, depending on the <code>multiple</code> attribute),
and define the result as a page scope attribute of type <code>Cookie</code>
@@ -59,50 +59,50 @@
<p>If no cookie with the specified name can be located, and no default
value is specified, a request time exception will be thrown.</p>
- </info>
+ ]]></info>
<attribute>
<name>id</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the name of the scripting variable (and associated page
scope attribute) that will be made available with the value of the
specified request cookie.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>multiple</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>If any arbitrary value for this attribute is specified, causes all
matching cookies to be accumulated and stored into a bean of type
<code>Cookie[]</code>. If not specified, the first value for the
specified cookie will be retrieved as a value of type
<code>Cookie</code>.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>name</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the name of the request cookie whose value, or values,
is to be retrieved.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>value</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>The default cookie value to return if no cookie with the
specified name was included in this request.</p>
- </info>
+ ]]></info>
</attribute>
</tag>
@@ -118,7 +118,7 @@
<tagclass>org.apache.struts.taglib.bean.DefineTag</tagclass>
<teiclass>org.apache.struts.taglib.bean.DefineTei</teiclass>
<bodycontent>JSP</bodycontent>
- <info>
+ <info><![CDATA[
<p>Create a new attribute (in the scope specified by the
<code>toScope</code> property, if any), and a corresponding scripting
variable, both of which are named by the value of the <code>id</code>
@@ -185,76 +185,76 @@
<a href="../api/org/apache/struts/taglib/bean/package-summary.html#doc.Creation">
bean creation</a> for more information about these differences, as well
as alternative approaches to introducing beans into a JSP page.</p>
- </info>
+ ]]></info>
<attribute>
<name>id</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the name of the scripting variable (and associated page
scope attribute) that will be made available with the value of the
specified property.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>name</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the attribute name of the bean whose property is accessed
to define a new page scope attribute (if <code>property</code> is also
specified) or the attribute name of the bean that is duplicated with
the new reference created by this tag (if <code>property</code> is not
also specified). This attribute is required unless you specify
a <code>value</code> attribute or nested body content.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>property</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the name of the property to be accessed on the bean
specified by <code>name</code>. This value may be a simple, indexed,
or nested property reference expression. If not specified, the bean
identified by <code>name</code> is given a new reference identified by
<code>id</code>.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>scope</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the variable scope searched to retrieve the bean specified
by <code>name</code>. If not specified, the default rules applied by
<code>PageContext.findAttribute()</code> are applied.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>toScope</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the variable scope into which the newly defined bean will
be created. If not specified, the bean will be created in
<code>page</code> scope.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>type</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the fully qualified class name of the value to be exposed
as the <code>id</code> attribute.</p>
- </info>
+ ]]></info>
<default>
<code>java.lang.String</code> (if you specify a <code>value</code>
attribute) or <code>java.lang.Object</code> otherwise.
@@ -265,11 +265,11 @@
<name>value</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>The <code>java.lang.String</code> value to which the exposed bean
should be set. This attribute is required unless you specify the
<code>name</code> attribute or nested body content.</p>
- </info>
+ ]]></info>
</attribute>
</tag>
@@ -285,7 +285,7 @@
<tagclass>org.apache.struts.taglib.bean.HeaderTag</tagclass>
<teiclass>org.apache.struts.taglib.bean.HeaderTei</teiclass>
<bodycontent>empty</bodycontent>
- <info>
+ <info><![CDATA[
<p>Retrieve the value of the specified request header (as a single
value or multiple values, depending on the <code>multiple</code> attribute),
and define the result as a page scope attribute of type <code>String</code>
@@ -294,51 +294,51 @@
<p>If no header with the specified name can be located, and no default
value is specified, a request time exception will be thrown.</p>
- </info>
+ ]]></info>
<attribute>
<name>id</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the name of the scripting variable (and associated page
scope attribute) that will be made available with the value of the
specified request header.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>multiple</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>If any arbitrary value for this attribute is specified, causes a call
to <code>HttpServletRequest.getHeaders()</code> and a definition of the
result as a bean of type <code>String[]</code>. Otherwise,
<code>HttpServletRequest.getHeader()</code> will be called, and a
definition of the result as a bean of type <code>String</code>
will be performed.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>name</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the name of the request header whose value, or values,
is to be retrieved.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>value</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>The default header value to return if no header with the
specified name was included in this request.</p>
- </info>
+ ]]></info>
</attribute>
</tag>
@@ -354,7 +354,7 @@
<tagclass>org.apache.struts.taglib.bean.IncludeTag</tagclass>
<teiclass>org.apache.struts.taglib.bean.IncludeTei</teiclass>
<bodycontent>empty</bodycontent>
- <info>
+ <info><![CDATA[
<p>Perform an internal dispatch to the specified application component
(or external URL)
and make the response data from that request available as a bean of
@@ -378,7 +378,7 @@
<li><em>page</em> - Use the value of this attribute as an
module-relative URI to the desired resource.</li>
</ul>
- </info>
+ ]]></info>
<p><strong>WARNING</strong> - Accessing resources protected by security
constraints, or resources under the <code>/WEB-INF</code> subdirectory,
@@ -392,55 +392,55 @@
<name>anchor</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Optional anchor tag ("#xxx") to be added to the generated
hyperlink. Specify this value <strong>without</strong> any
"#" character.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>forward</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Logical name of a global <code>ActionForward</code> that contains
the actual content-relative URI of the resource to be included.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>href</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Absolute URL (including the appropriate protocol prefix such as
"http:") of the resource to be included. Because this URL could be
external to the current web application, the session identifier will
<strong>not</strong> be included in the request.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>id</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the name of the scripting variable (and associated page
scope attribute) that will be made available with the value of the
specified web application resource.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>name</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Module-relative name (starting with a '/') of the web application
resource to be dispatched, and whose response data is to be made
available as a bean.</p>
- </info>
+ ]]></info>
<deprecated>
Use the "page" attribute instead.
</deprecated>
@@ -450,21 +450,21 @@
<name>page</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Module-relative URI (starting with a '/') of the web application
resource to be included.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>transaction</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Set to <code>true</code> if you want the current
transaction control token included in the generated
URL for this include.</p>
- </info>
+ ]]></info>
</attribute>
</tag>
@@ -478,7 +478,7 @@
</summary>
<tagclass>org.apache.struts.taglib.bean.MessageTag</tagclass>
<bodycontent>empty</bodycontent>
- <info>
+ <info><![CDATA[
<p>Retrieves an internationalized message for the specified locale,
using the specified message key, and write it to the output stream.
Up to five parametric replacements (such as "{0}") may be specified.</p>
@@ -496,62 +496,62 @@
</fmt:message>
</code>
</p>
- </info>
+ ]]></info>
<attribute>
<name>arg0</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>First parametric replacement value, if any.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>arg1</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Second parametric replacement value, if any.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>arg2</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Third parametric replacement value, if any.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>arg3</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Fourth parametric replacement value, if any.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>arg4</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Fifth parametric replacement value, if any.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>bundle</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>The name of the application scope bean under which the
<code>MessageResources</code> object containing our messages
is stored.</p>
- </info>
+ ]]></info>
<default>Globals.MESSAGES_KEY</default>
</attribute>
@@ -559,22 +559,22 @@
<name>key</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>The message key of the requested message, which must have
a corresponding value in the message resources. If not specified,
the key is obtained from the <code>name</code> and
<code>property</code> attributes.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>locale</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>The name of the session scope bean under which our currently
selected <code>Locale</code> object is stored.</p>
- </info>
+ ]]></info>
<default>Globals.LOCALE_KEY</default>
</attribute>
@@ -582,36 +582,36 @@
<name>name</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the attribute name of the bean whose property is accessed
to retrieve the value specified by <code>property</code> (if
specified). If <code>property</code> is not specified, the value of
this bean itself will be used as the message resource key.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>property</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the name of the property to be accessed on the bean
specified by <code>name</code>. This value may be a simple, indexed,
or nested property reference expression. If not specified, the value
of the bean identified by <code>name</code> will itself be used as the
message resource key.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>scope</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the variable scope searched to retrieve the bean specified
by <code>name</code>. If not specified, the default rules applied by
<code>PageContext.findAttribute()</code> are applied.</p>
- </info>
+ ]]></info>
</attribute>
</tag>
@@ -626,36 +626,36 @@
<tagclass>org.apache.struts.taglib.bean.PageTag</tagclass>
<teiclass>org.apache.struts.taglib.bean.PageTei</teiclass>
<bodycontent>empty</bodycontent>
- <info>
+ <info><![CDATA[
<p>Retrieve the value of the specified item from the page context
for this page, and define it as a scripting variable, and a page scope
attribute accessible to the remainder of the current page.</p>
<p>If a problem occurs while retrieving the specified configuration
object, a request time exception will be thrown.</p>
- </info>
+ ]]></info>
<attribute>
<name>id</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the name of the scripting variable (and associated
page scope attribute) that will be made available with the value of
the specified page context property.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>property</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Name of the property from our page context to be retrieved and
exposed. Must be one of <code>application</code>, <code>config</code>,
<code>request</code>, <code>response</code>, or <code>session</code>.
</p>
- </info>
+ ]]></info>
</attribute>
</tag>
@@ -671,7 +671,7 @@
<tagclass>org.apache.struts.taglib.bean.ParameterTag</tagclass>
<teiclass>org.apache.struts.taglib.bean.ParameterTei</teiclass>
<bodycontent>empty</bodycontent>
- <info>
+ <info><![CDATA[
<p>Retrieve the value of the specified request parameter (as a single
value or multiple values, depending on the <code>multiple</code> attribute),
and define the result as a page scope attribute of type <code>String</code>
@@ -680,51 +680,51 @@
<p>If no request parameter with the specified name can be located, and
no default value is specified, a request time exception will be thrown.</p>
- </info>
+ ]]></info>
<attribute>
<name>id</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the name of the scripting variable (and associated page
scope attribute) that will be made available with the value of the
specified request parameter.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>multiple</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>If any arbitrary value for this attribute is specified, causes a call
to <code>ServletRequest.getParameterValues()</code> and a definition of
the result as a bean of type <code>String[]</code>. Otherwise,
<code>ServletRequest.getParameter()</code> will be called, and a
definition of the result as a bean of type <code>String</code>
will be performed.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>name</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the name of the request parameter whose value, or values,
is to be retrieved.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>value</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>The default parameter value to return if no parameter with the
specified name was included in this request.</p>
- </info>
+ ]]></info>
</attribute>
</tag>
@@ -739,46 +739,46 @@
<tagclass>org.apache.struts.taglib.bean.ResourceTag</tagclass>
<teiclass>org.apache.struts.taglib.bean.ResourceTei</teiclass>
<bodycontent>empty</bodycontent>
- <info>
+ <info><![CDATA[
<p>Retrieve the value of the specified web application resource, and make
it available as either a <code>InputStream</code> or a <code>String</code>,
depending on the value of the <code>input</code> attribute.</p>
<p>If a problem occurs while retrieving the specified resource, a
request time exception will be thrown.</p>
- </info>
+ ]]></info>
<attribute>
<name>id</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the name of the scripting variable (and associated page
scope attribute) that will be made available with the value of the
specified web application resource.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>input</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>If any arbitrary value for this attribute is specified, the resource
will be made available as an <code>InputStream</code>. If this
attribute is not specified, the resource will be made available
as a <code>String</code>.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>name</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Module-relative name (starting with a '/') of the web application
resource to be loaded and made available.</p>
- </info>
+ ]]></info>
</attribute>
</tag>
@@ -793,7 +793,7 @@
<tagclass>org.apache.struts.taglib.bean.SizeTag</tagclass>
<teiclass>org.apache.struts.taglib.bean.SizeTei</teiclass>
<bodycontent>empty</bodycontent>
- <info>
+ <info><![CDATA[
<p>Given a reference to an array, Collection or Map, creates a new bean, of
type <code>java.lang.Integer</code>, whose value is the number of elements
in that collection. You can specify the collection to be counted in any
@@ -805,62 +805,62 @@
<li>As the property, specified by the <code>property</code> attribute,
of the JSP bean specified by the <code>name</code> attribute.</li>
</ul>
- </info>
+ ]]></info>
<attribute>
<name>collection</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>A runtime expression that evaluates to an array, a Collection, or
a Map.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>id</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>The name of a page scope JSP bean, of type
<code>java.lang.Integer</code>, that will be created to contain the
size of the underlying collection being counted.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>name</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>The name of the JSP bean (optionally constrained to the scope
specified by the <code>scope</code> attribute) that contains the
collection to be counted (if <code>property</code> is not specified),
or whose property getter is called to return the collection to be
counted (if <code>property</code> is specified.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>property</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>The name of the property, of the bean specified by the
<code>name</code> attribute, whose getter method will return the
collection to be counted.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>scope</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>The bean scope within which to search for the JSP bean specified
by the <code>name</code> attribute. If not specified, the available
scopes are searched in ascending sequence.</p>
- </info>
+ ]]></info>
</attribute>
</tag>
@@ -875,7 +875,7 @@
<tagclass>org.apache.struts.taglib.bean.StrutsTag</tagclass>
<teiclass>org.apache.struts.taglib.bean.StrutsTei</teiclass>
<bodycontent>empty</bodycontent>
- <info>
+ <info><![CDATA[
<p>Retrieve the value of the specified Struts internal configuration
object, and define it as a scripting variable and as a page scope
attribute accessible to the remainder of the current page. You must
@@ -885,47 +885,47 @@
<p>If a problem occurs while retrieving the specified configuration
object, a request time exception will be thrown.</p>
- </info>
+ ]]></info>
<attribute>
<name>id</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the name of the scripting variable (and associated
page scope attribute) that will be made available with the value of
the specified Struts internal configuration object.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>formBean</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the name of the Struts <code>ActionFormBean</code>
definition object to be exposed.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>forward</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the name of the global Struts <code>ActionForward</code>
definition object to be exposed.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>mapping</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the matching path of the Struts <code>ActionMapping</code>
definition object to be exposed.</p>
- </info>
+ ]]></info>
</attribute>
</tag>
@@ -940,7 +940,7 @@
</summary>
<tagclass>org.apache.struts.taglib.bean.WriteTag</tagclass>
<bodycontent>empty</bodycontent>
- <info>
+ <info><![CDATA[
<p>Retrieve the value of the specified bean property, and render it to the
current JspWriter as a String by the ways:</p>
<ul>
@@ -963,17 +963,17 @@
patterns, please see the Javadocs for those classes.</p>
<p>If a problem occurs while retrieving the specified bean property, a
request time exception will be thrown.</p>
- </info>
+ ]]></info>
<attribute>
<name>bundle</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>The name of the application scope bean under which the
<code>MessageResources</code> object containing our messages
is stored.</p>
- </info>
+ ]]></info>
<default>Globals.MESSAGES_KEY</default>
</attribute>
@@ -981,11 +981,11 @@
<name>filter</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>If this attribute is set to <code>true</code>, the rendered property
value will be filtered for characters that are sensitive in HTML, and any
such characters will be replaced by their entity equivalents.</p>
- </info>
+ ]]></info>
<default>true</default>
</attribute>
@@ -993,7 +993,7 @@
<name>format</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the format string to use to convert bean or property value
to the <code>String</code>. If nothing specified, then default format
string for value data type will be searched in message resources by
@@ -1042,29 +1042,29 @@
<br />values for resource file entries are standart Java format strings for
date, time and number values.</p>
-->
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>formatKey</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the key to search format string in application resources.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>ignore</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>If this attribute is set to <code>true</code>, and the bean specified
by the <code>name</code> and <code>scope</code> attributes does not
exist, simply return without writing anything. If this attribute is
set to <code>false</code>, a runtime exception to be thrown,
consistent with the other tags in this tag library.</p>
- </info>
+ ]]></info>
<default>false</default>
</attribute>
@@ -1072,10 +1072,10 @@
<name>locale</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>The name of the session scope bean under which our currently
selected <code>Locale</code> object is stored.</p>
- </info>
+ ]]></info>
<default>Globals.LOCALE_KEY</default>
</attribute>
@@ -1083,36 +1083,36 @@
<name>name</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the attribute name of the bean whose property is accessed
to retrieve the value specified by <code>property</code> (if
specified). If <code>property</code> is not specified, the value of
this bean itself will be rendered.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>property</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the name of the property to be accessed on the bean
specified by <code>name</code>. This value may be a simple, indexed,
or nested property reference expression. If not specified, the bean
identified by <code>name</code> will itself be rendered. If the
specified property returns null, no output will be rendered.</p>
- </info>
+ ]]></info>
</attribute>
<attribute>
<name>scope</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
- <info>
+ <info><![CDATA[
<p>Specifies the variable scope searched to retrieve the bean specified
by <code>name</code>. If not specified, the default rules applied by
<code>PageContext.findAttribute()</code> are applied.</p>
- </info>
+ ]]></info>
</attribute>
</tag>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org