krysalis-impus/src/documentation/content/xdocs/dtd book-cocoon-v10.dtd,NONE,1.1 catalog-v10.dtd,NONE,1.1 changes-v11.dtd,NONE,1.1 changes-v11.mod,NONE,1.1 common-charents-v10.mod,NONE,1.1 common-elems-v10.mod,NONE,1.1 contributors-v10.dtd,NONE,1.1 document-v11.dtd,NONE,1.1 document-v11.mod,NONE,1.1 faq-v11.dtd,NONE,1.1 faq-v11.mod,NONE,1.1 howto-v10.dtd,NONE,1.1 javadoc-v04draft.dtd,NONE,1.1 libre-v01.dtd,NONE,1.1 specification-v11.dtd,NONE,1.1 tab-cocoon-v10.dtd,NONE,1.1 todo-v11.dtd,NONE,1.1 todo-v11.mod,NONE,1.1 xgump-draft.dtd,NONE,1.1

[email protected]
Newsgroups gmane.comp.krysalis.sandbox
Message-ID <[email protected]>
Update of /cvsroot/metamorphosis/krysalis-impus/src/documentation/content/xdocs/dtd
In directory sc8-pr-cvs1:/tmp/cvs-serv2271/src/documentation/content/xdocs/dtd

Added Files:
	book-cocoon-v10.dtd catalog-v10.dtd changes-v11.dtd 
	changes-v11.mod common-charents-v10.mod common-elems-v10.mod 
	contributors-v10.dtd document-v11.dtd document-v11.mod 
	faq-v11.dtd faq-v11.mod howto-v10.dtd javadoc-v04draft.dtd 
	libre-v01.dtd specification-v11.dtd tab-cocoon-v10.dtd 
	todo-v11.dtd todo-v11.mod xgump-draft.dtd 
Log Message:
Initial import of the impus project.

--- NEW FILE: book-cocoon-v10.dtd ---
<!-- ===================================================================
     
     Apache Cocoon Documentation Book DTD (Version 1.0)

PURPOSE:
This DTD defines the */book.xml documentation configuration files.

TYPICAL INVOCATION:

  <!DOCTYPE book PUBLIC
       "-//APACHE//DTD Cocoon Documentation Book Vx.yz//EN"
       "book-cocoon-vxyz.dtd">

  where 
  
    x := major version
    y := minor version
    z := status identifier (optional)
      
NOTES:
We need to replace this DTD with the proper one.
We are only using this DTD to enable validation during "build docs"
because every XML instance must declare its ruleset.

This initial minimal DTD has been reverse-engineered from the structure
of the current documents, e.g. 
 documentation/xdocs/book.xml
  
AUTHORS:
  David Crossley <[email protected]>
  
FIXME:
  - find the proper DTD for book.xml

CHANGE HISTORY:
  20011031 Initial version. (DC)
    
COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.
  
  Permission to copy in any form is granted provided this notice is 
  included in all copies. Permission to redistribute is granted 
  provided this file is distributed untouched in all its parts and 
  included files.
  
==================================================================== -->

<!ELEMENT book (menu+)> 
<!ELEMENT menu (menu-item|external)*>
<!ELEMENT menu-item EMPTY>
<!ELEMENT external EMPTY>
<!ATTLIST book software CDATA #REQUIRED
               title CDATA #REQUIRED
               copyright CDATA #REQUIRED
               xmlns:xlink CDATA #IMPLIED
>
<!ATTLIST menu label CDATA #REQUIRED
>
<!ATTLIST menu-item label CDATA #REQUIRED
                    href CDATA #REQUIRED
                    type (visible|hidden) "visible"
>
<!ATTLIST external  label CDATA #REQUIRED
                    href CDATA #REQUIRED
                    type (visible|hidden) "visible"
>

<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->

--- NEW FILE: catalog-v10.dtd ---
<!-- Id: catalog.dtd,v 1.10 2002/10/18 23:54:58 ndw Exp -->
<!-- http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd -->

<!ENTITY % pubIdChars "CDATA">
<!ENTITY % publicIdentifier "%pubIdChars;">
<!ENTITY % partialPublicIdentifier "%pubIdChars;">
<!ENTITY % uriReference "CDATA">
<!ENTITY % string "CDATA">
<!ENTITY % systemOrPublic "(system|public)">

<!ENTITY % p "">
<!ENTITY % s "">
<!ENTITY % nsdecl "xmlns%s;">

<!ENTITY % catalog "%p;catalog">
<!ENTITY % public "%p;public">
<!ENTITY % system "%p;system">
<!ENTITY % uri "%p;uri">
<!ENTITY % rewriteSystem "%p;rewriteSystem">
<!ENTITY % rewriteURI "%p;rewriteURI">
<!ENTITY % delegatePublic "%p;delegatePublic">
<!ENTITY % delegateSystem "%p;delegateSystem">
<!ENTITY % delegateURI "%p;delegateURI">
<!ENTITY % nextCatalog "%p;nextCatalog">
<!ENTITY % group "%p;group">

<!ENTITY % local.catalog.mix "">
<!ENTITY % local.catalog.attribs "">

<!ELEMENT %catalog; (%public;|%system;|%uri;
                     |%rewriteSystem;|%rewriteURI;
                     |%delegatePublic;|%delegateSystem;|%delegateURI;
                     |%nextCatalog;|%group; %local.catalog.mix;)+>
<!ATTLIST %catalog;
	%nsdecl;	%uriReference;		#FIXED
		'urn:oasis:names:tc:entity:xmlns:xml:catalog'
	prefer		%systemOrPublic;	#IMPLIED
	xml:base	%uriReference;		#IMPLIED
	%local.catalog.attribs;
>

<!ENTITY % local.public.attribs "">

<!ELEMENT %public; EMPTY>
<!ATTLIST %public;
	id		ID			#IMPLIED
	publicId	%publicIdentifier;	#REQUIRED
	uri		%uriReference;		#REQUIRED
	xml:base	%uriReference;		#IMPLIED
        %local.public.attribs;
>

<!ENTITY % local.system.attribs "">

<!ELEMENT %system; EMPTY>
<!ATTLIST %system;
	id		ID			#IMPLIED
	systemId	%string;		#REQUIRED
	uri		%uriReference;		#REQUIRED
	xml:base	%uriReference;		#IMPLIED
        %local.system.attribs;
>

<!ENTITY % local.uri.attribs "">

<!ELEMENT %uri; EMPTY>
<!ATTLIST %uri;
	id		ID			#IMPLIED
	name		%string;		#REQUIRED
	uri		%uriReference;		#REQUIRED
	xml:base	%uriReference;		#IMPLIED
        %local.uri.attribs;
>

<!ENTITY % local.rewriteSystem.attribs "">

<!ELEMENT %rewriteSystem; EMPTY>
<!ATTLIST %rewriteSystem;
	id		ID			#IMPLIED
	systemIdStartString	%string;	#REQUIRED
	rewritePrefix		%string;		#REQUIRED
        %local.rewriteSystem.attribs;
>

<!ENTITY % local.rewriteURI.attribs "">

<!ELEMENT %rewriteURI; EMPTY>
<!ATTLIST %rewriteURI;
	id		ID			#IMPLIED
	uriStartString	%string;		#REQUIRED
	rewritePrefix	%string;		#REQUIRED
        %local.rewriteURI.attribs;
>

<!ENTITY % local.delegatePublic.attribs "">

<!ELEMENT %delegatePublic; EMPTY>
<!ATTLIST %delegatePublic;
	id		ID			#IMPLIED
	publicIdStartString	%partialPublicIdentifier;	#REQUIRED
	catalog		%uriReference;		#REQUIRED
	xml:base	%uriReference;		#IMPLIED
        %local.delegatePublic.attribs;
>

<!ENTITY % local.delegateSystem.attribs "">

<!ELEMENT %delegateSystem; EMPTY>
<!ATTLIST %delegateSystem;
	id		ID			#IMPLIED
	systemIdStartString	%string;	#REQUIRED
	catalog		%uriReference;		#REQUIRED
	xml:base	%uriReference;		#IMPLIED
        %local.delegateSystem.attribs;
