poi-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From gl...@apache.org
Subject cvs commit: jakarta-poi/src/documentation/xdocs/dtd book-cocoon-v10.dtd changes-v11.dtd document-v11.dtd faq-v11.dtd javadoc-v04draft.dtd specification-v11.dtd todo-v11.dtd
Date Sun, 06 Jul 2003 05:58:45 GMT
glens       2003/07/05 22:58:45

  Added:       src/documentation/content/xdocs/dtd book-cocoon-v10.dtd
                        changes-v11.dtd document-v11.dtd faq-v11.dtd
                        javadoc-v04draft.dtd specification-v11.dtd
                        todo-v11.dtd
  Removed:     src/documentation/xdocs/dtd book-cocoon-v10.dtd
                        changes-v11.dtd document-v11.dtd faq-v11.dtd
                        javadoc-v04draft.dtd specification-v11.dtd
                        todo-v11.dtd
  Log:
  Moved location of DTD files to correct place.
  
  Revision  Changes    Path
  1.1                  jakarta-poi/src/documentation/content/xdocs/dtd/book-cocoon-v10.dtd
  
  Index: 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 <crossley@apache.org>
    
  FIXME:
    - find the proper DTD for book.xml
  
  CHANGE HISTORY:
    20011031 Initial version. (DC)
      
  COPYRIGHT:
    Copyright (c) @year@ 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 -->
  <!-- =============================================================== -->
  
  
  
  1.1                  jakarta-poi/src/documentation/content/xdocs/dtd/changes-v11.dtd
  
  Index: 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 <stefano@apache.org>
  
  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) @year@ 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//DTD Documentation V1.1//EN"
      "document-v11.dtd">
  %document;
  
  <!-- =============================================================== -->
  <!-- Common entities -->
  <!-- =============================================================== -->
  
  <!ENTITY % types "add|remove|update|fix">
  
  <!-- =============================================================== -->
  <!-- Document Type Definition -->
  <!-- =============================================================== -->
  
  <!ELEMENT changes (devs, release*)>
  <!ATTLIST changes %common.att;
                    %title.att;>
  
      <!ELEMENT devs (person+)>
      <!ATTLIST devs %common.att;>
  
      <!ELEMENT release (action+)>
      <!ATTLIST release %common.att;
                        version  CDATA  #REQUIRED
                        date     CDATA  #REQUIRED>
  
          <!ELEMENT action (%content.mix;)*>
          <!ATTLIST action %common.att;
                           dev  IDREF  #REQUIRED
                           type (%types;)  #IMPLIED
                           due-to CDATA #IMPLIED
                           due-to-email CDATA #IMPLIED
                           fixes-bug CDATA #IMPLIED>
  
  <!-- =============================================================== -->
  <!-- End of DTD -->
  <!-- =============================================================== -->
  
  
  
  1.1                  jakarta-poi/src/documentation/content/xdocs/dtd/document-v11.dtd
  
  Index: 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 <elm@arbortext.com>.
  
    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 <stefano@apache.org>
    Steven Noels <stevenn@outerthought.org>
  
  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)
  
  COPYRIGHT:
    Copyright (c) @year@ 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 character entities (included from external file) -->
  <!-- =============================================================== -->
  
  <!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;
  
  <!-- =============================================================== -->
  <!-- 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">
  <!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 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="_new">) -->
      <!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;>
  
  
  <!-- =============================================================== -->
  <!-- Blocks definitions -->
  <!-- =============================================================== -->
  
  <!ENTITY % local.blocks "">
  
  <!ENTITY % blocks "%paragraphs;|%tables;|%lists;|%special-blocks; %local.blocks;">
  
      <!-- ==================================================== -->
      <!-- Paragraphs -->
      <!-- ==================================================== -->
  
      <!-- Text Paragraph (normally vertically space delimited) -->
      <!ELEMENT p (%content.mix;)*>
      <!ATTLIST p %common.att;>
  
      <!-- 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;)>
      <!ATTLIST title %common.att;>
  
      <!ELEMENT subtitle (%text;)>
      <!ATTLIST subtitle %common.att;>
  
      <!ELEMENT version (%text;)>
      <!ATTLIST version %common.att;>
  
      <!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 (%sections;|%blocks;)*>
      <!ATTLIST section %title.att; %common.att;>
  
      <!-- ==================================================== -->
      <!-- Footer -->
      <!-- ==================================================== -->
  
      <!ENTITY % local.footers "">
  
      <!ELEMENT footer (legal %local.footers;)>
  
          <!ELEMENT legal (%content.mix;)*>
          <!ATTLIST legal %common.att;>
  
  <!-- =============================================================== -->
  <!-- End of DTD -->
  <!-- =============================================================== -->
  
  
  
  1.1                  jakarta-poi/src/documentation/content/xdocs/dtd/faq-v11.dtd
  
  Index: 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 document 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 <stefano@apache.org>
    
  FIXME:
  
  CHANGE HISTORY:
    19991129 Initial version. (SM)
    20011212 Used public identifiers for external entities (SM)
      
  COPYRIGHT:
    Copyright (c) @year@ 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//DTD Documentation V1.1//EN"
      "document-v11.dtd">
  %document;
  
  <!-- =============================================================== -->
  <!-- Document Type Definition -->
  <!-- =============================================================== -->
  
  <!ELEMENT faqs (authors?, faq)+>
  <!ATTLIST faqs %common.att; 
                 %title.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 -->
  <!-- =============================================================== -->
  
  
  
  1.1                  jakarta-poi/src/documentation/content/xdocs/dtd/javadoc-v04draft.dtd
  
  Index: 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 <murphyk@umsystem.edu>
    
  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) @year@ 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 -->
  <!-- =============================================================== -->
  
  
  
  1.1                  jakarta-poi/src/documentation/content/xdocs/dtd/specification-v11.dtd
  
  Index: 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 <stefano@apache.org>
    
  FIXME:
  
  CHANGE HISTORY:
  [Version 1.0]
    19991129 Initial version. (SM)
  [Version 1.1]
    20011212 Used public identifiers for external entities (SM)
      
  COPYRIGHT:
    Copyright (c) @year@ 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//DTD Documentation V1.1//EN"
      "document-v11.dtd">
  %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;
                       %title.att;
                       %link.att;
                       authors CDATA #REQUIRED
                       date    CDATA #IMPLIED>
  
  <!-- =============================================================== -->
  <!-- End of DTD -->
  <!-- =============================================================== -->
  
  
  
  1.1                  jakarta-poi/src/documentation/content/xdocs/dtd/todo-v11.dtd
  
  Index: 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 document 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 <stefano@apache.org>
    
  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) @year@ 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//DTD Documentation V1.1//EN"
      "document-v11.dtd">
  %document;
  
  
  <!-- =============================================================== -->
  <!-- Common entities -->
  <!-- =============================================================== -->
  
  <!ENTITY % priorities "showstopper|high|medium|low|wish|dream">
  
  <!ENTITY % contexts "build|docs|code|admin|design">
  
  <!-- =============================================================== -->
  <!-- Document Type Definition -->
  <!-- =============================================================== -->
  
  <!ELEMENT todo (devs, actions*)>
  <!ATTLIST todo %common.att; 
                 %title.att;>
  
      <!ELEMENT devs (person+)>
      <!ATTLIST devs %common.att;>
  
      <!ELEMENT actions (action+)>
      <!ATTLIST actions %common.att;
                       priority     (%priorities;)  #IMPLIED>
  
          <!ELEMENT action (%content.mix;)*>
          <!ATTLIST action %common.att;
                           assigned-to  IDREF           #IMPLIED
                           context      (%contexts;)    #REQUIRED>
      
  <!-- =============================================================== -->
  <!-- End of DTD -->
  <!-- =============================================================== -->
  
  
  

Mime
View raw message