cziegeler    2003/06/25 06:33:25

  Modified:    src/targets docs-build.xml
               src/documentation/xdocs/developing/portal index.xml
  Added:       src/documentation/xdocs/dtd document-v11.dtd
                        document-v12.mod ISOnum.pen ISOtech.pen ISOlat1.pen
                        ISOpub.pen document-v12.dtd common-charents-v10.mod
                        ISOgrk1.pen ISOdia.pen document-v11.mod
  Log:
  Adding document-11 dtds
  Fixing document
  Making "docs" build target use forrest
  Comment out "printer-docs" target (Do we still need this?)
  
  Revision  Changes    Path
  1.1                  cocoon-2.1/src/documentation/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. It has now been superceded by v1.2.
  
  TYPICAL INVOCATION:
  
    <!DOCTYPE document PUBLIC
         "-//APACHE//DTD Documentation V1.1//EN"
         "document-v11.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-2003 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 -->
  <!-- =============================================================== -->
  
  
  
  1.1                  cocoon-2.1/src/documentation/xdocs/dtd/document-v12.mod
  
  Index: document-v12.mod
  ===================================================================
  <!-- ===================================================================
  
       Apache Common Documentation elements (Version 1.2)
  
  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             #REQUIRED
           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 (%content.mix;)*>
  <!ATTLIST strong
    %common.att; 
  >
  <!-- Emphasis (typically italic) -->
  <!ELEMENT em (%content.mix;)*>
  <!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;">
  
  <!-- Flow mixes block and inline -->
  <!ENTITY % flow "%content.mix;|%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 (%flow;)*>
  <!ATTLIST th
    %common.att; 
    %cell.span; 
  >
  <!-- The table row description element -->
  <!ELEMENT td (%flow;)*>
  <!ATTLIST td
    %common.att; 
    %cell.span; 
  >
  <!-- ==================================================== -->
  <!-- Lists -->
  <!-- ==================================================== -->
  <!-- List item -->
  <!ELEMENT li (%flow;)*>
  <!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 (%flow; )*>
  <!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
    align CDATA #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; | %links; | %special-inline;)*>
  <!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 -->
  <!-- =============================================================== -->
  
  
  
  1.1                  cocoon-2.1/src/documentation/xdocs/dtd/ISOnum.pen
  
  Index: ISOnum.pen
  ===================================================================
  <!-- (C) International Organization for Standardization 1986
       Permission to copy in any form is granted for use with
       conforming SGML systems and applications as defined in
       ISO 8879, provided this notice is included in all copies.
  -->
  <!-- Character entity set. Typical invocation:
       <!ENTITY % ISOnum PUBLIC
         "ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN//XML">
       %ISOnum;
  -->
  <!-- This version of the entity set can be used with any SGML document
       which uses ISO 10646 as its document character set. 
       This includes XML documents and ISO HTML documents.
       This entity set uses hexadecimal numeric character references. 
            
       Creator: Rick Jelliffe, Allette Systems
       
       Version: 1997-07-07
  -->
  
  <!ENTITY half   "&#189;" ><!--=fraction one-half-->
  <!ENTITY frac12 "&#189;" ><!--=fraction one-half-->
  <!ENTITY frac14 "&#188;" ><!--=fraction one-quarter-->
  <!ENTITY frac34 "&#190;" ><!--=fraction three-quarters-->
  <!ENTITY frac18 "&#x215B;" > 
      <!-- or "&#xB1;&#x202;&#x2044;&#x2088;" --><!--=fraction one-eighth-->
  <!ENTITY frac38 "&#x215C;" >
      <!-- or "&#xB3;&#x2044;&#x2088;" --><!--=fraction three-eighths-->
  <!ENTITY frac58 "&#x215D;" >
      <!-- or "&#x2075;&#x2044;&#x2088;" --><!--=fraction five-eighths-->
  <!ENTITY frac78 "&#x215E;" >
      <!-- or "&#x2077;&#x2044;&#x2088;" --><!--=fraction seven-eighths-->
  
  <!ENTITY sup1   "&#185;" ><!--=superscript one-->
  <!ENTITY sup2   "&#178;" ><!--=superscript two-->
  <!ENTITY sup3   "&#179;" ><!--=superscript three-->
  
  <!ENTITY plus   "+" ><!--=plus sign B:-->
  <!ENTITY plusmn "&#xB1;" ><!--/pm B: =plus-or-minus sign-->
  <!ENTITY lt     "&#38;#60;"      ><!--=less-than sign R:-->
  <!ENTITY equals "="      ><!--=equals sign R:-->
  <!ENTITY gt     ">"      ><!--=greater-than sign R:-->
  <!ENTITY divide "&#247;" ><!--/div B: =divide sign-->
  <!ENTITY times  "&#215;" ><!--/times B: =multiply sign-->
  
  <!ENTITY curren "&#164;" ><!--=general currency sign-->
  <!ENTITY pound  "&#163;" ><!--=pound sign-->
  <!ENTITY dollar "$"      ><!--=dollar sign-->
  <!ENTITY cent   "&#162;" ><!--=cent sign-->
  <!ENTITY yen    "&#165;" ><!--/yen =yen sign-->
  
  <!ENTITY num    "#" ><!--=number sign-->
  <!ENTITY percnt "&#37;" ><!--=percent sign-->
  <!ENTITY amp    "&#38;#38;" ><!--=ampersand-->
  <!ENTITY ast    "*" ><!--/ast B: =asterisk-->
  <!ENTITY commat "@" ><!--=commercial at-->
  <!ENTITY lsqb   "[" ><!--/lbrack O: =left square bracket-->
  <!ENTITY bsol   "\" ><!--/backslash =reverse solidus-->
  <!ENTITY rsqb   "]" ><!--/rbrack C: =right square bracket-->
  <!ENTITY lcub   "{" ><!--/lbrace O: =left curly bracket-->
  <!ENTITY horbar "&#x2015;" ><!--=horizontal bar-->
  <!ENTITY verbar "|" ><!--/vert =vertical bar-->
  <!ENTITY rcub   "}" ><!--/rbrace C: =right curly bracket-->
  <!ENTITY micro  "&#181;" ><!--=micro sign-->
  <!ENTITY ohm    "&#2126;" ><!--=ohm sign-->
  <!ENTITY deg    "&#176;" ><!--=degree sign-->
  <!ENTITY ordm   "&#186;" ><!--=ordinal indicator, masculine-->
  <!ENTITY ordf   "&#170;" ><!--=ordinal indicator, feminine-->
  <!ENTITY sect   "&#167;" ><!--=section sign-->
  <!ENTITY para   "&#182;" ><!--=pilcrow (paragraph sign)-->
  <!ENTITY middot "&#183;" ><!--/centerdot B: =middle dot-->
  <!ENTITY larr   "&#x2190;" ><!--/leftarrow /gets A: =leftward arrow-->
  <!ENTITY rarr   "&#x2192;" ><!--/rightarrow /to A: =rightward arrow-->
  <!ENTITY uarr   "&#x2191;" ><!--/uparrow A: =upward arrow-->
  <!ENTITY darr   "&#x2193;" ><!--/downarrow A: =downward arrow-->
  <!ENTITY copy   "&#169;" ><!--=copyright sign-->
  <!ENTITY reg    "&#174;" ><!--/circledR =registered sign-->
  <!ENTITY trade  "&#8482;" ><!--=trade mark sign-->
  <!ENTITY brvbar "&#xA6;" ><!--=bren (vertical) bar-->
  <!ENTITY not    "&#xAC;" ><!--/neg /lnot =not sign-->
  <!ENTITY sung   "&#x266A;" ><!--=music note (sung text sign)-->
  
  <!ENTITY excl   "!" ><!--=exclamation mark-->
  <!ENTITY iexcl  "&#xA1;" ><!--=inverted exclamation mark-->
  <!ENTITY quot   '"' ><!--=quotation mark-->
  <!ENTITY apos   "'" ><!--=apostrophe-->
  <!ENTITY lpar   "(" ><!--O: =left parenthesis-->
  <!ENTITY rpar   ")" ><!--C: =right parenthesis-->
  <!ENTITY comma  "," ><!--P: =comma-->
  <!ENTITY lowbar "_" ><!--=low line-->
  <!ENTITY hyphen "&#x2010;" ><!--=hyphen-->
  <!ENTITY period "." ><!--=full stop, period-->
  <!ENTITY sol    "/" ><!--=solidus-->
  <!ENTITY colon  ":" ><!--/colon P:-->
  <!ENTITY semi   ";" ><!--=semicolon P:-->
  <!ENTITY quest  "?" ><!--=question mark-->
  <!ENTITY iquest "&#xBF;" ><!--=inverted question mark-->
  <!ENTITY laquo  "&#x2039;" ><!--=angle quotation mark, left
   But note that Unicode 1 & Maler & el Andaloussi give &#xAB; -->
  <!ENTITY raquo  "&#x203A;" ><!--=angle quotation mark, right
   But note that Unicode 1 & Maler & el Andaloussi give &#xBB; -->
  <!ENTITY lsquo  "&#x2018;" ><!--=single quotation mark, left-->
  <!ENTITY rsquo  "&#x2019;" ><!--=single quotation mark, right-->
  <!ENTITY ldquo  "&#x201C;" ><!--=double quotation mark, left-->
  <!ENTITY rdquo  "&#x201D;" ><!--=double quotation mark, right-->
  <!ENTITY nbsp   "&#160;" ><!--=no break (required) space-->
  <!ENTITY shy    "&#173;" ><!--=soft hyphen-->
  
  
  
  
  
  1.1                  cocoon-2.1/src/documentation/xdocs/dtd/ISOtech.pen
  
  Index: ISOtech.pen
  ===================================================================
  
  <!-- (C) International Organization for Standardization 1986
       Permission to copy in any form is granted for use with
       conforming SGML systems and applications as defined in
       ISO 8879, provided this notice is included in all copies.
  -->
  <!-- Character entity set. Typical invocation:
       <!ENTITY % ISOtech PUBLIC
         "ISO 8879:1986//ENTITIES General Technical//EN//XML" 
         "ISOtech.pen">
       %ISOtech;
  -->
  <!-- This version of the entity set can be used with any SGML document
       which uses ISO 10646 as its document character set. 
       This includes XML documents and ISO HTML documents.
       This entity set uses hexadecimal numeric character references. 
            
       Creator: Rick Jelliffe, Allette Systems
       
       Version: 1997-07-07
  -->
  <!ENTITY aleph  "&#x2135;" ><!--/aleph =aleph, Hebrew-->
  <!ENTITY and    "&#x2227;" ><!--/wedge /land B: =logical and-->
  <!ENTITY ang90  "&#x221F;" ><!--=right (90 degree) angle-->
  <!ENTITY angsph "&#x2222;" ><!--/sphericalangle =angle-spherical-->
  <!ENTITY ap     "&#x2249;" ><!--/approx R: =approximate-->
  <!ENTITY becaus "&#x2235;" ><!--/because R: =because-->
  <!ENTITY bottom "&#x22A5;" ><!--/bot B: =perpendicular-->
  <!ENTITY cap    "&#x2229;" ><!--/cap B: =intersection-->
  <!ENTITY cong   "&#x2245;" ><!--/cong R: =congruent with-->
  <!ENTITY conint "&#x222E;" ><!--/oint L: =contour integral operator-->
  <!ENTITY cup    "&#x222A;" ><!--/cup B: =union or logical sum-->
  <!ENTITY equiv  "&#x2261;" ><!--/equiv R: =identical with-->
  <!ENTITY exist  "&#x2203;" ><!--/exists =at least one exists-->
  <!ENTITY forall "&#x2200;" ><!--/forall =for all-->
  <!ENTITY fnof   "&#x192;" ><!--=function of (italic small f)-->
  <!ENTITY ge     "&#x2265;" ><!--/geq /ge R: =greater-than-or-equal-->
  <!ENTITY iff    "&#x21D4;" ><!--/iff =if and only if-->
  <!ENTITY infin  "&#x221E;" ><!--/infty =infinity-->
  <!ENTITY int    "&#x222B;" ><!--/int L: =integral operator-->
  <!ENTITY isin   "&#x2208;" ><!--/in R: =set membership-->
  <!ENTITY lang   "&#x2329;" ><!--/langle O: =left angle bracket-->
  <!ENTITY lArr   "&#x21D0;" ><!--/Leftarrow A: =is implied by-->
  <!ENTITY le     "&#x2264;" ><!--/leq /le R: =less-than-or-equal-->
  <!ENTITY minus  "-" ><!--B: =minus sign-->
  <!ENTITY mnplus "&#x2213;" ><!--/mp B: =minus-or-plus sign-->
  <!ENTITY nabla  "&#x2207;" ><!--/nabla =del, Hamilton operator-->
  <!ENTITY ne     "&#x2260;" ><!--/ne /neq R: =not equal-->
  <!ENTITY ni     "&#x220B;" ><!--/ni /owns R: =contains-->
  <!ENTITY or     "&#x2228;" ><!--/vee /lor B: =logical or-->
  <!ENTITY par    "&#x2225;" ><!--/parallel R: =parallel-->
  <!ENTITY part   "&#x2202;" ><!--/partial =partial differential-->
  <!ENTITY permil "&#x2030;" ><!--=per thousand-->
  <!ENTITY perp   "&#x22A5;" ><!--/perp R: =perpendicular-->
  <!ENTITY prime  "&#x2032;" ><!--/prime =prime or minute-->
  <!ENTITY Prime  "&#x2033;" ><!--=double prime or second-->
  <!ENTITY prop   "&#x221D;" ><!--/propto R: =is proportional to-->
  <!ENTITY radic  "&#x221A;" ><!--/surd =radical-->
  <!ENTITY rang   "&#x232A;" ><!--/rangle C: =right angle bracket-->
  <!ENTITY rArr   "&#x21D2;" ><!--/Rightarrow A: =implies-->
  <!ENTITY sim    "&#x223C;" ><!--/sim R: =similar-->
  <!ENTITY sime   "&#x2243;" ><!--/simeq R: =similar, equals-->
  <!ENTITY square "&#x25A1;" ><!--/square B: =square-->
  <!ENTITY sub    "&#x2282;" ><!--/subset R: =subset or is implied by-->
  <!ENTITY sube   "&#x2286;" ><!--/subseteq R: =subset, equals-->
  <!ENTITY sup    "&#x2283;" ><!--/supset R: =superset or implies-->
  <!ENTITY supe   "&#x2287;" ><!--/supseteq R: =superset, equals-->
  <!ENTITY there4 "&#x2234;" ><!--/therefore R: =therefore-->
  <!ENTITY Verbar "&#x2016;" ><!--/Vert =dbl vertical bar-->
  
  <!ENTITY angst  "&#x212B;" ><!--Angstrom =capital A, ring-->
  <!ENTITY bernou "&#x212C;" ><!--Bernoulli function (script capital B)-->
  <!ENTITY compfn "&#x2218;" ><!--B: composite function (small circle)-->
  <!ENTITY Dot    "&#xA8;" ><!--=dieresis or umlaut mark-->
  <!ENTITY DotDot "&#x20DC;" ><!--four dots above-->
  <!ENTITY hamilt "&#x210B;" ><!--Hamiltonian (script capital H)-->
  <!ENTITY lagran "&#x2112;" ><!--Lagrangian (script capital L)-->
  <!ENTITY lowast "&#x2217;" ><!--low asterisk-->
  <!ENTITY notin  "&#x2209;" ><!--N: negated set membership-->
  <!ENTITY order  "&#x2134;" ><!--order of (script small o)-->
  <!ENTITY phmmat "&#x2133;" ><!--physics M-matrix (script capital M)-->
  <!ENTITY tdot   "&#x20DB;" ><!--three dots above-->
  <!ENTITY tprime "&#x2034;" ><!--triple prime-->
  <!ENTITY wedgeq "&#x2259;" ><!--R: corresponds to (wedge, equals)-->
  
  
  
  
  1.1                  cocoon-2.1/src/documentation/xdocs/dtd/ISOlat1.pen
  
  Index: ISOlat1.pen
  ===================================================================
  <!-- (C) International Organization for Standardization 1986
       Permission to copy in any form is granted for use with
       conforming SGML systems and applications as defined in
       ISO 8879, provided this notice is included in all copies.
  -->
  <!-- Character entity set. Typical invocation:
       <!ENTITY % ISOlat1 PUBLIC
         "ISO 8879:1986//ENTITIES Added Latin 1//EN//XML">
       %ISOlat1;
  -->
  <!-- This version of the entity set can be used with any SGML document
       which uses ISO 8859-1 or ISO 10646 as its document character 
       set. This includes XML documents and ISO HTML documents. 
  -->
   
      <!ENTITY Agrave  "&#192;" ><!-- capital A, grave accent -->
      <!ENTITY Aacute  "&#193;" ><!-- capital A, acute accent -->
      <!ENTITY Acirc   "&#194;" ><!-- capital A, circumflex accent -->
      <!ENTITY Atilde  "&#195;" ><!-- capital A, tilde -->
      <!ENTITY Auml    "&#196;" ><!-- capital A, dieresis or umlaut mark -->
      <!ENTITY Aring   "&#197;" ><!-- capital A, ring -->
      <!ENTITY AElig   "&#198;" ><!-- capital AE diphthong (ligature) -->
      <!ENTITY Ccedil  "&#199;" ><!-- capital C, cedilla -->
      <!ENTITY Egrave  "&#200;" ><!-- capital E, grave accent -->
      <!ENTITY Eacute  "&#201;" ><!-- capital E, acute accent -->
      <!ENTITY Ecirc   "&#202;" ><!-- capital E, circumflex accent -->
      <!ENTITY Euml    "&#203;" ><!-- capital E, dieresis or umlaut mark -->
      <!ENTITY Igrave  "&#204;" ><!-- capital I, grave accent -->
      <!ENTITY Iacute  "&#205;" ><!-- capital I, acute accent -->
      <!ENTITY Icirc   "&#206;" ><!-- capital I, circumflex accent -->
      <!ENTITY Iuml    "&#207;" ><!-- capital I, dieresis or umlaut mark -->
      <!ENTITY ETH     "&#208;" ><!-- capital Eth, Icelandic -->
      <!ENTITY Ntilde  "&#209;" ><!-- capital N, tilde -->
      <!ENTITY Ograve  "&#210;" ><!-- capital O, grave accent -->
      <!ENTITY Oacute  "&#211;" ><!-- capital O, acute accent -->
      <!ENTITY Ocirc   "&#212;" ><!-- capital O, circumflex accent -->
      <!ENTITY Otilde  "&#213;" ><!-- capital O, tilde -->
      <!ENTITY Ouml    "&#214;" ><!-- capital O, dieresis or umlaut mark -->
      <!ENTITY Oslash  "&#216;" ><!-- capital O, slash -->
      <!ENTITY Ugrave  "&#217;" ><!-- capital U, grave accent -->
      <!ENTITY Uacute  "&#218;" ><!-- capital U, acute accent -->
      <!ENTITY Ucirc   "&#219;" ><!-- capital U, circumflex accent -->
      <!ENTITY Uuml    "&#220;" ><!-- capital U, dieresis or umlaut mark -->
      <!ENTITY Yacute  "&#221;" ><!-- capital Y, acute accent -->
      <!ENTITY THORN   "&#222;" ><!-- capital THORN, Icelandic -->
      <!ENTITY szlig   "&#223;" ><!-- small sharp s, German (sz ligature) -->
      <!ENTITY agrave  "&#224;" ><!-- small a, grave accent -->   
      <!ENTITY aacute  "&#225;" ><!-- small a, acute accent -->
      <!ENTITY acirc   "&#226;" ><!-- small a, circumflex accent -->
      <!ENTITY atilde  "&#227;" ><!-- small a, tilde -->
      <!ENTITY auml    "&#228;" ><!-- small a, dieresis or umlaut mark -->
      <!ENTITY aring   "&#229;" ><!-- small a, ring -->
      <!ENTITY aelig   "&#230;" ><!-- small ae diphthong (ligature) -->
      <!ENTITY ccedil  "&#231;" ><!-- small c, cedilla -->
      <!ENTITY egrave  "&#232;" ><!-- small e, grave accent -->
      <!ENTITY eacute  "&#233;" ><!-- small e, acute accent -->
      <!ENTITY ecirc   "&#234;" ><!-- small e, circumflex accent -->
      <!ENTITY euml    "&#235;" ><!-- small e, dieresis or umlaut mark -->
      <!ENTITY igrave  "&#236;" ><!-- small i, grave accent -->
      <!ENTITY iacute  "&#237;" ><!-- small i, acute accent -->
      <!ENTITY icirc   "&#238;" ><!-- small i, circumflex accent -->
      <!ENTITY iuml    "&#239;" ><!-- small i, dieresis or umlaut mark -->
      <!ENTITY eth     "&#240;" ><!-- small eth, Icelandic -->
      <!ENTITY ntilde  "&#241;" ><!-- small n, tilde -->
      <!ENTITY ograve  "&#242;" ><!-- small o, grave accent -->
      <!ENTITY oacute  "&#243;" ><!-- small o, acute accent -->
      <!ENTITY ocirc   "&#244;" ><!-- small o, circumflex accent -->
      <!ENTITY otilde  "&#245;" ><!-- small o, tilde -->
      <!ENTITY ouml    "&#246;" ><!-- small o, dieresis or umlaut mark -->
  
      <!ENTITY oslash  "&#248;" ><!-- small o, slash -->
      <!ENTITY ugrave  "&#249;" ><!-- small u, grave accent -->
      <!ENTITY uacute  "&#250;" ><!-- small u, acute accent -->
      <!ENTITY ucirc   "&#251;" ><!-- small u, circumflex accent -->
      <!ENTITY uuml    "&#252;" ><!-- small u, dieresis or umlaut mark -->
      <!ENTITY yacute  "&#253;" ><!-- small y, acute accent -->
      <!ENTITY thorn   "&#254;" ><!-- small thorn, Icelandic -->
      <!ENTITY yuml    "&#255;" ><!-- small y, dieresis or umlaut mark -->
  
  
  
  
  1.1                  cocoon-2.1/src/documentation/xdocs/dtd/ISOpub.pen
  
  Index: ISOpub.pen
  ===================================================================
  <!-- (C) International Organization for Standardization 1986
       Permission to copy in any form is granted for use with
       conforming SGML systems and applications as defined in
       ISO 8879, provided this notice is included in all copies.
  -->
  <!-- Character entity set. Typical invocation:
       <!ENTITY % ISOpub PUBLIC
         "ISO 8879:1986//ENTITIES Publishing//EN//XML">
       %ISOpub;
  -->
  <!-- This version of the entity set can be used with any SGML document
       which uses ISO 10646 as its document character set. 
       This includes XML documents and ISO HTML documents.
       This entity set uses hexadecimal numeric character references. 
            
       Creator: Rick Jelliffe, Allette Systems
       
       Version: 1997-07-07
  -->
  <!ENTITY emsp   "&#x2003;" ><!--=em space-->
  <!ENTITY ensp   "&#x2002;" ><!--=en space (1/2-em)-->
  <!ENTITY emsp13 "&#x2004;" ><!--=1/3-em space-->
  <!ENTITY emsp14 "&#x2005;" ><!--=1/4-em space-->
  <!ENTITY numsp  "&#x2007;" ><!--=digit space (width of a number)-->
  <!ENTITY puncsp "&#x2008;" ><!--=punctuation space (width of comma)-->
  <!ENTITY thinsp "&#x2009;" ><!--=thin space (1/6-em)-->
  <!ENTITY hairsp "&#x200A;" ><!--=hair space-->
  <!ENTITY mdash  "&#x2014;" ><!--=em dash-->
  <!ENTITY ndash  "&#x2013;" ><!--=en dash-->
  <!ENTITY dash   "&#x2010;" ><!--=hyphen (true graphic)-->
  <!ENTITY blank  "&#x2423;" ><!--=significant blank symbol-->
  <!ENTITY hellip "&#x2026;" ><!--=ellipsis (horizontal)-->
  <!ENTITY nldr   "&#x2025;" ><!--=double baseline dot (en leader)-->
  <!ENTITY frac13 "&#x2153;" ><!--=fraction one-third-->
  <!ENTITY frac23 "&#x2154;" ><!--=fraction two-thirds-->
  <!ENTITY frac15 "&#x2155;" ><!--=fraction one-fifth-->
  <!ENTITY frac25 "&#x2156;" ><!--=fraction two-fifths-->
  <!ENTITY frac35 "&#x2157;" ><!--=fraction three-fifths-->
  <!ENTITY frac45 "&#x2158;" ><!--=fraction four-fifths-->
  <!ENTITY frac16 "&#x2159;" ><!--=fraction one-sixth-->
  <!ENTITY frac56 "&#x215a;" ><!--=fraction five-sixths-->
  <!ENTITY incare "&#x2105;" ><!--=in-care-of symbol-->
  <!ENTITY block  "&#x2588;" ><!--=full block-->
  <!ENTITY uhblk  "&#x2580;" ><!--=upper half block-->
  <!ENTITY lhblk  "&#x2584;" ><!--=lower half block-->
  <!ENTITY blk14  "&#x2591;" ><!--=25% shaded block-->
  <!ENTITY blk12  "&#x2592;" ><!--=50% shaded block-->
  <!ENTITY blk34  "&#x2593;" ><!--=75% shaded block-->
  <!ENTITY marker "&#x25AE;" ><!--=histogram marker-->
  <!ENTITY cir    "&#x25CB;" ><!--/circ B: =circle, open-->
  <!ENTITY squ    "&#x25A1;" ><!--=square, open-->
  <!ENTITY rect   "&#x25AD;" ><!--=rectangle, open-->
  <!ENTITY utri   "&#x25B5;" ><!--/triangle =up triangle, open-->
  <!ENTITY dtri   "&#x25BF;" ><!--/triangledown =down triangle, open-->
  <!ENTITY star   "&#x2606;" ><!--=star, open-->
  <!ENTITY bull   "&#x2022;" ><!--/bullet B: =round bullet, filled-->
  <!ENTITY squf   "&#x25AA;" ><!--/blacksquare =sq bullet, filled-->
  <!ENTITY utrif  "&#x25B4;" ><!--/blacktriangle =up tri, filled-->
  <!ENTITY dtrif  "&#x25BE;" ><!--/blacktriangledown =dn tri, filled-->
  <!ENTITY ltrif  "&#x25C2;" ><!--/blacktriangleleft R: =l tri, filled-->
  <!ENTITY rtrif  "&#x25B8;" ><!--/blacktriangleright R: =r tri, filled-->
  <!ENTITY clubs  "&#x2663;" ><!--/clubsuit =club suit symbol-->
  <!ENTITY diams  "&#x2662;" ><!--/diamondsuit =diamond suit symbol-->
  <!ENTITY hearts "&#x2661;" ><!--/heartsuit =heart suit symbol-->
  <!ENTITY spades "&#x2660;" ><!--/spadesuit =spades suit symbol-->
  <!ENTITY malt   "&#x2720;" ><!--/maltese =maltese cross-->
  <!ENTITY dagger "&#x2020;" ><!--/dagger B: =dagger-->
  <!ENTITY Dagger "&#x2021;" ><!--/ddagger B: =double dagger-->
  <!ENTITY check  "&#x2713;" ><!--/checkmark =tick, check mark-->
  <!ENTITY cross  "&#x2717;" ><!--=ballot cross-->
  <!ENTITY sharp  "&#x266F;" ><!--/sharp =musical sharp-->
  <!ENTITY flat   "&#x266D;" ><!--/flat =musical flat-->
  <!ENTITY male   "&#x2642;" ><!--=male symbol-->
  <!ENTITY female "&#x2640;" ><!--=female symbol-->
  <!ENTITY phone  "&#x26E0;" ><!--=telephone symbol-->
  <!ENTITY telrec "&#x2315;" ><!--=telephone recorder symbol-->
  <!ENTITY copysr "&#x2117;" ><!--=sound recording copyright sign-->
  <!ENTITY caret  "&#x2041;" ><!--=caret (insertion mark)-->
  <!ENTITY lsquor "&#x201A;" ><!--=rising single quote, left (low)-->
  <!ENTITY ldquor "&#x201E;" ><!--=rising dbl quote, left (low)-->
  
  <!ENTITY fflig  "&#xFB00;" ><!--small ff ligature-->
  <!ENTITY filig  "&#xFB01;" ><!--small fi ligature-->
  <!ENTITY fjlig  "fj" ><!--small fj ligature-->
  <!ENTITY ffilig "&#xFB03;" ><!--small ffi ligature-->
  <!ENTITY ffllig "&#xFB04;" ><!--small ffl ligature-->
  <!ENTITY fllig  "&#xFB02;" ><!--small fl ligature-->
  
  <!ENTITY mldr   "&#x2025;" ><!--em leader-->
  <!ENTITY rdquor "&#x201D;" ><!--rising dbl quote, right (high)-->
  <!ENTITY rsquor "&#x2019;" ><!--rising single quote, right (high)-->
  <!ENTITY vellip "&#x22EE;" ><!--vertical ellipsis-->
  
  <!ENTITY hybull "&#x2043;" ><!--rectangle, filled (hyphen bullet)-->
  <!ENTITY loz    "&#x2727;" ><!--/lozenge - lozenge or total mark-->
  <!ENTITY lozf   "&#x2726;" ><!--/blacklozenge - lozenge, filled-->
  <!ENTITY ltri   "&#x25C3;" ><!--/triangleleft B: l triangle, open-->
  <!ENTITY rtri   "&#x25B9;" ><!--/triangleright B: r triangle, open-->
  <!ENTITY starf  "&#x2605;" ><!--/bigstar - star, filled-->
  
  <!ENTITY natur  "&#x266E;" ><!--/natural - music natural-->
  <!ENTITY rx     "&#x211E;" ><!--pharmaceutical prescription (Rx)-->
  <!ENTITY sext   "&#x2736;" ><!--sextile (6-pointed star)-->
  
  <!ENTITY target "&#x2316;" ><!--register mark or target-->
  <!ENTITY dlcrop "&#x230D;" ><!--downward left crop mark -->
  <!ENTITY drcrop "&#x230C;" ><!--downward right crop mark -->
  <!ENTITY ulcrop "&#x230F;" ><!--upward left crop mark -->
  <!ENTITY urcrop "&#x230E;" ><!--upward right crop mark -->
  
  
  
  
  1.1                  cocoon-2.1/src/documentation/xdocs/dtd/document-v12.dtd
  
  Index: document-v12.dtd
  ===================================================================
  <!-- ===================================================================
  
       Apache Documentation DTD (Version 1.2)
  
  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)
  [Version 1.2]
    20030320 Make @href required for link elements. (SNS)
    20030320 Allow links (link|jump|fork) and inline elements (br|img|icon|acronym) 
