pierred 00/10/28 22:10:36
Modified: jasper/src/share/org/apache/jasper/resources
web-jsptaglib_1_2.dtd
Log:
PFD taglib DTD.
Revision Changes Path
1.2 +237 -176
jakarta-tomcat-4.0/jasper/src/share/org/apache/jasper/resources/web-jsptaglib_1_2.dtd
Index: web-jsptaglib_1_2.dtd
===================================================================
RCS file:
/home/cvs/jakarta-tomcat-4.0/jasper/src/share/org/apache/jasper/resources/web-jsptaglib_1_2.dtd,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- web-jsptaglib_1_2.dtd 2000/10/04 05:10:58 1.1
+++ web-jsptaglib_1_2.dtd 2000/10/29 05:10:35 1.2
@@ -1,7 +1,3 @@
-<!-- TEMPORARY DTD FOR THE JSP 1.2 TAG LIBRARY DESCRIPTOR.
- THIS WILL BE REPLACED BY THE OFFICIAL ONE WHEN IT IT
- POSTED. -->
-
<!--
This is the DTD defining the JavaServer Pages 1.2 Tag Library
@@ -12,204 +8,232 @@
appropriate implementing classes, and other resources required to
implement the tags defined therein.
+ Use is subject to license terms.
-->
<!NOTATION WEB-JSPTAGLIB.1_2 PUBLIC
"-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN">
<!--
+The taglib tag is the document root, it defines:
- The taglib tag is the document root, it defines:
+tlib-version the version of the tag library implementation
- tlibversion the version of the tag library implementation
+jsp-version the version of JSP the tag library depends upon
- jspversion the version of JSP the tag library depends upon
+short-name a simple default short name that could be used by
+ a JSP authoring tool to create names with a mnemonic
+ value; for example, the it may be used as the prefered
+ prefix value in taglib directives
- shortname a simple default short name that could be used by
- a JSP authoring tool to create names with a mnemonic
- value; for example, the it may be used as the prefered
- prefix value in taglib directives
- uri a uri uniquely identifying this taglib
+uri a uri uniquely identifying this taglib
- display-name the display-name element contains a short name that
- is intended to be displayed by tools
+display-name the display-name element contains a short name that
+ is intended to be displayed by tools
+small-icon optional small-icon that can be used by tools
- small-icon optional small-icon that can be used by tools
+large-icon optional large-icon that can be used by tools
- large-icon optional large-icon that can be used by tools
+description a simple string describing the "use" of this taglib,
+ should be user discernable
- info a simple string describing the "use" of this taglib,
- should be user discernable
-
- validatorclass optional TagLibraryValidator class
+validator optional TagLibraryValidator information
- listener optional event listener specification
+listener optional event listener specification
- -->
+
+-->
-<!ELEMENT taglib (tlibversion, jspversion?, shortname, uri?,
- display-name?, small-icon?, large-icon?, info?,
- validatorclass?, listener*, tag+) >
- <!ATTLIST taglib id ID #IMPLIED
- xmlns CDATA #FIXED
"http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_2.dtd"
- >
+<!ELEMENT taglib (tlib-version, jsp-version?, short-name, uri?,
+ display-name?, small-icon?, large-icon?, description?,
+ validator?, listener*, tag+) >
+<!ATTLIST taglib id ID #IMPLIED
+ xmlns CDATA #FIXED
+ "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"
+>
+
<!--
+Describes this version (number) of the taglibrary (dewey decimal)
+
+#PCDATA ::= [0-9]*{ "."[0-9] }0..3
+-->
- Describes this version (number) of the taglibrary (dewey decimal)
+<!ELEMENT tlib-version (#PCDATA) >
- #PCDATA ::= [0-9]*{ "."[0-9] }0..3
- -->
+<!--
+Describes the JSP version (number) this taglibrary requires in
+order to function (dewey decimal)
+
+The default is 1.2
-<!ELEMENT tlibversion (#PCDATA) >
+#PCDATA ::= [0-9]*{ "."[0-9] }0..3
+-->
+<!ELEMENT jsp-version (#PCDATA) >
+
<!--
+Defines a short (default) short-name to be used for tags and
+variable names used/created by this tag library. Do not use
+white space, and do not start with digits or underscore.
- Describes the JSP version (number) this taglibrary requires in order to
function (dewey decimal)
+#PCDATA ::= NMTOKEN
+-->
- The default is 1.2
+<!ELEMENT short-name (#PCDATA) >
- #PCDATA ::= [0-9]*{ "."[0-9] }0..3
+<!--
+Defines a public URI that uniquely identifies this version of
+the taglibrary. Leave it empty if it does not apply.
+-->
- -->
+<!ELEMENT uri (#PCDATA) >
-<!ELEMENT jspversion (#PCDATA) >
+<!--
+Defines an arbitrary text string descirbing the tag library
+-->
+
+<!ELEMENT description (#PCDATA) >
<!--
- Defines a short (default) shortname to be used for tags and variable names
used/created by this tag library.
- Do not use white space, and do not start with digits or underscore.
- #PCDATA ::= NMTOKEN
- -->
+Defines an optional validator that can be used to
+validate the conformance of a JSP page to using this tag library.
+-->
-<!ELEMENT shortname (#PCDATA) >
+<!ELEMENT validator (validator-class, init-param*) >
+
<!--
- Defines a public URI that uniquely identifies this version of the
- tag library. It is recommended that the URI identifying a tag library
- is actually a URL to the tag library descriptor for this specific
- version of the tag library.
- -->
+Defines the TagLibraryValidator class that can be used to
+validate the conformance of a JSP page to using this tag library.
+-->
-<!ELEMENT uri (#PCDATA) >
+<!ELEMENT validator-class (#PCDATA) >
+
<!--
- Defines an arbitrary text string descirbing the tag library
- -->
+The init-param element contains a name/value pair as an
+initialization param
+-->
-<!ELEMENT info (#PCDATA) >
+<!ELEMENT init-param (param-name, param-value, description?)>
<!--
- Defines an optional TagLibraryValidator class that can be used to
- validate the conformance of a JSP page to using this tag library.
+The param-name element contains the name of a parameter.
-->
-<!ELEMENT validatorclass (#PCDATA) >
+<!ELEMENT param-name (#PCDATA)>
<!--
- Defines an optional event listener object to be instantiated and
- registered automatically.
+The param-value element contains the value of a parameter.
-->
+<!ELEMENT param-value (#PCDATA)>
+
+
+<!--
+
+Defines an optional event listener object to be instantiated and
+registered automatically.
+-->
+
<!ELEMENT listener (listener-class) >
<!--
- The listener-class element declares a class in the application that
- must be registered as a web application listener bean. See the
- Servlet 2.3 specification for details.
+The listener-class element declares a class in the application that
+must be registered as a web application listener bean. See the
+Servlet 2.3 specification for details.
-->
<!ELEMENT listener-class (#PCDATA) >
<!--
+The tag defines a unique tag in this tag library. It has one
+attribute, id.
- The tag defines a unique tag in this tag library. It has one
- attribute, id.
+The tag element may have several subelements defining:
- The tag element may have several subelements defining:
+name The unique action name
- name The unique action name
+tag-class The tag handler class implementing
+ javax.servlet.jsp.tagext.Tag
- tagclass The tag handler class implementing
- javax.servlet.jsp.tagext.Tag
+tei-class An optional subclass of
+ javax.servlet.jsp.tagext.TagExtraInfo
- teiclass An optional subclass of
- javax.servlet.jsp.tagext.TagExtraInfo
+body-content The body content type
- bodycontent The body content type
+display-name A short name that is intended to be displayed
+ by tools
- display-name A short name that is intended to be displayed
- by tools
+small-icon Optional small-icon that can be used by tools
- small-icon Optional small-icon that can be used by tools
+large-icon Optional large-icon that can be used by tools
- large-icon Optional large-icon that can be used by tools
+description Optional tag-specific information
- info Optional tag-specific information
+variable Optional scripting variable information
- variable Optional scripting variable information
+attribute All attributes of this action
- attribute All attributes of this action
-->
-<!ELEMENT tag (name, tagclass, teiclass?, bodycontent?, display-name?,
- small-icon?, large-icon?, info?, variable*, attribute*) >
- <!ATTLIST tag id ID #IMPLIED >
+<!ELEMENT tag (name, tag-class, tei-class?, body-content?, display-name?,
+ small-icon?, large-icon?, description?, variable*, attribute*) >
<!--
-
- Defines the subclass of javax.serlvet.jsp.tagext.Tag that implements
- the request time semantics for this tag. (required)
+Defines the subclass of javax.serlvet.jsp.tagext.Tag that implements
+the request time semantics for this tag. (required)
- #PCDATA ::= fully qualified Java class name
- -->
+#PCDATA ::= fully qualified Java class name
+-->
-<!ELEMENT tagclass (#PCDATA) >
+<!ELEMENT tag-class (#PCDATA) >
<!--
-
- Defines the subclass of javax.servlet.jsp.tagext.TagExtraInfo for
- this tag. (optional)
+Defines the subclass of javax.servlet.jsp.tagext.TagExtraInfo for
+this tag. (optional)
- The default is javax.servlet.jsp.tagext.TagExtraInfo
+If this is not given, the class is not consulted at translation time.
- #PCDATA ::= fully qualified Java class name
- -->
+#PCDATA ::= fully qualified Java class name
+-->
-<!ELEMENT teiclass (#PCDATA) >
+<!ELEMENT tei-class (#PCDATA) >
<!--
- Provides a hint as to the content of the body of this tag. Primarily
- intended for use by page composition tools.
+Provides a hint as to the content of the body of this tag. Primarily
+intended for use by page composition tools.
- There are currently three values specified:
+There are currently three values specified:
- tagdependent The body of the tag is interpreted by the tag
- implementation itself, and is most likely in a
- different "langage", e.g embedded SQL statements.
+tagdependent The body of the tag is interpreted by the tag
+ implementation itself, and is most likely in a
+ different "langage", e.g embedded SQL statements.
- JSP The body of the tag contains nested JSP syntax
-
- empty The body must be empty
+JSP The body of the tag contains nested JSP syntax
- The default (if not defined) is JSP
+empty The body must be empty
- #PCDATA ::= tagdependent | JSP | empty
+The default (if not defined) is JSP
- -->
+#PCDATA ::= tagdependent | JSP | empty
-<!ELEMENT bodycontent (#PCDATA) >
+-->
+
+<!ELEMENT body-content (#PCDATA) >
<!--
- The display-name element contains a short name that is intended
- to be displayed by tools.
+The display-name element contains a short name that is intended
+to be displayed by tools.
-->
<!ELEMENT display-name (#PCDATA) >
@@ -217,155 +241,192 @@
<!--
- The large-icon element contains the name of a file containing a large
- (32 x 32) icon image. The file name is a relative path within the
- tag library. The image must be either in the JPEG or GIF format, and
- the file name must end with the suffix ".jpg" or ".gif" respectively.
- The icon can be used by tools.
+The large-icon element contains the name of a file containing a large
+(32 x 32) icon image. The file name is a relative path within the
+tag library. The image must be either in the JPEG or GIF format, and
+the file name must end with the suffix ".jpg" or ".gif" respectively.
+The icon can be used by tools.
-->
<!ELEMENT large-icon (#PCDATA) >
<!--
- The small-icon element contains the name of a file containing a large
- (32 x 32) icon image. The file name is a relative path within the
- tag library. The image must be either in the JPEG or GIF format, and
- the file name must end with the suffix ".jpg" or ".gif" respectively.
- The icon can be used by tools.
+The small-icon element contains the name of a file containing a large
+(32 x 32) icon image. The file name is a relative path within the
+tag library. The image must be either in the JPEG or GIF format, and
+the file name must end with the suffix ".jpg" or ".gif" respectively.
+The icon can be used by tools.
-->
<!ELEMENT small-icon (#PCDATA) >
<!--
- The variable tag provides information on the scripting variables
- defined by this tag. It is a (translation time) error for a tag
- that has one or more variable subelements to have a TagExtraInfo
- class that returns a non-null object.
+The variable tag provides information on the scripting variables
+defined by this tag. It is a (translation time) error for a tag
+that has one or more variable subelements to have a TagExtraInfo
+class that returns a non-null object.
- The subelements of variable are of the form:
+The subelements of variable are of the form:
- name-given The variable name as a constant
+name-given The variable name as a constant
- name-from-attribute The name of an attribute whose (translation
- time) value will give the name of the
- variable. One of name-given or
- name-from-attribute is required.
+name-from-attribute The name of an attribute whose (translation
+ time) value will give the name of the
+ variable. One of name-given or
+ name-from-attribute is required.
- class Name of the class of the variable.
- java.lang.String is default.
+variable-class Name of the class of the variable.
+ java.lang.String is default.
- declare Whether the variable is declared or not.
- True is the default.
+declare Whether the variable is declared or not.
+ True is the default.
- scope The scope of the scripting varaible
- defined. NESTED is default.
+scope The scope of the scripting varaible
+ defined. NESTED is default.
-->
-<!ELEMENT variable ( (name-given | name-from-attribute), class?,
+<!ELEMENT variable ( (name-given | name-from-attribute), variable-class?,
declare?, scope?) >
<!--
- The name for the scripting variable. One of name-given or
- name-from-attribute is required.
+The name for the scripting variable. One of name-given or
+name-from-attribute is required.
-->
<!ELEMENT name-given (#PCDATA) >
<!--
- The name of an attribute whose (translation-time) value will give
- the name of the variable. One of name-given or name-from-attribute
- is required.
+The name of an attribute whose (translation-time) value will give
+the name of the variable. One of name-given or name-from-attribute
+is required.
-->
<!ELEMENT name-from-attribute (#PCDATA) >
<!--
- The optional name of the class for the scripting variable. The
- default is java.lang.String.
+The optional name of the class for the scripting variable. The
+default is java.lang.String.
-->
-<!ELEMENT class (#PCDATA) >
+<!ELEMENT variable-class (#PCDATA) >
<!--
- Whether the scripting variable is to be defined or not. See
- TagExtraInfo for details. This element is optional and "true"
- is the default.
+Whether the scripting variable is to be defined or not. See
+TagExtraInfo for details. This element is optional and "true"
+is the default.
-->
<!ELEMENT declare (#PCDATA) >
<!--
- The scope of the scripting variable. See TagExtraInfo for details.
- The element is optional and "NESTED" is the default. Other legal
- values are "AT_BEGIN" and "AT_END".
+The scope of the scripting variable. See TagExtraInfo for details.
+The element is optional and "NESTED" is the default. Other legal
+values are "AT_BEGIN" and "AT_END".
-->
<!ELEMENT scope (#PCDATA) >
<!--
- The attribute tag defines an attribute for the nesting tag
+The attribute tag defines an attribute for the nesting tag
- An attribute definition is composed of:
+An attribute definition is composed of:
- - the attributes name (required)
- - if the attribute is required or optional (optional)
- - if the attributes value may be dynamically calculated at runtime
- by a scriptlet expression (optional)
- - the type of the attributes value (optional)
+- the attributes name (required)
+- if the attribute is required or optional (optional)
+- if the attributes value may be dynamically calculated at runtime
+ by a scriptlet expression (optional)
+- the type of the attributes value (optional)
- -->
+-->
-<!ELEMENT attribute (name, required? , rtexprvalue?, type?) >
- <!ATTLIST attribute id ID #IMPLIED>
<!--
+The attribute tag defines an attribute for the nesting tag
- Defines the canonical name of a tag or attribute being defined
+An attribute definition is composed of:
- #PCDATA ::= NMTOKEN
- -->
+- the attributes name (required)
-<!ELEMENT name (#PCDATA) >
+- if the attribute is required or optional (optional)
+
+- if the attributes value may be dynamically calculated at runtime
+ by a scriptlet expression (optional)
+- the type of the attributes value (optional)
+-->
+
+<!ELEMENT attribute (name, required? , rtexprvalue?, type?) >
+
<!--
+Defines the canonical name of a tag or attribute being defined
- Defines if the nesting attribute is required or optional.
+#PCDATA ::= NMTOKEN
+-->
- #PCDATA ::= true | false | yes | no
+<!ELEMENT name (#PCDATA) >
- If not present then the default is "false", i.e the attribute is optional
- -->
+<!--
+Defines if the nesting attribute is required or optional.
+
+#PCDATA ::= true | false | yes | no
+If not present then the default is "false", i.e the attribute
+is optional.
+-->
+
<!ELEMENT required (#PCDATA) >
<!--
+Defines if the nesting attribute can have scriptlet expressions as
+a value, i.e the value of the attribute may be dynamically calculated
+at request time, as opposed to a static value determined at translation
+time.
- Defines if the nesting attribute can have scriptlet expressions as
- a value, i.e the value of the attribute may be dynamically calculated
- at request time, as opposed to a static value determined at translation
- time.
+#PCDATA ::= true | false | yes | no
- #PCDATA ::= true | false | yes | no
-
- If not present then the default is "false", i.e the attribute has a static
value
- -->
+If not present then the default is "false", i.e the attribute
+has a static value
+-->
<!ELEMENT rtexprvalue (#PCDATA) >
+
<!--
- Defines the Java type of the attributes value. For static values
- (those determined at translation time) the type is always
- java.lang.String.
+Defines the Java type of the attributes value. For static values
+(those determined at translation time) the type is always
+java.lang.String.
-->
<!ELEMENT type (#PCDATA) >
+
+<!-- ID attributes -->
+
+<!ATTLIST tlib-version id ID #IMPLIED>
+<!ATTLIST jsp-version id ID #IMPLIED>
+<!ATTLIST short-name id ID #IMPLIED>
+<!ATTLIST uri id ID #IMPLIED>
+<!ATTLIST description id ID #IMPLIED>
+<!ATTLIST tag id ID #IMPLIED>
+<!ATTLIST tag-class id ID #IMPLIED>
+<!ATTLIST tei-class id ID #IMPLIED>
+<!ATTLIST body-content id ID #IMPLIED>
+<!ATTLIST attribute id ID #IMPLIED>
+<!ATTLIST name id ID #IMPLIED>
+<!ATTLIST required id ID #IMPLIED>
+<!ATTLIST rtexprvalue id ID #IMPLIED>
+
+
+<!ATTLIST param-name id ID #IMPLIED>
+<!ATTLIST param-value id ID #IMPLIED>
+<!ATTLIST listener id ID #IMPLIED>
+<!ATTLIST listener-class id ID #IMPLIED>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