>

<!ENTITY % local.delegateURI.attribs "">

<!ELEMENT %delegateURI; EMPTY>
<!ATTLIST %delegateURI;
	id		ID			#IMPLIED
	uriStartString	%string;		#REQUIRED
	catalog		%uriReference;		#REQUIRED
	xml:base	%uriReference;		#IMPLIED
        %local.delegateURI.attribs;
>

<!ENTITY % local.nextCatalog.attribs "">

<!ELEMENT %nextCatalog; EMPTY>
<!ATTLIST %nextCatalog;
	id		ID			#IMPLIED
	catalog		%uriReference;		#REQUIRED
	xml:base	%uriReference;		#IMPLIED
        %local.nextCatalog.attribs;
>

<!ENTITY % local.group.mix "">
<!ENTITY % local.group.attribs "">

<!ELEMENT %group; (%public;|%system;|%uri;
                   |%rewriteSystem;|%rewriteURI;
                   |%delegatePublic;|%delegateSystem;|%delegateURI;
                   |%nextCatalog; %local.group.mix;)+>
<!ATTLIST %group;
	id		ID			#IMPLIED
	prefer		%systemOrPublic;	#IMPLIED
	xml:base	%uriReference;		#IMPLIED
        %local.group.attribs;
>

--- NEW FILE: changes-v11.dtd ---
<!-- ===================================================================

     Apache Changes DTD (Version 1.1)

PURPOSE:
  This DTD was developed to create a simple yet powerful document
  type for software development changes for use with the Apache projects.
  It is an XML-compliant DTD and it's maintained by the Apache XML
  project.

TYPICAL INVOCATION:

  <!DOCTYPE document PUBLIC
       "-//APACHE//DTD Changes Vx.y//EN"
       "changes-vxy.dtd">

  where

    x := major version
    y := minor version

NOTES:
  It is important, expecially in open developped software projects, to keep
  track of software changes both to give users indications of bugs that might
  have been resolved, as well, and not less important, to provide credits
  for the support given to the project. It is considered vital to provide
  adequate payback using recognition and credits to let users and developers
  feel part of the community, thus increasing development power.

AUTHORS:
  Stefano Mazzocchi <[email protected]>
  Steven Noels <[email protected]>

FIXME:

CHANGE HISTORY:
[Version 1.0]
  20020611 Initial version. (SN)
  20020613 Include the module of ISO character entity sets (DC)

COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.

  Permission to copy in any form is granted provided this notice is
  included in all copies. Permission to redistribute is granted
  provided this file is distributed untouched in all its parts and
  included files.

==================================================================== -->

<!-- =============================================================== -->
<!-- Include the Documentation DTD -->
<!-- =============================================================== -->

<!ENTITY % document PUBLIC
    "-//APACHE//ENTITIES Documentation V1.1//EN"
    "document-v11.mod">
%document;

<!-- =============================================================== -->
<!-- Include the Common ISO Character Entity Sets -->
<!-- =============================================================== -->

<!ENTITY % common-charents PUBLIC
    "-//APACHE//ENTITIES Common Character Entity Sets V1.0//EN"
    "common-charents-v10.mod">
%common-charents;

<!-- =============================================================== -->
<!-- Include the Common elements -->
<!-- =============================================================== -->

<!ENTITY % common PUBLIC
    "-//APACHE//ENTITIES Common Elements V1.0//EN"
    "common-elems-v10.mod">
%common;

<!-- =============================================================== -->
<!-- Include the Changes module -->
<!-- =============================================================== -->

<!ENTITY % changes PUBLIC
    "-//APACHE//ENTITIES Changes V1.1//EN"
    "changes-v11.mod">
%changes;

<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->

--- NEW FILE: changes-v11.mod ---
<!-- ===================================================================

     Apache Changes Module (Version 1.1)

PURPOSE:
  This DTD was developed to create a simple yet powerful document
  type for software development changes for use with the Apache projects.
  It is an XML-compliant DTD and it's maintained by the Apache XML
  project.

TYPICAL INVOCATION:

  <!ENTITY % changes PUBLIC
      "-//APACHE//ENTITIES Changes Vxy//EN"
      "changes-vxy.mod">
  %changes;

  where

    x := major version
    y := minor version

NOTES:
  It is important, expecially in open developped software projects, to keep
  track of software changes both to give users indications of bugs that might
  have been resolved, as well, and not less important, to provide credits
  for the support given to the project. It is considered vital to provide
  adequate payback using recognition and credits to let users and developers
  feel part of the community, thus increasing development power.

AUTHORS:
  Stefano Mazzocchi <[email protected]>

FIXME:

CHANGE HISTORY:
[Version 1.0]
  19991129 Initial version. (SM)
  20000316 Added bugfixing attribute. (SM)
[Version 1.1]
  20011212 Used public identifiers for external entities (SM)

COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.

  Permission to copy in any form is granted provided this notice is
  included in all copies. Permission to redistribute is granted
  provided this file is distributed untouched in all its parts and
  included files.

==================================================================== -->

<!-- =============================================================== -->
<!-- Document Type Definition -->
<!-- =============================================================== -->

<!ELEMENT changes (title?, devs?, release+)>
<!ATTLIST changes %common.att;>

    <!ELEMENT release (action+)>
    <!ATTLIST release %common.att;
                      version  CDATA  #REQUIRED
                      date     CDATA  #REQUIRED>

<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->

--- NEW FILE: common-charents-v10.mod ---
<!-- ===================================================================

     Apache Common Character Entity Sets (Version 1.0)

PURPOSE:
  Common elements across all DTDs.

TYPICAL INVOCATION:

  <!ENTITY % common-charents PUBLIC
      "-//APACHE//ENTITIES Common Character Entity Sets Vx.y//EN"
      "common-charents-vxy.mod">
  %common-charents;

  where

    x := major version
    y := minor version

AUTHORS:
  David Crossley <[email protected]>

FIXME:

CHANGE HISTORY:
[Version 1.0]
  20020613 Initial version. (DC)

COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.

  Permission to copy in any form is granted provided this notice is
  included in all copies. Permission to redistribute is granted
  provided this file is distributed untouched in all its parts and
  included files.

==================================================================== -->

<!-- =============================================================== -->
<!-- Common ISO character entity sets -->
<!-- =============================================================== -->

<!ENTITY % ISOlat1 PUBLIC
    "ISO 8879:1986//ENTITIES Added Latin 1//EN//XML"
    "ISOlat1.pen">
%ISOlat1;

<!ENTITY % ISOpub PUBLIC
    "ISO 8879:1986//ENTITIES Publishing//EN//XML"
    "ISOpub.pen">
%ISOpub;

<!ENTITY % ISOtech PUBLIC
    "ISO 8879:1986//ENTITIES General Technical//EN//XML"
    "ISOtech.pen">
%ISOtech;

<!ENTITY % ISOnum PUBLIC
    "ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN//XML"
    "ISOnum.pen">
%ISOnum;

<!ENTITY % ISOdia PUBLIC
    "ISO 8879:1986//ENTITIES Diacritical Marks//EN//XML"
    "ISOdia.pen">
%ISOdia;

<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->

--- NEW FILE: common-elems-v10.mod ---
<!-- ===================================================================

     Apache Common Elements (Version 1.0)

PURPOSE:
  Common elements across DTDs

TYPICAL INVOCATION:

  <!ENTITY % common PUBLIC
      "-//APACHE//ENTITIES Common elements Vx.y//EN"
      "common-elems-vxy.mod">
  %common;

  where

    x := major version
    y := minor version

AUTHORS:
  Steven Noels <[email protected]>

FIXME:

CHANGE HISTORY:
[Version 1.0]
  20020611 Initial version. (SN)

COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.

  Permission to copy in any form is granted provided this notice is
  included in all copies. Permission to redistribute is granted
  provided this file is distributed untouched in all its parts and
  included files.

==================================================================== -->

<!-- =============================================================== -->
<!-- Common entities -->
<!-- =============================================================== -->

<!ENTITY % types "add|remove|update|fix">
<!ENTITY % contexts "build|docs|code|admin|design">