inside title. (SNS)
    20030419 Allow inline content 
(strong|em|code|sub|sup|br|img|icon|acronym|link|jump|fork) in strong and em. (JT)
    20030419 Allow paragraphs (p|source|note|warning|fixme), table and figure|anchor 
inside li. (JT)
    20030419 Allow paragraphs (p|source|note|warning|fixme), lists (ol|ul|dl), table, 
figure|anchor inside dd. (JT)
    20030419 Allow paragraphs (p|source|note|warning|fixme), lists (ol|ul|dl), table, 
figure|anchor inside tables (td|dh). (JT)
  
  
  COPYRIGHT:
    Copyright (c) 2002,2003 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.2//EN"
      "document-v12.mod">
  %document;
  
  <!-- =============================================================== -->
  <!-- End of DTD -->
  <!-- =============================================================== -->
  
  
  
  1.1                  cocoon-2.1/src/documentation/xdocs/dtd/common-charents-v10.mod
  
  Index: 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 -->
  <!-- =============================================================== -->
  
  
  
  1.1                  cocoon-2.1/src/documentation/xdocs/dtd/ISOgrk1.pen
  
  Index: ISOgrk1.pen
  ===================================================================
  <!-- (C) International Organization for Standardization 1986
       Permission to copy in any form is granted for use with
       conforming SGML systems and applications as defined in
       ISO 8879, provided this notice is included in all copies.
  
      Creator: version from ISO 8879:1986
      
      Version: 0.21 1992-12-04
  -->
  <!-- Character entity set. Typical invocation:
       <!ENTITY % ISOGRK1 PUBLIC
         "ISO 9573-15:1993//ENTITIES Greek Letters//EN//XML">
       %ISOGRK1;
  -->
  <!-- This version of the entity set can be used with any SGML document
       which uses ISO 10646 as its document character set. 
       This includes XML documents and ISO HTML documents.
       
       Creator: Rick Jelliffe, from HTMLlat1
       
       Version: 1997-07-07
  -->
  
  <!ENTITY agr     "&#945;" ><!--small alpha, Greek, U03B1 -->
  <!ENTITY Agr     "&#913;" ><!--capital Alpha, Greek, U0391 -->
  <!ENTITY bgr     "&#946;" ><!--small beta, Greek, U03B2 -->
  <!ENTITY Bgr     "&#914;" ><!--capital Beta, Greek, U0392 -->
  <!ENTITY ggr     "&#947;" ><!--small gamma, Greek, U03B3 -->
  <!ENTITY Ggr     "&#915;" ><!--capital Gamma, Greek, U0393 -->
  <!ENTITY dgr     "&#948;" ><!--small delta, Greek, U03B4 -->
  <!ENTITY Dgr     "&#916;" ><!--capital Delta, Greek, U0394 -->
  <!ENTITY egr     "&#949;" ><!--small epsilon, Greek, U03B5 -->
  <!ENTITY Egr     "&#917;" ><!--capital Epsilon, Greek, U0395 -->
  <!ENTITY zgr     "&#950;" ><!--small zeta, Greek, U03B6 -->
  <!ENTITY Zgr     "&#918;" ><!--capital Zeta, Greek, U0396 -->
  <!ENTITY eegr    "&#951;" ><!--small eta, Greek, U03B7 -->
  <!ENTITY EEgr    "&#919;" ><!--capital Eta, Greek, U0397 -->
  <!ENTITY thgr    "&#952;" ><!--small theta, Greek, U03B8 -->
  <!ENTITY THgr    "&#920;" ><!--capital Theta, Greek, U0398 -->
  <!ENTITY igr     "&#953;" ><!--small iota, Greek, U03B9 -->
  <!ENTITY Igr     "&#921;" ><!--capital Iota, Greek, U0399 -->
  <!ENTITY kgr     "&#954;" ><!--small kappa, Greek, U03BA -->
  <!ENTITY Kgr     "&#922;" ><!--capital Kappa, Greek, U039A -->
  <!ENTITY lgr     "&#955;" ><!--small lambda, Greek, U03BB -->
  <!ENTITY Lgr     "&#923;" ><!--capital Lambda, Greek, U039B -->
  <!ENTITY mgr     "&#956;" ><!--small mu, Greek, U03BC -->
  <!ENTITY Mgr     "&#924;" ><!--capital Mu, Greek, U039C -->
  <!ENTITY ngr     "&#957;" ><!--small nu, Greek, U03BD -->
  <!ENTITY Ngr     "&#925;" ><!--capital Nu, Greek, U039D -->
  <!ENTITY xgr     "&#958;" ><!--small xi, Greek, U03BE -->
  <!ENTITY Xgr     "&#926;" ><!--capital Xi, Greek, U039E -->
  <!ENTITY ogr     "&#959;" ><!--small omicron, Greek, U03BF -->
  <!ENTITY Ogr     "&#927;" ><!--capital Omicron, Greek, U039F -->
  <!ENTITY pgr     "&#960;" ><!--small pi, Greek, U03C0 -->
  <!ENTITY Pgr     "&#928;" ><!--capital Pi, Greek, U03A0 -->
  <!ENTITY rgr     "&#961;" ><!--small rho, Greek, U03C1 -->
  <!ENTITY Rgr     "&#929;" ><!--capital Rho, Greek, U03A1 -->
  <!ENTITY sfgr    "&#962;" ><!--final small sigma, Greek, U03C2 --> 
  <!ENTITY sgr     "&#963;" ><!--small sigma, Greek, U03C3 -->
  <!ENTITY Sgr     "&#931;" ><!--capital Sigma, Greek, U03A3 -->
  <!ENTITY tgr     "&#964;" ><!--small tau, Greek, U03C4 -->
  <!ENTITY Tgr     "&#932;" ><!--capital Tau, Greek, U03A4 -->
  <!ENTITY ugr     "&#965;" ><!--small upsilon, Greek, U03C5 -->
  <!ENTITY Ugr     "&#933;" ><!--capital Upsilon, Greek, U03A5 -->
  <!ENTITY phgr    "&#966;" ><!--small phi, Greek, U03C6 -->
  <!ENTITY PHgr    "&#934;" ><!--capital Phi, Greek, U03A6 -->
  <!ENTITY khgr    "&#967;" ><!--small chi, Greek, U03C7 -->
  <!ENTITY KHgr    "&#935;" ><!--capital Chi, Greek, U03A7 -->
  <!ENTITY psgr    "&#968;" ><!--small psi, Greek, U03C8 -->
  <!ENTITY PSgr    "&#936;" ><!--capital Psi, Greek, U03A8 -->
  <!ENTITY ohgr    "&#969;" ><!--small omega, Greek, U03C9 -->
  <!ENTITY OHgr    "&#937;" ><!--capital Omega, Greek, U03A9 -->
   
  
  
  
  
  1.1                  cocoon-2.1/src/documentation/xdocs/dtd/ISOdia.pen
  
  Index: ISOdia.pen
  ===================================================================
  <!-- (C) International Organization for Standardization 1986
       Permission to copy in any form is granted for use with
       conforming SGML systems and applications as defined in
       ISO 8879, provided this notice is included in all copies.
  -->
  <!-- Character entity set. Typical invocation:
       <!ENTITY % ISOdia PUBLIC
         "ISO 8879:1986//ENTITIES Diacritical Marks//EN//XML">
       %ISOdia;
  -->
  <!-- This version of the entity set can be used with any SGML document
       which uses ISO 10646 as its document character set. 
       This includes XML documents and ISO HTML documents.
       This entity set uses hexadecimal numeric character references. 
            
       Creator: Rick Jelliffe, Allette Systems
       
       Version: 1997-07-07
  -->
  
  <!ENTITY acute  "&#180;" ><!--=acute accent-->
  <!ENTITY breve  "&#x2D8;" ><!--=breve-->
  <!ENTITY caron  "&#x2C7;" ><!--=caron-->
  <!ENTITY cedil  "&#184;" ><!--=cedilla-->
  <!ENTITY circ   "^" ><!--=circumflex accent-->
  <!ENTITY dblac  "&#x2DD;" ><!--=double acute accent-->
  <!ENTITY die    "&#168;" ><!--=dieresis-->
  <!ENTITY dot    "&#x2D9;" ><!--=dot above-->
  <!ENTITY grave  "`" ><!--=grave accent-->
  <!ENTITY macr   "&#175;" ><!--=macron-->
  <!ENTITY ogon   "&#x2DB;" ><!--=ogonek-->
  <!ENTITY ring   "&#x2DA;" ><!--=ring-->
  <!ENTITY tilde  "&#x2DC;" ><!--=tilde-->
  <!ENTITY uml    "&#168;" ><!--=umlaut mark-->
  
  
  
  1.1                  cocoon-2.1/src/documentation/xdocs/dtd/document-v11.mod
  
  Index: 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.
    It has now been superceded by v1.2.
  
  TYPICAL INVOCATION:
  
    <!ENTITY % document PUBLIC
        "-//APACHE//ENTITIES Documentation V1.1//EN"
        "document-v11.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 -->
  <!-- =============================================================== -->
  
  
  
  1.14      +20 -17    cocoon-2.1/src/targets/docs-build.xml
  
  Index: docs-build.xml
  ===================================================================
  RCS file: /home/cvs/cocoon-2.1/src/targets/docs-build.xml,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- docs-build.xml    18 May 2003 17:03:06 -0000      1.13
  +++ docs-build.xml    25 Jun 2003 13:33:24 -0000      1.14
  @@ -68,52 +68,55 @@
     </target>
   
     <!-- Create docs -->
  -  <target name="docs" depends="prepare-docs, validate-xdocs, docs_done" 
