<?xml version="1.0" encoding="UTF-8"?>
<!--

    Copyright (c) 2018 Oracle and/or its affiliates. All rights reserved.

    This program and the accompanying materials are made available under the
    terms of the Eclipse Public License v. 2.0, which is available at
    http://www.eclipse.org/legal/epl-2.0.

    This Source Code may also be made available under the following Secondary
    Licenses when the conditions for such availability set forth in the
    Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
    version 2 with the GNU Classpath Exception, which is available at
    https://www.gnu.org/software/classpath/license.html.

    SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0

-->

<xsd:schema
     targetNamespace="http://java.sun.com/xml/ns/javaee"
     xmlns:javaee="http://java.sun.com/xml/ns/javaee"
     xmlns:xsd="http://www.w3.org/2001/XMLSchema"
     elementFormDefault="qualified"
     attributeFormDefault="unqualified"
     version="2.1">

  <xsd:annotation>
    <xsd:documentation>
      @(#)web-jsptaglibrary_2_1.xsds	1.1
    </xsd:documentation>
  </xsd:annotation>

  <xsd:annotation>
    <xsd:documentation>
      <![CDATA[

	This is the XML Schema for the JSP Taglibrary
	descriptor.  All Taglibrary descriptors must
	indicate the tag library schema by using the Taglibrary
	namespace:

	http://java.sun.com/xml/ns/javaee

	and by indicating the version of the schema by
	using the version element as shown below:

	    <taglib xmlns="http://java.sun.com/xml/ns/javaee"
	      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	      xsi:schemaLocation="..."
	      version="2.1">
	      ...
	    </taglib>

	The instance documents may indicate the published
	version of the schema using xsi:schemaLocation attribute
	for Java EE namespace with the following location:

	http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd

	]]>
    </xsd:documentation>
  </xsd:annotation>

  <xsd:include schemaLocation="javaee_5.xsd"/>


<!-- **************************************************** -->

  <xsd:element name="taglib" type="javaee:tldTaglibType">
    <xsd:annotation>
      <xsd:documentation>

	The taglib tag is the document root.
	The definition of taglib is provided
	by the tldTaglibType.

      </xsd:documentation>
    </xsd:annotation>
    <xsd:unique name="tag-name-uniqueness">
      <xsd:annotation>
	<xsd:documentation>

	  The taglib element contains, among other things, tag and
	  tag-file elements.
	  The name subelements of these elements must each be unique.

	</xsd:documentation>
      </xsd:annotation>
      <xsd:selector xpath="javaee:tag|javaee:tag-file"/>
      <xsd:field    xpath="javaee:name"/>
    </xsd:unique>

    <xsd:unique name="function-name-uniqueness">
      <xsd:annotation>
	<xsd:documentation>

	  The taglib element contains function elements.
	  The name subelements of these elements must each be unique.

	</xsd:documentation>
      </xsd:annotation>
      <xsd:selector xpath="javaee:function"/>
      <xsd:field    xpath="javaee:name"/>
    </xsd:unique>

  </xsd:element>


<!-- **************************************************** -->

  <xsd:complexType name="body-contentType">
    <xsd:annotation>
      <xsd:documentation>

        Specifies the type of body that is valid for a tag.
	This value is used by the JSP container to validate
	that a tag invocation has the correct body syntax and
	by page composition tools to assist the page author
	in providing a valid tag body.

	There are currently four values specified:

	tagdependent    The body of the tag is interpreted by the tag
			implementation itself, and is most likely
			in a different "language", e.g embedded SQL
			statements.

	JSP             The body of the tag contains nested JSP
			syntax.

	empty           The body must be empty

	scriptless      The body accepts only template text, EL
			Expressions, and JSP action elements.  No
			scripting elements are allowed.

      </xsd:documentation>
    </xsd:annotation>

    <xsd:simpleContent>
      <xsd:restriction base="javaee:string">
	<xsd:enumeration value="tagdependent"/>
	<xsd:enumeration value="JSP"/>
	<xsd:enumeration value="empty"/>
	<xsd:enumeration value="scriptless"/>
      </xsd:restriction>
    </xsd:simpleContent>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="extensibleType" abstract="true">
    <xsd:annotation>
      <xsd:documentation>

	The extensibleType is an abstract base type that is used to
	define the type of extension-elements. Instance documents
	must substitute a known type to define the extension by
	using xsi:type attribute to define the actual type of
	extension-elements.

      </xsd:documentation>
    </xsd:annotation>
    <xsd:attribute name="id" type="xsd:ID"/>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="functionType">
    <xsd:annotation>
      <xsd:documentation>

	The function element is used to provide information on each
	function in the tag library that is to be exposed to the EL.

	The function element may have several subelements defining:

	description         Optional tag-specific information

	display-name        A short name that is intended to be
			    displayed by tools

	icon                Optional icon element that can be used
			    by tools

	name                A unique name for this function

	function-class      Provides the name of the Java class that
			    implements the function

	function-signature  Provides the signature, as in the Java
			    Language Specification, of the Java
			    method that is to be used to implement
			    the function.

	example             Optional informal description of an
			    example of a use of this function

	function-extension  Zero or more extensions that provide extra
			    information about this function, for tool
			    consumption

      </xsd:documentation>
    </xsd:annotation>

    <xsd:sequence>
      <xsd:group ref="javaee:descriptionGroup"/>
      <xsd:element name="name"
		   type="javaee:tld-canonical-nameType">
	<xsd:annotation>
	  <xsd:documentation>

	    A unique name for this function.

	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
      <xsd:element name="function-class"
		   type="javaee:fully-qualified-classType">
	<xsd:annotation>
	  <xsd:documentation>

	    Provides the fully-qualified class name of the Java
	    class containing the static method that implements
	    the function.

	  </xsd:documentation>
	</xsd:annotation>

      </xsd:element>
      <xsd:element name="function-signature"
		   type="javaee:string">
	<xsd:annotation>
	  <xsd:documentation>

	    Provides the signature, of the static Java method that is
	    to be used to implement the function.  The syntax of the
	    function-signature element is as follows:

		FunctionSignature ::= ReturnType S MethodName S?
				      '(' S? Parameters? S? ')'

                ReturnType        ::= Type

		MethodName        ::= Identifier

		Parameters        ::=   Parameter
				      | ( Parameter S? ',' S? Parameters )

                Parameter         ::= Type

		Where:

 		    * Type is a basic type or a fully qualified
		      Java class name (including package name),
		      as per the 'Type' production in the Java
		      Language Specification, Second Edition,
		      Chapter 18.

                    * Identifier is a Java identifier, as per
		      the 'Identifier' production in the Java
		      Language Specification, Second
		      Edition, Chapter 18.

	    Example:

	    java.lang.String nickName( java.lang.String, int )

	  </xsd:documentation>
	</xsd:annotation>

      </xsd:element>
      <xsd:element name="example"
		   type="javaee:xsdStringType"
		   minOccurs="0">
	<xsd:annotation>
	  <xsd:documentation>

	    The example element contains an informal description
	    of an example of the use of this function.

	  </xsd:documentation>
	</xsd:annotation>

      </xsd:element>
      <xsd:element name="function-extension"
		   type="javaee:tld-extensionType"
		   minOccurs="0"
		   maxOccurs="unbounded">
	<xsd:annotation>
	  <xsd:documentation>

	    Function extensions are for tool use only and must not
            affect the behavior of a container.

	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
    </xsd:sequence>
    <xsd:attribute name="id" type="xsd:ID"/>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="tagFileType">
    <xsd:annotation>
      <xsd:documentation>

	Defines an action in this tag library that is implemented
	as a .tag file.

	The tag-file element has two required subelements:

	description       Optional tag-specific information

	display-name      A short name that is intended to be
			  displayed by tools

	icon              Optional icon element that can be used
			  by tools

	name              The unique action name

	path              Where to find the .tag file implementing this
			  action, relative to the root of the web
			  application or the root of the JAR file for a
			  tag library packaged in a JAR.  This must
			  begin with /WEB-INF/tags if the .tag file
			  resides in the WAR, or /META-INF/tags if the
			  .tag file resides in a JAR.

	example           Optional informal description of an
			  example of a use of this tag

	tag-extension     Zero or more extensions that provide extra
			  information about this tag, for tool
			  consumption

      </xsd:documentation>
    </xsd:annotation>

    <xsd:sequence>
      <xsd:group ref="javaee:descriptionGroup"/>
      <xsd:element name="name"
		   type="javaee:tld-canonical-nameType"/>
      <xsd:element name="path"
		   type="javaee:pathType"/>
      <xsd:element name="example"
		   type="javaee:xsdStringType"
		   minOccurs="0">
	<xsd:annotation>
	  <xsd:documentation>

	    The example element contains an informal description
	    of an example of the use of a tag.

	  </xsd:documentation>
	</xsd:annotation>

      </xsd:element>
      <xsd:element name="tag-extension"
		   type="javaee:tld-extensionType"
		   minOccurs="0"
		   maxOccurs="unbounded">
	<xsd:annotation>
	  <xsd:documentation>

	    Tag extensions are for tool use only and must not affect
	    the behavior of a container.

	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
    </xsd:sequence>
    <xsd:attribute name="id" type="xsd:ID"/>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="tagType">
    <xsd:annotation>
      <xsd:documentation>

	The tag defines a unique tag in this tag library.  It has one
	attribute, id.

	The tag element may have several subelements defining:

	description       Optional tag-specific information

	display-name      A short name that is intended to be
			  displayed by tools

	icon              Optional icon element that can be used
			  by tools

	name              The unique action name

	tag-class         The tag handler class implementing
			  javax.servlet.jsp.tagext.JspTag

	tei-class         An optional subclass of
			  javax.servlet.jsp.tagext.TagExtraInfo

	body-content      The body content type

	variable          Optional scripting variable information

	attribute         All attributes of this action that are
			  evaluated prior to invocation.

	dynamic-attributes Whether this tag supports additional
			   attributes with dynamic names.  If
			   true, the tag-class must implement the
			   javax.servlet.jsp.tagext.DynamicAttributes
			   interface.  Defaults to false.

	example           Optional informal description of an
			  example of a use of this tag

	tag-extension     Zero or more extensions that provide extra
			  information about this tag, for tool
			  consumption

      </xsd:documentation>
    </xsd:annotation>

    <xsd:sequence>
      <xsd:group ref="javaee:descriptionGroup"/>
      <xsd:element name="name"
		   type="javaee:tld-canonical-nameType"/>
      <xsd:element name="tag-class"
		   type="javaee:fully-qualified-classType">
	<xsd:annotation>
	  <xsd:documentation>

	    Defines the subclass of javax.serlvet.jsp.tagext.JspTag
	    that implements the request time semantics for
	    this tag. (required)

	  </xsd:documentation>
	</xsd:annotation>

      </xsd:element>
      <xsd:element name="tei-class"
		   type="javaee:fully-qualified-classType"
		   minOccurs="0">
	<xsd:annotation>
	  <xsd:documentation>

	    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.

	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
      <xsd:element name="body-content"
		   type="javaee:body-contentType">
	<xsd:annotation>
	  <xsd:documentation>

	    Specifies the format for the body of this tag.
	    The default in JSP 1.2 was "JSP" but because this
	    is an invalid setting for simple tag handlers, there
	    is no longer a default in JSP 2.0.  A reasonable
	    default for simple tag handlers is "scriptless" if
	    the tag can have a body.

	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
      <xsd:element name="variable"
		   type="javaee:variableType"
		   minOccurs="0" maxOccurs="unbounded"/>
      <xsd:element name="attribute"
		   type="javaee:tld-attributeType"
		   minOccurs="0" maxOccurs="unbounded"/>
      <xsd:element name="dynamic-attributes"
		   type="javaee:generic-booleanType"
		   minOccurs="0"/>
      <xsd:element name="example"
		   type="javaee:xsdStringType"
		   minOccurs="0">
	<xsd:annotation>
	  <xsd:documentation>

	    The example element contains an informal description
	    of an example of the use of a tag.

	  </xsd:documentation>
	</xsd:annotation>

      </xsd:element>
      <xsd:element name="tag-extension"
		   type="javaee:tld-extensionType"
		   minOccurs="0"
		   maxOccurs="unbounded">
	<xsd:annotation>
	  <xsd:documentation>

	    Tag extensions are for tool use only and must not affect
	    the behavior of a container.

	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
    </xsd:sequence>
    <xsd:attribute name="id" type="xsd:ID"/>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="tld-attributeType">
    <xsd:annotation>
      <xsd:documentation>

	The attribute element defines an attribute for the nesting
	tag.  The attribute element may have several subelements
	defining:

	description     a description of the attribute

	name            the name of the attribute

	required        whether the attribute is required or
			optional

	rtexprvalue     whether the attribute is a runtime attribute

	type            the type of the attributes

	fragment        whether this attribute is a fragment

        deferred-value  present if this attribute is to be parsed as a
                        javax.el.ValueExpression

        deferred-method present if this attribute is to be parsed as a
                        javax.el.MethodExpression

      </xsd:documentation>
    </xsd:annotation>

    <xsd:sequence>
      <xsd:element name="description"
		   type="javaee:descriptionType"
		   minOccurs="0" maxOccurs="unbounded"/>
      <xsd:element name="name"
		   type="javaee:java-identifierType"/>
      <xsd:element name="required"
		   type="javaee:generic-booleanType"
		   minOccurs="0">
	<xsd:annotation>
	  <xsd:documentation>

	    Defines if the nesting attribute is required or
	    optional.

	    If not present then the default is "false", i.e
	    the attribute is optional.

	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
      <xsd:choice>
	<xsd:sequence>
          <xsd:sequence minOccurs="0">
	    <xsd:element name="rtexprvalue"
		         type="javaee:generic-booleanType">
	      <xsd:annotation>
	        <xsd:documentation>

		  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.
		  If not present then the default is "false", i.e the
		  attribute has a static value

	        </xsd:documentation>
	      </xsd:annotation>
	    </xsd:element>
	    <xsd:element name="type"
		         type="javaee:fully-qualified-classType"
		         minOccurs="0">
	      <xsd:annotation>
	        <xsd:documentation>

		  Defines the Java type of the attributes value.
                  If this element is omitted, the expected type is
                  assumed to be "java.lang.Object".

	        </xsd:documentation>
	      </xsd:annotation>
	    </xsd:element>
	  </xsd:sequence>

          <xsd:choice>
	    <xsd:element name="deferred-value"
		         type="javaee:tld-deferred-valueType"
		         minOccurs="0">
	      <xsd:annotation>
	        <xsd:documentation>

                  Present if the value for this attribute is to be
                  passed to the tag handler as a
                  javax.el.ValueExpression. This allows for deferred
                  evaluation of EL expressions. An optional subelement
                  will contain the expected type that the value will
                  be coerced to after evaluation of the expression.
                  The type defaults to Object if one is not provided.

	        </xsd:documentation>
	      </xsd:annotation>
	    </xsd:element>
	    <xsd:element name="deferred-method"
		       type="javaee:tld-deferred-methodType"
		       minOccurs="0">
	      <xsd:annotation>
	        <xsd:documentation>

                Present if the value for this attribute is to be
                passed to the tag handler as a
                javax.el.MethodExpression. This allows for deferred
                evaluation of an EL expression that identifies a
                method to be invoked on an Object. An optional
                subelement will contain the expected method
                signature. The signature defaults to "void method()"
                if one is not provided.

	        </xsd:documentation>
	      </xsd:annotation>
	    </xsd:element>
          </xsd:choice>
        </xsd:sequence>

	<xsd:element name="fragment"
		     type="javaee:generic-booleanType"
		     minOccurs="0">
	  <xsd:annotation>
	    <xsd:documentation>

	      "true" if this attribute is of type
	      javax.jsp.tagext.JspFragment, representing dynamic
	      content that can be re-evaluated as many times
	      as needed by the tag handler.  If omitted or "false",
	      the default is still type="java.lang.String"

	    </xsd:documentation>
	  </xsd:annotation>
	</xsd:element>

      </xsd:choice>
    </xsd:sequence>
    <xsd:attribute name="id" type="xsd:ID"/>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="tld-canonical-nameType">

    <xsd:annotation>
      <xsd:documentation>

	Defines the canonical name of a tag or attribute being
	defined.

	The name must conform to the lexical rules for an NMTOKEN.

      </xsd:documentation>
    </xsd:annotation>

    <xsd:simpleContent>
      <xsd:restriction base="javaee:xsdNMTOKENType"/>
    </xsd:simpleContent>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="tld-deferred-methodType">
    <xsd:annotation>
      <xsd:documentation>

        Defines information about how to provide the value for a
        tag handler attribute that accepts a javax.el.MethodExpression.

	The deferred-method element has one optional subelement:

	method-signature  Provides the signature, as in the Java
                          Language Specifies, that is expected for
                          the method being identified by the
                          expression.

      </xsd:documentation>
    </xsd:annotation>

    <xsd:sequence>
      <xsd:element name="method-signature"
                   type="javaee:string"
                   minOccurs="0">
        <xsd:annotation>
          <xsd:documentation>

            Provides the expected signature of the method identified
            by the javax.el.MethodExpression.

            This disambiguates overloaded methods and ensures that
            the return value is of the expected type.

            The syntax of the method-signature element is identical
            to that of the function-signature element.  See the
            documentation for function-signature for more details.

	    The name of the method is for documentation purposes only
	    and is ignored by the JSP container.

            Example:

              boolean validate(java.lang.String)

          </xsd:documentation>
        </xsd:annotation>
      </xsd:element>
    </xsd:sequence>

    <xsd:attribute name="id" type="xsd:ID"/>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="tld-deferred-valueType">
    <xsd:annotation>
      <xsd:documentation>

        Defines information about how to provide the value for a
        tag handler attribute that accepts a javax.el.ValueExpression.

	The deferred-value element has one optional subelement:

	type            the expected type of the attribute

      </xsd:documentation>
    </xsd:annotation>

    <xsd:sequence>
      <xsd:element name="type"
                   type="javaee:fully-qualified-classType"
                   minOccurs="0">
        <xsd:annotation>
          <xsd:documentation>

            The fully-qualified name of the Java type that is the
            expected type for this deferred expression.  If this
            element is omitted, the expected type is assumed to be
            "java.lang.Object".

          </xsd:documentation>
        </xsd:annotation>
      </xsd:element>
    </xsd:sequence>

    <xsd:attribute name="id" type="xsd:ID"/>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="tld-extensionType">
    <xsd:annotation>
      <xsd:documentation>

	The tld-extensionType is used to indicate
	extensions to a specific TLD element.

	It is used by elements to designate an extension block
	that is targeted to a specific extension designated by
	a set of extension elements that are declared by a
	namespace. The namespace identifies the extension to
	the tool that processes the extension.

	The type of the extension-element is abstract. Therefore,
	a concrete type must be specified by the TLD using
	xsi:type attribute for each extension-element.

      </xsd:documentation>
    </xsd:annotation>

    <xsd:sequence>
      <xsd:element name="extension-element"
		   type="javaee:extensibleType"
		   maxOccurs="unbounded"/>
    </xsd:sequence>

    <xsd:attribute name="namespace"
		   use="required"
		   type="xsd:anyURI"/>
    <xsd:attribute name="id" type="xsd:ID"/>

  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="tldTaglibType">
    <xsd:annotation>
      <xsd:documentation>

	The taglib tag is the document root, it defines:

	description     a simple string describing the "use" of this
			taglib, should be user discernable

	display-name    the display-name element contains a
			short name that is intended to be displayed
			by tools

	icon            optional icon that can be used by tools

	tlib-version    the version of the tag library implementation

	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

	uri             a uri uniquely identifying this taglib

	validator       optional TagLibraryValidator information

	listener        optional event listener specification

	tag             tags in this tag library

	tag-file        tag files in this tag library

	function        zero or more EL functions defined in this
			tag library

	taglib-extension zero or more extensions that provide extra
			information about this taglib, for tool
			consumption

      </xsd:documentation>
    </xsd:annotation>
    <xsd:sequence>
      <xsd:group ref="javaee:descriptionGroup"/>
      <xsd:element name="tlib-version"
		   type="javaee:dewey-versionType">
	<xsd:annotation>
	  <xsd:documentation>

	    Describes this version (number) of the taglibrary.
	    It is described as a dewey decimal.

	  </xsd:documentation>
	</xsd:annotation>

      </xsd:element>

      <xsd:element name="short-name"
		   type="javaee:tld-canonical-nameType">
	<xsd:annotation>
	  <xsd:documentation>

	    Defines a simple default name that could be used by
	    a JSP authoring tool to create names with a
	    mnemonicvalue; for example, it may be used as the
	    preferred prefix value in taglib directives.  Do
	    not use white space, and do not start with digits
	    or underscore.

	  </xsd:documentation>
	</xsd:annotation>

      </xsd:element>
      <xsd:element name="uri"
		   type="javaee:xsdAnyURIType"
		   minOccurs="0">
	<xsd:annotation>
	  <xsd:documentation>

	    Defines a public URI that uniquely identifies this
	    version of the taglibrary.  Leave it empty if it
	    does not apply.

	  </xsd:documentation>
	</xsd:annotation>

      </xsd:element>
      <xsd:element name="validator"
		   type="javaee:validatorType"
		   minOccurs="0">
      </xsd:element>
      <xsd:element name="listener"
		   type="javaee:listenerType"
		   minOccurs="0" maxOccurs="unbounded">
      </xsd:element>
      <xsd:element name="tag"
		   type="javaee:tagType"
		   minOccurs="0"
		   maxOccurs="unbounded"/>
      <xsd:element name="tag-file"
		   type="javaee:tagFileType"
		   minOccurs="0"
		   maxOccurs="unbounded"/>
      <xsd:element name="function"
		   type="javaee:functionType"
		   minOccurs="0"
		   maxOccurs="unbounded"/>
      <xsd:element name="taglib-extension"
		   type="javaee:tld-extensionType"
		   minOccurs="0"
		   maxOccurs="unbounded">
	<xsd:annotation>
	  <xsd:documentation>

	    Taglib extensions are for tool use only and must not
            affect the behavior of a container.

	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
    </xsd:sequence>
    <xsd:attribute name="version"
		   type="javaee:dewey-versionType"
		   fixed="2.1"
		   use="required">
      <xsd:annotation>
	<xsd:documentation>

	  Describes the JSP version (number) this taglibrary
	  requires in order to function (dewey decimal)

	</xsd:documentation>
      </xsd:annotation>

    </xsd:attribute>
    <xsd:attribute name="id" type="xsd:ID"/>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="validatorType">
    <xsd:annotation>
      <xsd:documentation>

	A validator that can be used to validate
	the conformance of a JSP page to using this tag library is
	defined by a validatorType.

      </xsd:documentation>
    </xsd:annotation>

    <xsd:sequence>
      <xsd:element name="description"
		   type="javaee:descriptionType"
		   minOccurs="0"
		   maxOccurs="unbounded"/>
      <xsd:element name="validator-class"
		   type="javaee:fully-qualified-classType">
	<xsd:annotation>
	  <xsd:documentation>

	    Defines the TagLibraryValidator class that can be used
	    to validate the conformance of a JSP page to using this
	    tag library.

	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
      <xsd:element name="init-param"
		   type="javaee:param-valueType"
		   minOccurs="0" maxOccurs="unbounded">
	<xsd:annotation>
	  <xsd:documentation>

	    The init-param element contains a name/value pair as an
	    initialization param.

	  </xsd:documentation>
	</xsd:annotation>

      </xsd:element>

    </xsd:sequence>
    <xsd:attribute name="id" type="xsd:ID"/>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="variable-scopeType">
    <xsd:annotation>
      <xsd:documentation>

	This type defines scope of the scripting variable.  See
	TagExtraInfo for details.  The allowed values are,
	"NESTED", "AT_BEGIN" and "AT_END".

      </xsd:documentation>
    </xsd:annotation>

    <xsd:simpleContent>
      <xsd:restriction base="javaee:string">
	<xsd:enumeration value="NESTED"/>
	<xsd:enumeration value="AT_BEGIN"/>
	<xsd:enumeration value="AT_END"/>
      </xsd:restriction>
    </xsd:simpleContent>
  </xsd:complexType>

<!-- **************************************************** -->

  <xsd:complexType name="variableType">
    <xsd:annotation>
      <xsd:documentation>

	The variableType provides information on the scripting
	variables defined by using 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 value from a call to getVariableInfo().

	The subelements of variableType are of the form:

	description              Optional description of this
				 variable

	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.

	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.

	scope                    The scope of the scripting varaible
				 defined.  NESTED is default.

      </xsd:documentation>
    </xsd:annotation>

    <xsd:sequence>
      <xsd:element name="description"
		   type="javaee:descriptionType"
		   minOccurs="0" maxOccurs="unbounded"/>
      <xsd:choice>
	<xsd:element name="name-given"
		     type="javaee:java-identifierType">
	  <xsd:annotation>
	    <xsd:documentation>

	      The name for the scripting variable.

	    </xsd:documentation>
	  </xsd:annotation>
	</xsd:element>

	<xsd:element name="name-from-attribute"
		     type="javaee:java-identifierType">
	  <xsd:annotation>
	    <xsd:documentation>

	      The name of an attribute whose
	      (translation-time) value will give the name of
	      the variable.

	    </xsd:documentation>
	  </xsd:annotation>
	</xsd:element>
      </xsd:choice>
      <xsd:element name="variable-class"
		   type="javaee:fully-qualified-classType"
		   minOccurs="0">
	<xsd:annotation>
	  <xsd:documentation>

	    The optional name of the class for the scripting
	    variable.  The default is java.lang.String.

	  </xsd:documentation>
	</xsd:annotation>

      </xsd:element>

      <xsd:element name="declare"
		   type="javaee:generic-booleanType"
		   minOccurs="0">

	<xsd:annotation>
	  <xsd:documentation>

	    Whether the scripting variable is to be defined
	    or not.  See TagExtraInfo for details.  This
	    element is optional and "true" is the default.

	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
      <xsd:element name="scope"
		   type="javaee:variable-scopeType"
		   minOccurs="0">
	<xsd:annotation>
	  <xsd:documentation>

	    The element is optional and "NESTED" is the default.

	  </xsd:documentation>
	</xsd:annotation>
      </xsd:element>
    </xsd:sequence>
    <xsd:attribute name="id" type="xsd:ID"/>
  </xsd:complexType>

</xsd:schema>

