| <!-- |
| |
| DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. |
| |
| Copyright 2000-2007 Sun Microsystems, Inc. All rights reserved. |
| |
| The contents of this file are subject to the terms of either the GNU |
| General Public License Version 2 only ("GPL") or the Common Development |
| and Distribution License("CDDL") (collectively, the "License"). You |
| may not use this file except in compliance with the License. You can obtain |
| a copy of the License at https://glassfish.dev.java.net/public/CDDL+GPL.html |
| or glassfish/bootstrap/legal/LICENSE.txt. See the License for the specific |
| language governing permissions and limitations under the License. |
| |
| When distributing the software, include this License Header Notice in each |
| file and include the License file at glassfish/bootstrap/legal/LICENSE.txt. |
| Sun designates this particular file as subject to the "Classpath" exception |
| as provided by Sun in the GPL Version 2 section of the License file that |
| accompanied this code. If applicable, add the following below the License |
| Header, with the fields enclosed by brackets [] replaced by your own |
| identifying information: "Portions Copyrighted [year] |
| [name of copyright owner]" |
| |
| Contributor(s): |
| |
| If you wish your version of this file to be governed by only the CDDL or |
| only the GPL Version 2, indicate your decision by adding "[Contributor] |
| elects to include this software in this distribution under the [CDDL or GPL |
| Version 2] license." If you don't indicate a single choice of license, a |
| recipient has the option to distribute your version of this file under |
| either the CDDL, the GPL Version 2 or to extend the choice of license to |
| its licensees as provided above. However, if you add GPL Version 2 code |
| and therefore, elected the GPL Version 2 license, then the option applies |
| only if the new code is made subject to such option by the copyright |
| holder. |
| |
| --> |
| |
| <!-- |
| |
| This is the DTD defining the JavaServer Pages 1.1 Tag Library |
| descriptor (.tld) (XML) file format/syntax. |
| |
| A Tag Library is a JAR file containing a valid instance of a Tag Library |
| Descriptor (taglib.tld) file in the META-INF subdirectory, along with the |
| appropriate implementing classes, and other resources required to |
| implement the tags defined therein. |
| |
| --> |
| |
| <!-- |
| The taglib tag is the document root, it defines: |
| |
| tlibversion the version of the tag library implementation |
| jspversion the version of JSP the tag library depends upon |
| |
| 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 |
| info a simple string describing the "use" of this taglib, |
| should be user discernable |
| --> |
| |
| <!ELEMENT taglib (tlibversion, jspversion?, shortname, uri?, info?, tag+) > |
| <!ATTLIST taglib id ID #IMPLIED |
| xmlns CDATA #FIXED |
| "http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd" |
| > |
| |
| <!-- |
| Describes this version (number) of the taglibrary (dewey decimal) |
| |
| #PCDATA ::= [0-9]*{ "."[0-9] }0..3 |
| --> |
| |
| <!ELEMENT tlibversion (#PCDATA) > |
| |
| <!-- |
| Describes the JSP version (number) this taglibrary requires in |
| order to function (dewey decimal) |
| |
| The default is 1.1 |
| |
| #PCDATA ::= [0-9]*{ "."[0-9] }0..3 |
| --> |
| |
| <!ELEMENT jspversion (#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 |
| --> |
| |
| <!ELEMENT shortname (#PCDATA) > |
| |
| <!-- |
| Defines a public URI that uniquely identifies this version of |
| the taglibrary Leave it empty if it does not apply. |
| --> |
| |
| <!ELEMENT uri (#PCDATA) > |
| |
| <!-- |
| Defines an arbitrary text string descirbing the tag library |
| --> |
| |
| <!ELEMENT info (#PCDATA) > |
| |
| <!-- |
| The tag defines a unique tag in this tag library, defining: |
| |
| - the unique tag/element name |
| - the subclass of javax.servlet.jsp.tagext.Tag implementation class |
| - an optional subclass of javax.servlet.jsp.tagext.TagExtraInfo |
| - the body content type (hint) |
| - optional tag-specific information |
| - any attributes |
| --> |
| |
| <!ELEMENT tag (name, tagclass, teiclass?, bodycontent?, info?, attribute*) > |
| |
| <!-- |
| 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 |
| --> |
| |
| <!ELEMENT tagclass (#PCDATA) > |
| |
| <!-- |
| Defines the subclass of javax.servlet.jsp.tagext.TagExtraInfo for |
| this tag. (optional) |
| |
| If this is not given, the class is not consulted at translation time. |
| |
| #PCDATA ::= fully qualified Java class name |
| --> |
| |
| <!ELEMENT teiclass (#PCDATA) > |
| |
| <!-- |
| 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: |
| |
| 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 |
| |
| The default (if not defined) is JSP |
| |
| #PCDATA ::= tagdependent | JSP | empty |
| |
| --> |
| |
| <!ELEMENT bodycontent (#PCDATA) > |
| |
| <!-- |
| The attribute tag defines an attribute for the nesting tag |
| |
| 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) |
| |
| --> |
| |
| <!ELEMENT attribute (name, required? , rtexprvalue?) > |
| |
| <!-- |
| Defines the canonical name of a tag or attribute being defined |
| |
| #PCDATA ::= NMTOKEN |
| --> |
| |
| <!ELEMENT name (#PCDATA) > |
| |
| <!-- |
| 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. |
| |
| #PCDATA ::= true | false | yes | no |
| |
| If not present then the default is "false", i.e the attribute |
| has a static value |
| --> |
| |
| <!ELEMENT rtexprvalue (#PCDATA) > |
| |
| <!ATTLIST tlibversion id ID #IMPLIED> |
| <!ATTLIST jspversion id ID #IMPLIED> |
| <!ATTLIST shortname id ID #IMPLIED> |
| <!ATTLIST uri id ID #IMPLIED> |
| <!ATTLIST info id ID #IMPLIED> |
| <!ATTLIST tag id ID #IMPLIED> |
| <!ATTLIST tagclass id ID #IMPLIED> |
| <!ATTLIST teiclass id ID #IMPLIED> |
| <!ATTLIST bodycontent id ID #IMPLIED> |
| <!ATTLIST attribute id ID #IMPLIED> |
| <!ATTLIST name id ID #IMPLIED> |
| <!ATTLIST required id ID #IMPLIED> |
| <!ATTLIST rtexprvalue id ID #IMPLIED> |