unless="docs.notrequired" description="Builds the documentation">
  +  <target name="docs" depends="prepare-docs, validate-xdocs, docs_done, forrest" 
unless="docs.notrequired" description="Builds the documentation">
  +    <!-- The docs are created using forrest, so we simply copy them for now -->
       <mkdir dir="${build.docs}"/>
   
  -    <java classname="org.apache.cocoon.Main" fork="true" dir="${build.context}" 
failonerror="true" maxmemory="128m">
  -      <arg value="-u${build.docs.loglevel}"/>
  -      <arg value="-x../../../cli.xconf"/>
  -      <arg value="index.html"/>
  -      <classpath>
  -        <path refid="documentation.classpath"/>
  -      </classpath>
  -    </java>
  +    <copy todir="${build.docs}" filtering="off">
  +      <fileset dir="${build.site}"/>
  +    </copy>
  +    <copy todir="${build.docs}/apidocs" filtering="off">
  +      <fileset dir="${build.javadocs}"/>
  +    </copy>
     </target>
   
     <!-- Prepares the printer-docs -->
  +<!--
     <target name="prepare-printer-docs" depends="prepare-docs">
       <mkdir dir="${build.context.printer}"/>
  -
  +-->
       <!-- copy prepared docs -->
  +<!--
       <copy todir="${build.context.printer}" filtering="off">
         <fileset dir="${build.context}"/>
       </copy>
  -
  +-->
       <!-- copy printer skin -->
  +<!--
       <copy todir="${build.context.printer}/stylesheets" filtering="off" 