<!-- =============================================================== -->
<!-- Common elements -->
<!-- =============================================================== -->

<!ELEMENT devs (person+)>
<!ATTLIST devs %common.att;>

<!ELEMENT action (%content.mix;)*>
<!ATTLIST action %common.att;
          dev  IDREF  #REQUIRED
          type (%types;)  #IMPLIED
          context (%contexts;) #IMPLIED
          due-to CDATA #IMPLIED
          due-to-email CDATA #IMPLIED
          fixes-bug CDATA #IMPLIED>

<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->

--- NEW FILE: contributors-v10.dtd ---
<!-- ===================================================================

     Apache Contributors DTD (Version 1.1)

PURPOSE:
  This DTD was developed to create a simple document listing the
  contributors to a project.

TYPICAL INVOCATION:

  <!DOCTYPE contributors PUBLIC
       "-//APACHE//DTD Contributors Vx.y//EN"
       "contributors-vxy.dtd">

  where

    x := major version
    y := minor version

NOTES:

AUTHORS:
  Steven Noels <[email protected]>

FIXME:

CHANGE HISTORY:
[Version 1.0]
  20020608 Initial version. (SN)

COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.

  Permission to copy in any form is granted provided this notice is
  included in all copies. Permission to redistribute is granted
  provided this file is distributed untouched in all its parts and
  included files.

==================================================================== -->

<!-- =============================================================== -->
<!-- Include the common documentation elements -->
<!-- =============================================================== -->

<!ENTITY % document PUBLIC
    "-//APACHE//DTD Documentation V1.1//EN"
    "document-v11.dtd">
%document;

<!-- =============================================================== -->
<!-- Document Type Definition -->
<!-- =============================================================== -->

<!ELEMENT contributors (header, (category | contributors)+)>
<!ATTLIST contributors %common.att;>

    <!ELEMENT category (title, contributor+) >
    <!ATTLIST category %common.att;>

    <!ELEMENT contributor (person, img?, bio)>
    <!ATTLIST contributor %common.att;>

        <!ELEMENT bio (%blocks;)*>
        <!ATTLIST bio %common.att;>

<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->

--- NEW FILE: document-v11.dtd ---
<!-- ===================================================================

     Apache Documentation DTD (Version 1.1)

PURPOSE:
  This DTD was developed to create a simple yet powerful document
  type for software documentation for use with the Apache projects.
  It is an XML-compliant DTD and it's maintained by the Apache XML
  project.

TYPICAL INVOCATION:

  <!DOCTYPE document PUBLIC
       "-//APACHE//DTD Documentation Vx.y//EN"
       "document-vxy.dtd">

  where

    x := major version
    y := minor version

NOTES:
  Many of the design patterns used in this DTD were take from the
  W3C XML Specification DTD edited by Eve Maler <[email protected]>.

  Where possible, great care has been used to reuse HTML tag
  names to reduce learning efforts and to allow HTML editors to be
  used for complex authorings like tables and lists.

EXTENSIBILITY:
  This DTD includes several empty placeholders that can be used to
  extend it. These placeholders are implemented with empty entities. Here
  is the list of those empty entities and what they are used for:

    - local.inline: this entity should contain extended definitions of
                    elements that can be used 'inline', or directly inside
                    the content. An example for this entity could be

                        <!ENTITY % local.inline "|citation">

    - local.blocks: this entity should contain extended definitions of
                    elements that behave as 'blocks', thus can be visually
                    rendered as areas on the canvas. An example for this
                    entity could be:

                        <!ENTITY % local.blocks "|poem">

    - local.sections: this entity should contain extended definitions of
                      elements that behave as 'sections', thus can be considered
                      containers of block-level elements. An example for
                      this entity could be:

                        <!ENTITY % local.sections "|chapter">

    - local.headers: this entity should contain extended definitions of
                     elements that behave as parts of the document header.
                     An example for this header could be:

                        <!ENTITY % local.headers ", notes?">

    - local.footers: this entity should contain extended definitions of
                     elements that behave as parts of the document footer.
                     An example for this header could be:

                        <!ENTITY % local.footers ", annotations*">


AUTHORS:
  Stefano Mazzocchi <[email protected]>
  Steven Noels <[email protected]>

FIXME:
  - should "form" tags be included?

CHANGE HISTORY:
[Version 1.0]
  19991121 Initial version. (SM)
  19991123 Replaced "res" with more standard "strong" for emphasis. (SM)
  19991124 Added "fork" element for window forking behavior. (SM)
  19991124 Added "img-inline" element to separate from "img". (SM)
  19991129 Removed "affiliation" from "author". (SM)
  19991129 Made "author" empty and moved "name|email" as attributes. (SM)
  19991215 Simplified table section. (SM)
  19991215 Changed "img-block" in more friendly "figure". (SM)
  20000125 Added the "icon" image. (SM)
  20000126 Allowed "anchor" in all levels. (SM)
  20000404 Removed the "role" attribute from common-xxx.att. (SM)
  20000815 Allowed "code" inside "strong" and "em". (SM)
[Version 1.1]
  20011212 Used public identifiers for external entities. (SM)
  20011212 Removed xlink attributes since not used. (SM)
  20011212 Removed "connect" since not required at this level. (SM)
  20011218 Added "warning" as a block level object. (SM)
  20011218 Removed explicitly numbered sections ("s1|s2|s3|s4"). (SM)
  20011218 Added "section" element. (SM)
  20011218 Allowed "body" to have blocks without a section. (SM)
  20011218 Removed "sl" since not really different from "ul". (SM)
  20020214 Moved empty placeholder entity declarations up front (SNS)
  20020214 Corrected content model of content.mix parameter entity (SNS)
  20020519 The DTDs are now modular so various parts can be re-used (SNS)
  20020606 Made title into an child element of its parent instead of an attribute (SNS)
  20020613 Move the declarations of ISO character entity sets to module (DC)

COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.

  Permission to copy in any form is granted provided this notice is
  included in all copies. Permission to redistribute is granted
  provided this file is distributed untouched in all its parts and
  included files.

==================================================================== -->


<!-- =============================================================== -->
<!-- Include the Common ISO Character Entity Sets -->
<!-- =============================================================== -->

<!ENTITY % common-charents PUBLIC
    "-//APACHE//ENTITIES Common Character Entity Sets V1.0//EN"
    "common-charents-v10.mod">
%common-charents;

<!-- =============================================================== -->
<!-- Document -->
<!-- =============================================================== -->

<!ENTITY % document PUBLIC
    "-//APACHE//ENTITIES Documentation V1.1//EN"
    "document-v11.mod">
%document;

<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->

--- NEW FILE: document-v11.mod ---
<!-- ===================================================================

     Apache Common Documentation elements (Version 1.1)

PURPOSE:
  This DTD was developed to create a simple yet powerful document
  type for software documentation for use with the Apache projects.

TYPICAL INVOCATION:

  <!ENTITY % document PUBLIC
      "-//APACHE//ENTITIES Documentation Vxy//EN"
      "document-vxy.mod">
  %document;

  where

    x := major version
    y := minor version

NOTES:

AUTHORS:
  Stefano Mazzocchi <[email protected]>
  Steven Noels <[email protected]>

FIXME:

CHANGE HISTORY:
[Version 1.0]
  20020608 Initial version. (SN)

COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.

  Permission to copy in any form is granted provided this notice is
  included in all copies. Permission to redistribute is granted
  provided this file is distributed untouched in all its parts and
  included files.

==================================================================== -->
<!-- =============================================================== -->
<!-- Useful entities for increased DTD readability -->
<!-- =============================================================== -->
<!ENTITY % text "#PCDATA">
<!-- Entities referred to later on are defined up front -->
<!ENTITY % markup "strong|em|code|sub|sup">
<!ENTITY % special-inline "br|img|icon|acronym">
<!ENTITY % links "link|jump|fork">
<!ENTITY % paragraphs "p|source|note|warning|fixme">
<!ENTITY % tables "table">
<!ENTITY % lists "ol|ul|dl">
<!ENTITY % special-blocks "figure|anchor">
<!-- =============================================================== -->
<!-- Entities for general XML compliance -->
<!-- =============================================================== -->
<!-- Common attributes
        Every element has an ID attribute (sometimes required,
        but usually optional) for links. %common.att;
        is for common attributes where the ID is optional, and
        %common-idreq.att; is for common attributes where the
        ID is required.
