You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@myfaces.apache.org by sc...@apache.org on 2005/04/26 19:43:52 UTC

cvs commit: incubator-myfaces/build/tld-doc web-jsptaglibrary_1_2.dtd

schof       2005/04/26 10:43:52

  Modified:    build    build.xml
               lib      tlddoc.jar
               tlds     myfaces_core.tld myfaces_ext.tld myfaces_ext_sf.tld
                        myfaces_html.tld
  Added:       build/tld-doc web-jsptaglibrary_1_2.dtd
  Log:
  Fixes MYFACES-197.  Thanks to Marty Bosak for identifying the bug and supplying the fix.
  
  Revision  Changes    Path
  1.100     +19 -2     incubator-myfaces/build/build.xml
  
  Index: build.xml
  ===================================================================
  RCS file: /home/cvs/incubator-myfaces/build/build.xml,v
  retrieving revision 1.99
  retrieving revision 1.100
  diff -u -r1.99 -r1.100
  --- build.xml	26 Apr 2005 04:14:00 -0000	1.99
  +++ build.xml	26 Apr 2005 17:43:52 -0000	1.100
  @@ -24,6 +24,19 @@
       <property name="xdoclet.src" location="${project.dir}/src/xdoclet"/>
       <property name="generated.src" location="${project.dir}/src/generated"/>
       <property name="sign.script" location="${release.dir}/sign.sh"/>
  +    <property name="tlddoc.dir" location="${build.dir}/tld-doc"/>
  +    <property name="tlddoc.dtd" location="${tlddoc.dir}/web-jsptaglibrary_1_2.dtd"/>
  +
  +<!--
  +MLB:
  +Suggestion for MYFACES-92.  Place the xslt files in a separate directory
  +from the one create for MYFACES-197.  They probably could go in the same;
  +but as picky as TLDDoc is; I didn't take the chance.
  +-->
  +<!--
  +    <property name="tlddoc.xslt.dir" location="${build.dir}/TLDdoc-xslt"/>
  +-->
  +
   
       <!-- Properties -->
       <property file="build.local.properties"/>
  @@ -331,6 +344,10 @@
           <java fork="true" jar="${tlddoc.jar}" failonerror="true">
               <arg line="-doctitle 'Tag library for Apache MyFaces'" />
               <arg line="-d ${doc.dir}/tlddoc"/>
  +<!--
  +MLB:  MYFACES-92
  +            <arg line="-xslt ${tlddoc.xslt.dir}"/>
  +-->
               <arg value="${resolved-tlds.dir}/myfaces_ext.tld"/>
               <arg value="${generated.src}/myfaces_wap.tld"/>
   		</java>
  @@ -727,8 +744,8 @@
                 style="${tlds.dir}/resolve_entities.xsl"
                 extension=".tld">
               <xmlcatalog>
  -                <dtd publicId="-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
  -                     location="${tlds.dir}/web-jsptaglibrary_1_2.dtd"/>
  +                <dtd publicid="-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
  +                     location="${tlddoc.dtd}"/>
               </xmlcatalog>
           </xslt>
       </target>
  
  
  
  1.4       +589 -420  incubator-myfaces/lib/tlddoc.jar
  
  	<<Binary file>>
  
  
  1.27      +1 -1      incubator-myfaces/tlds/myfaces_core.tld
  
  Index: myfaces_core.tld
  ===================================================================
  RCS file: /home/cvs/incubator-myfaces/tlds/myfaces_core.tld,v
  retrieving revision 1.26
  retrieving revision 1.27
  diff -u -r1.26 -r1.27
  --- myfaces_core.tld	9 Apr 2005 19:10:51 -0000	1.26
  +++ myfaces_core.tld	26 Apr 2005 17:43:52 -0000	1.27
  @@ -27,7 +27,7 @@
   ]>
   
   
  -<taglib xmlns="http://java.sun.com/JSP/TagLibraryDescriptor">
  +<taglib>
   
       <tlib-version>0.9.0</tlib-version>
       <jsp-version>1.2</jsp-version>
  
  
  
  1.192     +1 -1      incubator-myfaces/tlds/myfaces_ext.tld
  
  Index: myfaces_ext.tld
  ===================================================================
  RCS file: /home/cvs/incubator-myfaces/tlds/myfaces_ext.tld,v
  retrieving revision 1.191
  retrieving revision 1.192
  diff -u -r1.191 -r1.192
  --- myfaces_ext.tld	19 Apr 2005 20:51:45 -0000	1.191
  +++ myfaces_ext.tld	26 Apr 2005 17:43:52 -0000	1.192
  @@ -66,7 +66,7 @@
   <!ENTITY alt_location_attributes             SYSTEM "entities/alt_location_attributes.xml">
   ]>
   
  -<taglib xmlns="http://java.sun.com/JSP/TagLibraryDescriptor">
  +<taglib>
   
       <tlib-version>0.9.0</tlib-version>
       <jsp-version>1.2</jsp-version>
  
  
  
  1.4       +1 -1      incubator-myfaces/tlds/myfaces_ext_sf.tld
  
  Index: myfaces_ext_sf.tld
  ===================================================================
  RCS file: /home/cvs/incubator-myfaces/tlds/myfaces_ext_sf.tld,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- myfaces_ext_sf.tld	13 Dec 2004 22:45:07 -0000	1.3
  +++ myfaces_ext_sf.tld	26 Apr 2005 17:43:52 -0000	1.4
  @@ -63,7 +63,7 @@
   <!ENTITY standard_select_many_checkbox_attributes SYSTEM "entities/standard_select_many_checkbox_attributes.xml">
   ]>
   
  -<taglib xmlns="http://java.sun.com/JSP/TagLibraryDescriptor">
  +<taglib>
   
       <tlib-version>0.9.0</tlib-version>
       <jsp-version>1.2</jsp-version>
  
  
  
  1.75      +1 -1      incubator-myfaces/tlds/myfaces_html.tld
  
  Index: myfaces_html.tld
  ===================================================================
  RCS file: /home/cvs/incubator-myfaces/tlds/myfaces_html.tld,v
  retrieving revision 1.74
  retrieving revision 1.75
  diff -u -r1.74 -r1.75
  --- myfaces_html.tld	19 Apr 2005 20:51:45 -0000	1.74
  +++ myfaces_html.tld	26 Apr 2005 17:43:52 -0000	1.75
  @@ -62,7 +62,7 @@
   <!ENTITY standard_select_many_checkbox_attributes SYSTEM "entities/standard_select_many_checkbox_attributes.xml">
   ]>
   
  -<taglib xmlns="http://java.sun.com/JSP/TagLibraryDescriptor">
  +<taglib>
   
       <tlib-version>0.9.0</tlib-version>
       <jsp-version>1.2</jsp-version>
  
  
  
  1.1                  incubator-myfaces/build/tld-doc/web-jsptaglibrary_1_2.dtd
  
  Index: web-jsptaglibrary_1_2.dtd
  ===================================================================
  <!--
     Copyright 2002 Sun Microsystems, Inc.  All rights reserved.
     Use is subject to license terms.
    -->
  
  <!--
  
     This is the DTD defining the JavaServer Pages 1.2 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.
  
     Use is subject to license terms.
    -->
  
  <!NOTATION WEB-JSPTAGLIB.1_2 PUBLIC
            "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN">
  
  <!--
  This is the XML DTD for the JSP 1.2 Tag Library Descriptor.
  All JSP 1.2 tag library descriptors must include a DOCTYPE
  of the following form:
  
    <!DOCTYPE taglib
          PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
  	"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
  
  -->
  
  <!--
  The taglib tag is the document root, it defines:
  
  tlib-version	the version of the tag library implementation
  
  jsp-version	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
  
  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
  small-icon      optional small-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
  
  validator       optional TagLibraryValidator information
  
  listener        optional event listener specification
  
  
  -->
  
  <!ELEMENT taglib (tlib-version, jsp-version, short-name, uri?,
                    display-name?, small-icon?, large-icon?, description?,
                    validator?, listener*, tag+) >
  
  <!ATTLIST taglib id ID #IMPLIED>
  
  <!--
  Describes this version (number) of the taglibrary (dewey decimal)
  
  #PCDATA ::= [0-9]*{ "."[0-9] }0..3
  -->
  
  <!ELEMENT tlib-version (#PCDATA) >
  
  <!--
  Describes the JSP version (number) this taglibrary requires in
  order to function (dewey decimal)
  
  The default is 1.2
  
  #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.
  
  #PCDATA ::= NMTOKEN
  -->
  
  <!ELEMENT short-name      (#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 description	(#PCDATA) >
  
  <!--
  
  Defines an optional validator that can be used to
  validate the conformance of a JSP page to using this tag library.
  -->
  
  <!ELEMENT validator (validator-class, init-param*, description?) >
  
  
  <!--
  
  Defines the TagLibraryValidator class that can be used to
  validate the conformance of a JSP page to using this tag library.
  -->
  
  <!ELEMENT validator-class (#PCDATA) >
  
  
  <!--
  
  The init-param element contains a name/value pair as an
  initialization param
  -->
  
  <!ELEMENT init-param (param-name, param-value, description?)>
  
  <!--
  
  The param-name element contains the name of a parameter.
  -->
  
  <!ELEMENT param-name (#PCDATA)>
  
  <!--
  
  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.
  -->
  
  <!ELEMENT listener-class (#PCDATA) >
  
  
  <!--
  The tag defines a unique tag in this tag library.  It has one
  attribute, id.
  
  The tag element may have several subelements defining:
  
  name              The unique action name
  
  tag-class         The tag handler class implementing
                    javax.servlet.jsp.tagext.Tag
  
  tei-class         An optional subclass of
                    javax.servlet.jsp.tagext.TagExtraInfo
  
  body-content      The body content type
  
  display-name      A short name that is intended to be displayed
                    by tools
  
  small-icon        Optional small-icon that can be used by tools
  
  large-icon        Optional large-icon that can be used by tools
  
  description       Optional tag-specific information
  
  variable          Optional scripting variable information
  
  attribute         All attributes of this action
  
  example           Optional informal description of an example of a
                    use of this tag
  
  -->
  
  <!ELEMENT tag (name, tag-class, tei-class?, body-content?, display-name?,
                 small-icon?, large-icon?, description?, variable*, attribute*,
                 example?) >
  
  <!--
  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 tag-class (#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 tei-class (#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 body-content (#PCDATA) >
  
  <!--
  
  The display-name element contains a short name that is intended
  to be displayed by tools.
  -->
  
  <!ELEMENT display-name (#PCDATA) >
  
  
  <!--
  
  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.
  -->
  
  <!ELEMENT small-icon (#PCDATA) >
  
  <!--
  
  The example element contains an informal description of an example
  of the use of a tag.
  -->
  
  <!ELEMENT example (#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 subelements of variable are of the form:
  
  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.
  
  description              Optional description of this variable
  
  -->
  
  <!ELEMENT variable ( (name-given | name-from-attribute), variable-class?,
                      declare?, scope?, description?) >
  
  <!--
  
  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.
  -->
  
  <!ELEMENT name-from-attribute (#PCDATA) >
  
  <!--
  
  The optional name of the class for the scripting variable.  The
  default is java.lang.String.
  -->
  
  <!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.
  -->
  
  <!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".
  -->
  
  <!ELEMENT scope (#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)
  - the type of the attributes value (optional)
  - an informal description of the meaning of the attribute (optional)
  
  -->
  
  
  <!--
  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)
  
  - the type of the attributes value (optional)
  
  - an informal description of the meaning of the attribute (optional)
  -->
  
  <!ELEMENT attribute (name, required? , rtexprvalue?, type?, description?) >
  
  <!--
  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) >
  
  
  <!--
  
  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 example 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>