overwrite="yes">
         <fileset dir="${build.context}/stylesheets/printer_skin"/>
       </copy>
     </target>
  -
  +-->
     <!-- Set a variable if the generated printer docs are already up-to-date. -->
  +<!--
     <target name="printer-docs_check" depends="prepare">
       <uptodate property="printer-docs.notrequired" 
targetfile="${build.docs.printer}/index.html" >
         <srcfiles dir="." includes="status.xml"/>
         <srcfiles dir="${docs}" includes="**/*.xml"/>
       </uptodate>
     </target>
  -
  +-->
     <!-- If generated printer docs are already up-to-date, print a message saying so. 
-->
  +<!--
     <target name="printer-docs_done" depends="printer-docs_check" 
if="printer-docs.notrequired">
  -    <echo message="-------------------------------------------------------------"/>
       <echo message="Not rebuilding printer docs, as they are up-to-date:"/>
       <echo message="  ${build.docs.printer}/index.html is more recent than"/>
       <echo message="  status.xml, ${docs}/*.xml"/>
  -    <echo message="-------------------------------------------------------------"/>
     </target>
  -
  +-->
     <!-- Create printer friendly docs -->
  +<!--
     <target name="printer-docs" depends="prepare-printer-docs, validate-xdocs, 
printer-docs_done" description="Builds printer-friendly documentation">
       <mkdir dir="${build.docs.printer}"/>
   
  @@ -131,7 +134,7 @@
         </classpath>
       </java>
     </target>
  -
  +-->
   <!-- === Javadoc/IDLDoc Targets ================================================ -->
   
     <!-- Create IDL API documentation -->
  
  
  
  1.3       +3 -3      cocoon-2.1/src/documentation/xdocs/developing/portal/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/cocoon-2.1/src/documentation/xdocs/developing/portal/index.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- index.xml 25 Jun 2003 13:10:15 -0000      1.2
  +++ index.xml 25 Jun 2003 13:33:25 -0000      1.3
  @@ -1,4 +1,5 @@
   <?xml version="1.0"?>
  +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" 