-->
<!ENTITY % common.att 'id                     ID              #IMPLIED
         xml:lang               NMTOKEN         #IMPLIED'>
<!ENTITY % common-idreq.att 'id                     ID              #REQUIRED
         xml:lang               NMTOKEN         #IMPLIED'>
<!-- xml:space attribute ===============================================
        Indicates that the element contains white space
        that the formatter or other application should retain,
        as appropriate to its function.
==================================================================== -->
<!ENTITY % xmlspace.att 'xml:space (default|preserve) #FIXED "preserve"'>
<!-- def attribute =====================================================
        Points to the element where the relevant definition can be
        found, using the IDREF mechanism.  %def.att; is for optional
        def attributes, and %def-req.att; is for required def
        attributes.
==================================================================== -->
<!ENTITY % def.att 'def                    IDREF           #IMPLIED'>
<!ENTITY % def-req.att 'def                    IDREF           #REQUIRED'>
<!-- ref attribute =====================================================
        Points to the element where more information can be found,
        using the IDREF mechanism.  %ref.att; is for optional
        ref attributes, and %ref-req.att; is for required ref
        attributes.
================================================================== -->
<!ENTITY % ref.att 'ref                    IDREF           #IMPLIED'>
<!ENTITY % ref-req.att 'ref                    IDREF           #REQUIRED'>
<!-- =============================================================== -->
<!-- Entities for general usage -->
<!-- =============================================================== -->
<!-- Key attribute =====================================================
        Optionally provides a sorting or indexing key, for cases when
        the element content is inappropriate for this purpose.
==================================================================== -->
<!ENTITY % key.att 'key                    CDATA           #IMPLIED'>
<!-- Title attributes ==================================================
        Indicates that the element requires to have a title attribute.
==================================================================== -->
<!ENTITY % title.att 'title                  CDATA           #REQUIRED'>
<!-- Name attributes ==================================================
        Indicates that the element requires to have a name attribute.
==================================================================== -->
<!ENTITY % name.att 'name                   CDATA           #REQUIRED'>
<!-- Email attributes ==================================================
        Indicates that the element requires to have an email attribute.
==================================================================== -->
<!ENTITY % email.att 'email                  CDATA           #REQUIRED'>
<!-- Link attributes ===================================================
        Indicates that the element requires to have hyperlink attributes.
==================================================================== -->
<!ENTITY % link.att 'href      CDATA                         #IMPLIED
         role      CDATA                         #IMPLIED
         title     CDATA                         #IMPLIED '>
<!-- =============================================================== -->
<!-- General definitions -->
<!-- =============================================================== -->
<!-- A person is a general unparsed human entity -->
<!ELEMENT person EMPTY>
<!ATTLIST person
  %common.att; 
  %name.att; 
  %email.att; 
>
<!-- =============================================================== -->
<!-- Content definitions -->
<!-- =============================================================== -->
<!ENTITY % local.inline "">
<!ENTITY % link-content.mix "%text;|%markup;|%special-inline; %local.inline;">
<!ENTITY % content.mix "%link-content.mix;|%links;">
<!-- ==================================================== -->
<!-- Phrase Markup -->
<!-- ==================================================== -->
<!-- Strong (typically bold) -->
<!ELEMENT strong (%text; | code)*>
<!ATTLIST strong
  %common.att; 
>
<!-- Emphasis (typically italic) -->
<!ELEMENT em (%text; | code)*>
<!ATTLIST em
  %common.att; 
>
<!-- Code (typically monospaced) -->
<!ELEMENT code (%text;)>
<!ATTLIST code
  %common.att; 
>
<!-- Superscript (typically smaller and higher) -->
<!ELEMENT sup (%text;)>
<!ATTLIST sup
  %common.att; 
>
<!-- Subscript (typically smaller and lower) -->
<!ELEMENT sub (%text;)>
<!ATTLIST sub
  %common.att; 
>
<!-- ==================================================== -->
<!-- Hypertextual Links -->
<!-- ==================================================== -->
<!-- hyperlink (equivalent of <a ...>) -->
<!ELEMENT link (%link-content.mix;)*>
<!ATTLIST link
  %common.att; 
  %link.att; 
>
<!-- windows-replacing link (equivalent of <a ... target="_top">) -->
<!ELEMENT jump (%link-content.mix;)*>
<!ATTLIST jump
  %common.att; 
  %link.att; 
>
<!-- window-forking link (equivalent of <a ... target="_blank">) -->
<!ELEMENT fork (%link-content.mix;)*>
<!ATTLIST fork
  %common.att; 
  %link.att; 
>

<!-- ==================================================== -->
<!-- Specials -->
<!-- ==================================================== -->
<!-- Breakline Object (typically forces line break) -->
<!ELEMENT br EMPTY>
<!ATTLIST br
  %common.att; 
>
<!-- Image Object (typically an inlined image) -->
<!ELEMENT img EMPTY>
<!ATTLIST img
  src CDATA #REQUIRED
  alt CDATA #REQUIRED
  height CDATA #IMPLIED
  width CDATA #IMPLIED
  usemap CDATA #IMPLIED
  ismap (ismap) #IMPLIED
  %common.att; 
>
<!-- Image Icon (typically an inlined image placed as graphical item) -->
<!ELEMENT icon EMPTY>
<!ATTLIST icon
  src CDATA #REQUIRED
  alt CDATA #REQUIRED
  height CDATA #IMPLIED
  width CDATA #IMPLIED
  %common.att; 
>
<!-- Acronym (in modern browsers, will have rollover text) -->
<!ELEMENT acronym (%text;)*>
<!ATTLIST acronym
  title CDATA #REQUIRED
  %common.att; 
>

<!-- =============================================================== -->
<!-- Blocks definitions -->
<!-- =============================================================== -->
<!ENTITY % local.blocks "">
<!ENTITY % blocks "%paragraphs;|%tables;|%lists;|%special-blocks; %local.blocks;">
<!-- ==================================================== -->
<!-- Paragraphs -->
<!-- ==================================================== -->
<!-- Text Paragraph (normally vertically space delimited. Space can be preserved.) -->
<!ELEMENT p (%content.mix;)*>
<!ATTLIST p
  %common.att; 
  xml:space (default|preserve) #IMPLIED
>
<!-- Source Paragraph (normally space is preserved) -->
<!ELEMENT source (%content.mix;)*>
<!ATTLIST source
  %common.att; 
  %xmlspace.att; 
>
<!-- Note Paragraph (normally shown encapsulated) -->
<!ELEMENT note (%content.mix;)*>
<!ATTLIST note
  %common.att; 
>
<!-- Warning Paragraph (normally shown with eye-catching colors) -->
<!ELEMENT warning (%content.mix;)*>
<!ATTLIST warning
  %common.att; 
>
<!-- Fixme Paragraph (normally not shown) -->
<!ELEMENT fixme (%content.mix;)*>
<!ATTLIST fixme
  author CDATA #REQUIRED
  %common.att; 
>
<!-- ==================================================== -->
<!-- Tables -->
<!-- ==================================================== -->
<!-- Attributes that indicate the spanning of the table cell -->
<!ENTITY % cell.span 'colspan CDATA "1"
         rowspan CDATA "1"'>
<!-- Table element -->
<!ELEMENT table (caption?, tr+)>
<!ATTLIST table
  %common.att; 
>
<!-- The table title -->
<!ELEMENT caption (%content.mix;)*>
<!ATTLIST caption
  %common.att; 
>
<!-- The table row element -->
<!ELEMENT tr (th | td)+>
<!ATTLIST tr
  %common.att; 
>
<!-- The table row header element -->
<!ELEMENT th (%content.mix;)*>
<!ATTLIST th
  %common.att; 
  %cell.span; 
>
<!-- The table row description element -->
<!ELEMENT td (%content.mix;)*>
<!ATTLIST td
  %common.att; 
  %cell.span; 
>
<!-- ==================================================== -->
<!-- Lists -->
<!-- ==================================================== -->
<!-- List item -->
<!ELEMENT li (%content.mix; | %lists;)*>
<!ATTLIST li
  %common.att; 
>
<!-- Unordered list (typically bulleted) -->
<!ELEMENT ul (li | %lists;)+>
<!--    spacing attribute:
            Use "normal" to get normal vertical spacing for items;
            use "compact" to get less spacing.  The default is dependent
            on the stylesheet. -->
<!ATTLIST ul
  %common.att; 
  spacing (normal | compact) #IMPLIED
>
<!-- Ordered list (typically numbered) -->
<!ELEMENT ol (li | %lists;)+>
<!--    spacing attribute:
            Use "normal" to get normal vertical spacing for items;
            use "compact" to get less spacing.  The default is dependent
            on the stylesheet. -->
<!ATTLIST ol
  %common.att; 
  spacing (normal | compact) #IMPLIED
>
<!-- Definition list (typically two-column) -->
<!ELEMENT dl (dt, dd)+>
<!ATTLIST dl
  %common.att; 
>
<!-- Definition term -->
<!ELEMENT dt (%content.mix;)*>
<!ATTLIST dt
  %common.att; 
>
<!-- Definition description -->
<!ELEMENT dd (%content.mix;)*>
<!ATTLIST dd
  %common.att; 
>
<!-- ==================================================== -->
<!-- Special Blocks -->
<!-- ==================================================== -->
<!-- Image Block (typically a separated and centered image) -->
<!ELEMENT figure EMPTY>
<!ATTLIST figure
  src CDATA #REQUIRED
  alt CDATA #REQUIRED
  height CDATA #IMPLIED
  width CDATA #IMPLIED
  usemap CDATA #IMPLIED
  ismap (ismap) #IMPLIED
  %common.att; 
>
<!-- anchor point (equivalent of <a name="...">, typically not rendered) -->
<!ELEMENT anchor EMPTY>
<!ATTLIST anchor
  %common-idreq.att; 
>
<!-- =============================================================== -->
<!-- Document -->
<!-- =============================================================== -->
<!ELEMENT document (header, body, footer?)>
<!ATTLIST document
  %common.att; 
>
<!-- ==================================================== -->
<!-- Header -->
<!-- ==================================================== -->
<!ENTITY % local.headers "">
<!ELEMENT header (title, subtitle?, version?, type?, authors?,
                      notice*, abstract? %local.headers;)>
<!ATTLIST header
  %common.att; 
>
<!ELEMENT title (%text; | %markup;)*>
<!ATTLIST title
  %common.att; 
>
<!ELEMENT subtitle (%text; | %markup;)*>
<!ATTLIST subtitle
  %common.att; 
>
<!ELEMENT version (%text;)>
<!ATTLIST version
  %common.att;
  major CDATA #IMPLIED
  minor CDATA #IMPLIED
  fix CDATA #IMPLIED
  tag CDATA #IMPLIED
>
<!ELEMENT type (%text;)>
<!ATTLIST type
  %common.att; 
>
<!ELEMENT authors (person+)>
<!ATTLIST authors
  %common.att; 
>
<!ELEMENT notice (%content.mix;)*>
<!ATTLIST notice
  %common.att; 
>
<!ELEMENT abstract (%content.mix;)*>
<!ATTLIST abstract
  %common.att; 
>
<!-- ==================================================== -->
<!-- Body -->
<!-- ==================================================== -->
<!ENTITY % local.sections "">
<!ENTITY % sections "section %local.sections;">
<!ELEMENT body (%sections; | %blocks;)+>
<!ATTLIST body
  %common.att; 
>
<!ELEMENT section (title, (%sections; | %blocks;)*)>
<!ATTLIST section
  %common.att; 
>
<!-- ==================================================== -->
<!-- Footer -->
<!-- ==================================================== -->
<!ENTITY % local.footers "">
<!ELEMENT footer (legal %local.footers;)>
<!ELEMENT legal (%content.mix;)*>
<!ATTLIST legal
  %common.att; 
>
<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->

--- NEW FILE: faq-v11.dtd ---
<!-- ===================================================================

     Apache FAQ DTD (Version 1.1)

PURPOSE:
  This DTD was developed to create a simple yet powerful document
  type for software FAQ's for use with the Apache projects.
  It is an XML-compliant DTD and it's maintained by the Apache XML
  project.

TYPICAL INVOCATION:

  <!DOCTYPE faqs PUBLIC
       "-//APACHE//DTD FAQ Vx.y//EN"
       "faq-vxy.dtd">

  where

    x := major version
    y := minor version

NOTES:
  FAQs represent a powerful knowledge base and a very good way of solving
  common user problems reducing messages on mail lists and reducing the effort
  required for software installation and usage. Thid DTD want to be a common
  format for FAQ interchange to allow FAQ-O-Matic-type workgroup services to
  be published in other formats as well as enhancing data interchange.

AUTHORS:
  Stefano Mazzocchi <[email protected]>

FIXME:

CHANGE HISTORY:
  19991129 Initial version. (SM)
  20011212 Used public identifiers for external entities (SM)
  20020418 Added an (optional) 'part' element to create sections in a faq (SN)
  20020613 Include the module of ISO character entity sets (DC)

COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.

  Permission to copy in any form is granted provided this notice is
  included in all copies. Permission to redistribute is granted
  provided this file is distributed untouched in all its parts and
  included files.

==================================================================== -->

<!-- =============================================================== -->
<!-- Include the Documentation DTD -->
<!-- =============================================================== -->

<!ENTITY % document PUBLIC
    "-//APACHE//ENTITIES Documentation V1.1//EN"
    "document-v11.mod">
%document;

<!-- =============================================================== -->
<!-- Include the Common ISO Character Entity Sets -->
<!-- =============================================================== -->

<!ENTITY % common-charents PUBLIC
    "-//APACHE//ENTITIES Common Character Entity Sets V1.0//EN"
    "common-charents-v10.mod">
%common-charents;

<!-- =============================================================== -->
<!-- Document Type Definition -->
<!-- =============================================================== -->

<!ENTITY % faq PUBLIC
    "-//APACHE//ENTITIES FAQ V1.1//EN"
    "faq-v11.mod">
%faq;

<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->

--- NEW FILE: faq-v11.mod ---
<!-- ===================================================================

     Apache Faq module (Version 1.1)

TYPICAL INVOCATION:

  <!ENTITY % faq PUBLIC
      "-//APACHE//ENTITIES FAQ Vxy//EN"
      "faq-vxy.mod">
  %faq;

  where

    x := major version
    y := minor version

NOTES:

AUTHORS:
  Steven Noels <[email protected]>

FIXME:

CHANGE HISTORY:
[Version 1.0]
  20020608 Initial version. (SN)

COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.

  Permission to copy in any form is granted provided this notice is
  included in all copies. Permission to redistribute is granted
  provided this file is distributed untouched in all its parts and
  included files.

==================================================================== -->

<!-- =============================================================== -->
<!-- Element declarations -->
<!-- =============================================================== -->

<!ELEMENT faqs (authors?, (faq|part)+)>
<!ATTLIST faqs %common.att;
               %title.att;>

    <!ELEMENT part (title, (faq | part)+) >
    <!ATTLIST part %common.att;>

    <!ELEMENT faq (question, answer)>
    <!ATTLIST faq %common.att;>

        <!ELEMENT question (%content.mix;)*>
        <!ATTLIST question %common.att;>

        <!ELEMENT answer (%blocks;)*>
        <!ATTLIST answer author IDREF #IMPLIED>

<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->

--- NEW FILE: howto-v10.dtd ---
<!-- ===================================================================

     Apache How-To DTD (Version 1.0)

PURPOSE:
  This DTD was developed to create a simple yet powerful document
  type for software How-Tos for use with the Apache projects.
  It is an XML-compliant DTD and is maintained by the Apache XML project.

TYPICAL INVOCATION:

  <!DOCTYPE document PUBLIC
       "-//APACHE//DTD How-To Vx.y//EN"
       "howto-vxy.dtd">

  where

    x := major version
    y := minor version