"../../dtd/document-v11.dtd">
   <document> 
     <header> 
       <title>Configuring the Cocoon Portal</title> 
  @@ -55,14 +56,13 @@
                a <code>global-variable</code> specifying the path to the skin 
folder.</note>
                <p>The basic cocoon portal skin is a nice and simple example how to 
visualize a portal. 
                There are several elements that allow to customize the look and feel 
of the portal.
  -             A portal with the basic skin consists of 
  +             A portal with the basic skin consists of </p>
                <ul>
                        <li>a <em>header</em></li>
                        <li>a <em>tab row</em></li>
                        <li>a <em>content section</em> containing the coplet 
windows</li>
                        <li>and a <em>footer </em></li>
                </ul>
  -             </p>
                <figure alt="Parts of the portal" height="300" 
src="/images/portal-parts.gif" width="400"></figure>     
                <p>The tab row is actually a part of the content section. As well, a 
tab row can
                be provided to any coplet window.</p>
  @@ -70,6 +70,7 @@
                        <title>The skin&apos;s stylesheets</title>
                        <p>If we take a look at the <code>skins/basic/styles</code> 
directory, we 
                        find a number of stylesheets:
  +                     </p>
                        <ul>
                                <li><code>portal-page.xsl</code>: Creates final HTML 
page</li>
                                <li><code>tab.xsl</code>: layout of the tab row.</li>
  @@ -78,7 +79,6 @@
                                <li><code>row.xsl</code>: layout of a row</li>
                                <li><code>login-page.xsl</code>: layout of the login 
page</li>
                        </ul>
  -                     </p>
                        <p>The <code>window.xsl</code> stylesheet determines the 
layout of a
                        coplet window. Normally, a coplet window will contain a header 
row with a
                        title and buttons like minimize, close, etc.</p>
  
  
  

Reply via email to