NOTES:
  How-Tos help software users accomplish a specific task with clear
  and consise instructions.

AUTHORS:
  Diana Shannon <[email protected]>

FIXME:

CHANGE HISTORY:
  20020515 Initial version. (DS)
  20020521 Added feedback element. (DS)
  20020613 Include the module of ISO character entity sets (DC)

COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.

  Permission to copy in any form is granted provided this notice is
  included in all copies. Permission to redistribute is granted
  provided this file is distributed untouched in all its parts and
  included files.

==================================================================== -->

<!-- =============================================================== -->
<!-- Local entities -->
<!-- =============================================================== -->

<!ENTITY % local.headers ", last-modified-content-date">

<!-- =============================================================== -->
<!-- Include other DTD modules and entity sets -->
<!-- =============================================================== -->

<!ENTITY % document PUBLIC
    "-//APACHE//ENTITIES Documentation V1.1//EN"
    "document-v11.mod">
%document;

<!ENTITY % faq PUBLIC
    "-//APACHE//ENTITIES FAQ V1.1//EN"
    "faq-v11.mod">
%faq;

<!ENTITY % common-charents PUBLIC
    "-//APACHE//ENTITIES Common Character Entity Sets V1.0//EN"
    "common-charents-v10.mod">
%common-charents;

<!-- =============================================================== -->
<!-- Document Type Definition -->
<!-- =============================================================== -->

<!ELEMENT howto (header, audience?, purpose?, prerequisites?, steps,
    extension?, faqs?, tips?, references?, feedback? )>
<!ATTLIST howto %common.att;>


    <!ELEMENT overview (%blocks;)* >
    <!ATTLIST overview %title.att; %common.att;>

    <!ELEMENT purpose (%blocks;)* >
    <!ATTLIST purpose %title.att; %common.att;>

    <!ELEMENT prerequisites (section | %blocks;)* >
    <!ATTLIST prerequisites %title.att; %common.att;>

    <!ELEMENT audience (%blocks;)* >
    <!ATTLIST audience %title.att; %common.att;>

    <!ELEMENT steps (section | %blocks;)* >
    <!ATTLIST steps %title.att; %common.att;>

    <!ELEMENT extension (%blocks;)* >
    <!ATTLIST extension %title.att; %common.att;>

    <!ELEMENT tips (section | %blocks;)* >
    <!ATTLIST tips %title.att; %common.att;>

    <!ELEMENT references (section | %blocks;)* >
    <!ATTLIST references %title.att; %common.att;>

    <!ELEMENT feedback (%blocks;)* >
    <!ATTLIST feedback %title.att; %common.att;>

    <!ELEMENT last-modified-content-date EMPTY >
    <!ATTLIST last-modified-content-date date CDATA #REQUIRED>

<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->

--- NEW FILE: javadoc-v04draft.dtd ---
<!-- ===================================================================
     
     Apache JavaDoc DTD (version 0.4-draft)

PURPOSE:
  This DTD is designed to capture the output of JavaDoc as an XML document
  through the use of the JavaDocXML Doclet. The hope is that by having the
  JavaDoc documentation in an XML format, it will be easier for application
  developers working with XML to treat their java source documentation in the
  same way they treat any other XML document within their publication framework.
  
  This DTD should reflect the information contained within the RootDoc object 
  passed to the JavaDocXML Doclet by JavaDoc. The RootDoc object and the rest 
  of the javaDoc Doclet API is specified at
  
  http://java.sun.com/products/jdk/1.2/docs/tooldocs/javadoc/doclet/index.html
  
  The only information that appears to be difficult to derive from this DTD
  that is easy to obtain from the RootDoc object is the information about 
  serialization. However, this information should be derivable by manually 
  looking for the correct serialization methods and other related structures.
  
TYPICAL INVOCATION:

  <!DOCTYPE document PUBLIC
       "-//APACHE//DTD JavaDoc Vx.yz//EN"
       "javadoc-vxyz.dtd">

  where 
  
    x := major version
    y := minor version
    z := status identifier (optional)
      
NOTES:  
  The authors would like to thank the Cocoon's mail list subscribers for 
  providing such great support and feedback for this DTD.
  
AUTHORS:
  Kenneth Murphy <[email protected]>
  
FIXME:

CHANGE HISTORY:
  199909?? Original idea of XML doclet. (KM)
  199910?? Initial version of this DTD. (KM)
  19991129 Cleaned up DTD. (SM)
    
COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.
  
  Permission to copy in any form is granted provided this notice is 
  included in all copies. Permission to redistribute is granted 
  provided this file is distributed untouched in all its parts and 
  included files.
  
==================================================================== -->

<!-- =============================================================== -->
<!-- Common Attribute Entities -->
<!-- =============================================================== -->

<!ENTITY % name 'name CDATA #REQUIRED'>
<!ENTITY % dimension 'dimension CDATA #REQUIRED'>

<!ENTITY % abstract 'abstract (true | false) "false"'>
<!ENTITY % anonymous 'anonymous (true | false) "false"'>
<!ENTITY % synthetic 'synthetic (true | false) "false"'>
<!ENTITY % static 'static (true | false) "false"'>
<!ENTITY % final 'final (true | false) "false"'>
<!ENTITY % transient 'transient (true | false) "false"'>
<!ENTITY % volatile 'volatile (true | false) "false"'>
<!ENTITY % native 'native (true | false) "false"'>
<!ENTITY % synchronized 'synchronized (true | false) "false"'>

<!ENTITY % access 'access (private | package | protected | public) "package"'>
<!ENTITY % class.access 'access (package | public) "package"'>

<!ENTITY % extensibility 'extensibility (abstract | final | default) "default"'>


<!-- =============================================================== -->
<!-- Javadoc -->
<!-- =============================================================== -->

<!ELEMENT javadoc (package*, class*, interface*)>

<!-- =============================================================== -->
<!-- Package -->
<!-- =============================================================== -->

<!ELEMENT package (doc?, package*, class*, interface*)>
<!ATTLIST package %name;>

<!-- =============================================================== -->
<!-- Class -->
<!-- =============================================================== -->

<!ELEMENT class (doc?,
                 extends_class?,
                 implements?,
                 field*, 
                 constructor*, 
                 method*,
                 innerclass*)>
<!ATTLIST class
          %name;
          %extensibility;
          %class.access;>

<!ELEMENT extends_class (classref+)>
          
<!ELEMENT innerclass (doc?,
                      extends?,
                      implements?,
                      field*, 
                      constructor*, 
                      method*)>
<!ATTLIST innerclass
          %name;
          %access;
          %abstract;
          %anonymous;
          %final;
          %static;>
          
<!-- =============================================================== -->
<!-- Interface -->
<!-- =============================================================== -->
          
<!ELEMENT interface (doc?,
                     extends_interface?,
                     field*,
                     method*)>
<!ATTLIST interface
          %name;
          %access;>
          
<!ELEMENT extends_interface (interfaceref+)>

<!-- =============================================================== -->
<!-- Elements -->
<!-- =============================================================== -->

<!ELEMENT implements (interfaceref+)>

<!ELEMENT throws (classref)+>

<!ELEMENT classref EMPTY>
<!ATTLIST classref %name;>
          
<!ELEMENT interfaceref EMPTY>
<!ATTLIST interfaceref %name;>
          
<!ELEMENT methodref EMPTY>
<!ATTLIST methodref %name;>
          
<!ELEMENT packageref EMPTY>
<!ATTLIST packageref %name;>
          
<!ELEMENT primitive EMPTY>
<!ATTLIST primitive
          type (void | boolean | int | long | byte | short | double | float | char) #REQUIRED>
          
<!ELEMENT field (doc?, (classref | interfaceref | primitive))>
<!ATTLIST field
          %name;
          %access;
          %dimension;
          %synthetic;
          %static;
          %final;
          %transient;
          %volatile;>
          
<!ELEMENT constructor (doc?, parameter*, throws*)>
<!ATTLIST constructor
          %name;
          %access;
          %synthetic;>
          
<!ELEMENT method (doc?, returns, parameter*, throws*)>
<!ATTLIST method
          %name;
          %access;
          %extensibility;
          %native;
          %synthetic;
          %static;
          %synchronized;>
          
<!ELEMENT returns (classref | interfaceref | primitive)>
<!ATTLIST returns %dimension;>
          
<!ELEMENT parameter (classref | interfaceref | primitive)>
<!ATTLIST parameter
          %name;
          %final;
          %dimension;>
          
<!ELEMENT dimension (#PCDATA)>

<!ELEMENT doc (#PCDATA | 
               linktag |
               authortag |
               versiontag |
               paramtag |
               returntag |
               exceptiontag |
               throwstag |
               seetag |
               sincetag |
               deprecatedtag |
               serialtag |
               serialfieldtag |
               serialdatatag)*>
               
<!ELEMENT linktag (#PCDATA)>
<!ATTLIST linktag
          src CDATA #REQUIRED>
          
<!ELEMENT authortag (#PCDATA | linktag)*>

<!ELEMENT versiontag (#PCDATA | linktag)*>

<!ELEMENT paramtag (#PCDATA | linktag)*>
<!ATTLIST paramtag %name;>
          
<!ELEMENT returntag (#PCDATA | linktag)*>

<!ELEMENT exceptiontag (#PCDATA | classref | linktag)*>

<!ELEMENT throwstag (#PCDATA | classref | linktag)*>

<!ELEMENT seetag (#PCDATA | linktag)*>
<!ATTLIST seetag
          src CDATA #REQUIRED>
          
<!ELEMENT sincetag (#PCDATA | linktag)*>

<!ELEMENT deprecatedtag (#PCDATA | linktag)*>

<!ELEMENT serialtag (#PCDATA | linktag)*>

<!ELEMENT serialfieldtag (#PCDATA | linktag)*>
<!ATTLIST serialfieldtag
          fieldname CDATA #REQUIRED
          fieldtype CDATA #REQUIRED>
          
<!ELEMENT serialdatatag (#PCDATA | linktag)*>

<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->

--- NEW FILE: libre-v01.dtd ---
<?xml version="1.0" encoding="UTF-8"?>
<!ELEMENT libre (entry | auto)*>
<!ELEMENT entry (label?, href?)>
<!ATTLIST entry
  location CDATA #REQUIRED
>
<!ELEMENT auto (filter?, sorter?, label?, href?)>
<!ELEMENT label (xpath | property)>
<!ELEMENT href (xpath | property)>
<!ELEMENT filter (xpath | property)>
<!ATTLIST filter
  logic (inverse | normal) "normal"
  clear (yes | no) "no"
>
<!ELEMENT sorter (xpath | property)>
<!ATTLIST sorter
  order (ascending | descending) "ascending"
  clear (yes | no) "no"
>
<!ELEMENT xpath EMPTY>
<!ATTLIST xpath
  expression CDATA #REQUIRED
>
<!ELEMENT property EMPTY>
<!ATTLIST property
  name CDATA #REQUIRED
  mask CDATA #IMPLIED
  regex CDATA #IMPLIED
  substitute CDATA #IMPLIED
>

--- NEW FILE: specification-v11.dtd ---
<!-- ===================================================================

     Apache Specification DTD (Version 1.1)

PURPOSE:
  This DTD was developed to create a simple yet powerful document
  type for software specifications for use with the Apache projects.
  It is an XML-compliant DTD and it's maintained by the Apache XML
  project.

TYPICAL INVOCATION:

  <!DOCTYPE document PUBLIC
       "-//APACHE//DTD Specification Vx.y//EN"
       "specification-vxy.dtd">

  where

    x := major version
    y := minor version

NOTES:

AUTHORS:
  Stefano Mazzocchi <[email protected]>

FIXME:

CHANGE HISTORY:
[Version 1.0]
  19991129 Initial version. (SM)
[Version 1.1]
  20011212 Used public identifiers for external entities (SM)

COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.

  Permission to copy in any form is granted provided this notice is
  included in all copies. Permission to redistribute is granted
  provided this file is distributed untouched in all its parts and
  included files.

==================================================================== -->

<!-- =============================================================== -->
<!-- Include the Documentation DTD -->
<!-- =============================================================== -->

<!ENTITY % document PUBLIC
    "-//APACHE//ENTITIES Documentation V1.1//EN"
    "document-v11.mod">
%document;


<!-- =============================================================== -->
<!-- Extend the Documentation DTD -->
<!-- =============================================================== -->

<!-- extend the local.xxx entities -->
<!ENTITY % local.blocks "|bl">


<!-- =============================================================== -->
<!-- Document Type Definition -->
<!-- =============================================================== -->

<!ELEMENT specification (header?, body, appendices?, footer?)>
<!ATTLIST specification %common.att;>

    <!ELEMENT appendices (%sections;)+>
    <!ATTLIST appendices %common.att;>

<!-- =============================================================== -->
<!-- Bibliography List -->
<!-- =============================================================== -->

    <!-- Bibliography list -->
    <!ELEMENT bl (bi)+>
    <!ATTLIST bl %common.att;>

        <!-- Book item -->
        <!ELEMENT bi EMPTY>
        <!ATTLIST bi %common.att;
                     %name.att;
                     %link.att;
                     authors CDATA #REQUIRED
                     date    CDATA #IMPLIED>

<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->

--- NEW FILE: tab-cocoon-v10.dtd ---
<!-- ===================================================================
     
     Apache Cocoon Documentation Tab DTD (Version 1.0)

PURPOSE:
This DTD defines the */tab.xml documentation configuration files.  Tabs are
visual indicators that a certain subsection of the URI space is being browsed.

TYPICAL INVOCATION:

  <!DOCTYPE tab PUBLIC
       "-//APACHE//DTD Cocoon Documentation Tab Vx.yz//EN"
       "tab-cocoon-vxyz.dtd">

  where 
  
    x := major version
    y := minor version
    z := status identifier (optional)
      
NOTES:
  
AUTHORS:
  Bert Van Kets <[email protected]>
  Jeff Turner <[email protected]>
  
FIXME:
  - find the proper DTD for top.xml

CHANGE HISTORY:
  20021102 Revised to allow either @dir or @href (JT)
  20020506 Initial version. (BVK)
    
COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.
  
  Permission to copy in any form is granted provided this notice is 
  included in all copies. Permission to redistribute is granted 
  provided this file is distributed untouched in all its parts and 
  included files.
  
==================================================================== -->
<!ELEMENT tabs (tab)*>
<!ELEMENT tab EMPTY>
<!ATTLIST tabs
  software CDATA #REQUIRED
  title CDATA #REQUIRED
  copyright CDATA #REQUIRED
  xmlns:xlink CDATA #IMPLIED
>
<!ATTLIST tab
  label CDATA #REQUIRED
  dir CDATA #IMPLIED
  href CDATA #IMPLIED
  type (visible | hidden) "visible"
>
<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->

--- NEW FILE: todo-v11.dtd ---
<!-- ===================================================================

     Apache Todos DTD (Version 1.1)

PURPOSE:
  This DTD was developed to create a simple yet powerful document
  type for software development todo lists for use with the Apache projects.
  It is an XML-compliant DTD and it's maintained by the Apache XML
  project.

TYPICAL INVOCATION:

  <!DOCTYPE todo PUBLIC
       "-//APACHE//DTD Todo Vx.y//EN"
       "todo-vxy.dtd">

  where

    x := major version
    y := minor version

NOTES:
  It is important, expecially in open developped software projects, to keep
  track of software changes that need to be done, planned features, development
  assignment, etc. in order to allow better work parallelization and create
  an entry point for people that want to help. This DTD wants to provide
  a solid foundation to provide such information and to allow it to be
  published as well as distributed in a common format.

AUTHORS:
  Stefano Mazzocchi <[email protected]>

FIXME:
  - do we need anymore working contexts? (SM)

CHANGE HISTORY:
[Version 1.0]
  19991129 Initial version. (SM)
  19991225 Added actions element for better structure (SM)
[Version 1.1]
  20011212 Used public identifiers for external entities (SM)
  20020613 Include the module of ISO character entity sets (DC)

COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.

  Permission to copy in any form is granted provided this notice is
  included in all copies. Permission to redistribute is granted
  provided this file is distributed untouched in all its parts and
  included files.

==================================================================== -->

<!-- =============================================================== -->
<!-- Include the Documentation DTD -->
<!-- =============================================================== -->

<!ENTITY % document PUBLIC
    "-//APACHE//ENTITIES Documentation V1.1//EN"
    "document-v11.mod">
%document;

<!-- =============================================================== -->
<!-- Include the Common ISO Character Entity Sets -->
<!-- =============================================================== -->

<!ENTITY % common-charents PUBLIC
    "-//APACHE//ENTITIES Common Character Entity Sets V1.0//EN"
    "common-charents-v10.mod">
%common-charents;

<!-- =============================================================== -->
<!-- Include the Common elements -->
<!-- =============================================================== -->

<!ENTITY % common PUBLIC
    "-//APACHE//ENTITIES Common Elements V1.0//EN"
    "common-elems-v10.mod">
%common;

<!-- =============================================================== -->
<!-- Include the Todo module -->
<!-- =============================================================== -->

<!ENTITY % todo PUBLIC
    "-//APACHE//ENTITIES Todo V1.1//EN"
    "todo-v11.mod">
%todo;

<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->

--- NEW FILE: todo-v11.mod ---
<!-- ===================================================================

     Apache Todos module (Version 1.0)

PURPOSE:
  This DTD was developed to create a simple yet powerful document
  type for software development todo lists for use with the Apache projects.
  It is an XML-compliant DTD and it's maintained by the Apache XML
  project.

TYPICAL INVOCATION:

  <!ENTITY % todo PUBLIC
      "-//APACHE//ENTITIES Todo Vxy//EN"
      "todo-vxy.mod">
  %todo;

  where

    x := major version
    y := minor version

NOTES:
  It is important, expecially in open developped software projects, to keep
  track of software changes that need to be done, planned features, development
  assignment, etc. in order to allow better work parallelization and create
  an entry point for people that want to help. This DTD wants to provide
  a solid foundation to provide such information and to allow it to be
  published as well as distributed in a common format.

AUTHORS:
  Stefano Mazzocchi <[email protected]>

FIXME:
  - do we need anymore working contexts? (SM)

CHANGE HISTORY:
[Version 1.0]
  19991129 Initial version. (SM)
  19991225 Added actions element for better structure (SM)
[Version 1.1]
  20011212 Used public identifiers for external entities (SM)

COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.

  Permission to copy in any form is granted provided this notice is
  included in all copies. Permission to redistribute is granted
  provided this file is distributed untouched in all its parts and
  included files.

==================================================================== -->
<!-- =============================================================== -->
<!-- Common entities -->
<!-- =============================================================== -->
<!ENTITY % priorities "showstopper|high|medium|low|wish|dream">
<!-- =============================================================== -->
<!-- Document Type Definition -->
<!-- =============================================================== -->
<!ELEMENT todo (title?, devs?, actions+)>
<!ATTLIST todo
  %common.att; 
>

<!ELEMENT actions (action+)>
<!ATTLIST actions
  %common.att; 
  priority (%priorities;) #IMPLIED
>
<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->

--- NEW FILE: xgump-draft.dtd ---
<!-- ===================================================================

     Apache XGump DTD (Version 1.0)

PURPOSE:
  Gump descriptor DTD

TYPICAL INVOCATION:

  <!DOCTYPE module PUBLIC
       "-//APACHE//DTD Gump Descriptor Vx.y//EN"
       "xgump-draft.dtd">

  where

    x := major version
    y := minor version

AUTHORS:
  Steven Noels <[email protected]>

FIXME:
* cannot yet include the module of ISO character entity sets because
forrest.xgump has trouble with the catalog entity resolver at startup.

CHANGE HISTORY:
[Version 1.0]
  20020611 Initial version. (SN)

COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.

  Permission to copy in any form is granted provided this notice is
  included in all copies. Permission to redistribute is granted
  provided this file is distributed untouched in all its parts and
  included files.

==================================================================== -->

<!-- =============================================================== -->
<!-- Include the Documentation DTD -->
<!-- =============================================================== -->

<!ENTITY % document PUBLIC
    "-//APACHE//ENTITIES Documentation V1.1//EN"
    "document-v11.mod">
%document;

<!-- =============================================================== -->
<!-- Include the Common ISO Character Entity Sets -->
<!-- =============================================================== -->

<!--
<!ENTITY % common-charents PUBLIC
    "-//APACHE//ENTITIES Common Character Entity Sets V1.0//EN"
    "common-charents-v10.mod">
%common-charents;
-->

<!-- =============================================================== -->
<!-- Include the Common elements -->
<!-- =============================================================== -->

<!ENTITY % common PUBLIC
    "-//APACHE//ENTITIES Common Elements V1.0//EN"
    "common-elems-v10.mod">
%common;

<!-- =============================================================== -->
<!-- Include the Todo module -->
<!-- =============================================================== -->

<!ENTITY % todo PUBLIC
    "-//APACHE//ENTITIES Todo V1.1//EN"
    "todo-v11.mod">
%todo;

<!-- =============================================================== -->
<!-- Include the Changes module -->
<!-- =============================================================== -->

<!ENTITY % changes PUBLIC
    "-//APACHE//ENTITIES Changes V1.1//EN"
    "changes-v11.mod">
%changes;

<!-- =============================================================== -->
<!-- Document type element -->
<!-- =============================================================== -->

<!ELEMENT module (url, forrest?, cvs, mailing-lists, description,
                  detailed, what, why, who, todo, changes, licence,
                  credits, project+)>
<!ATTLIST module
  name CDATA #REQUIRED>

  <!ELEMENT url EMPTY>
  <!ATTLIST url
    href CDATA #REQUIRED>

  <!ELEMENT forrest (skin)>
  <!ATTLIST forrest
    version CDATA #REQUIRED>

    <!ELEMENT skin EMPTY>
    <!ATTLIST skin
      name CDATA #REQUIRED
      style CDATA #REQUIRED>

  <!ELEMENT cvs EMPTY>
  <!ATTLIST cvs
    repository CDATA #REQUIRED>

  <!ELEMENT mailing-lists (mailing-list+)>

    <!ELEMENT mailing-list EMPTY>
    <!ATTLIST mailing-list
      user CDATA #REQUIRED
      mail CDATA #REQUIRED
      subscribe CDATA #REQUIRED
      unsubscribe CDATA #REQUIRED>

  <!ELEMENT description (%content.mix;)*>

  <!ELEMENT detailed (%blocks;)>

  <!ELEMENT what (goal+)>

    <!ELEMENT goal (%content.mix;)*>

  <!ELEMENT why (%content.mix;)*>

  <!ELEMENT who (person+)>

  <!ELEMENT licence (%content.mix;)*>

  <!ELEMENT credits (credit+)>

    <!ELEMENT credit (%content.mix;)*>

  <!ELEMENT project (url?, description?, version?, package?, ant?,
                     depend*, work*, home, jar+, javadoc?)>
  <!ATTLIST project name CDATA #REQUIRED>

    <!ELEMENT package (#PCDATA)>

    <!ELEMENT ant EMPTY>
    <!ATTLIST ant
      target CDATA #REQUIRED>

    <!ELEMENT depend EMPTY>
    <!ATTLIST depend
      project CDATA #REQUIRED>

    <!ELEMENT work EMPTY>
    <!ATTLIST work
      nested CDATA #REQUIRED>

    <!ELEMENT home EMPTY>
    <!ATTLIST home
      nested CDATA #REQUIRED>

    <!ELEMENT jar EMPTY>
    <!ATTLIST jar
      name CDATA #REQUIRED
      id CDATA #IMPLIED>

    <!ELEMENT javadoc EMPTY>
    <!ATTLIST javadoc
      parent CDATA #REQUIRED>

<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->




-------------------------------------------------------
This SF.net email is sponsored by:Crypto Challenge is now open! 
Get cracking and register here for some mind boggling fun and 
the chance of winning an Apple iPod:
http://ads.sourceforge.net/cgi-bin/redirect.pl?thaw0031en
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.