diff options
Diffstat (limited to 'src/documentation/content/xdocs/dtd')
| -rw-r--r-- | src/documentation/content/xdocs/dtd/changes-v11.mod | 71 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/dtd/changes-v13.dtd | 95 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/dtd/common-charents-v10.mod | 74 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/dtd/common-elems-v10.mod | 68 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/dtd/document-v13.dtd | 145 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/dtd/document-v13.mod | 432 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/dtd/faq-v12.mod | 69 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/dtd/faq-v13.dtd | 86 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/dtd/todo-v11.dtd | 87 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/dtd/todo-v11.mod | 76 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/dtd/todo-v13.dtd | 99 |
11 files changed, 1260 insertions, 42 deletions
diff --git a/src/documentation/content/xdocs/dtd/changes-v11.mod b/src/documentation/content/xdocs/dtd/changes-v11.mod new file mode 100644 index 0000000000..f9cd5cd835 --- /dev/null +++ b/src/documentation/content/xdocs/dtd/changes-v11.mod @@ -0,0 +1,71 @@ +<!-- + Copyright 1999-2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<!-- =================================================================== + + Apache Changes Module (Version 1.1) + +PURPOSE: + This DTD was developed to create a simple yet powerful document + type for software development changes for use with the Apache projects. + It is an XML-compliant DTD and it's maintained by the Apache XML + project. + +TYPICAL INVOCATION: + + <!ENTITY % changes PUBLIC + "-//APACHE//ENTITIES Changes Vxy//EN" + "changes-vxy.mod"> + %changes; + + where + + x := major version + y := minor version + +NOTES: + It is important, expecially in open developped software projects, to keep + track of software changes both to give users indications of bugs that might + have been resolved, as well, and not less important, to provide credits + for the support given to the project. It is considered vital to provide + adequate payback using recognition and credits to let users and developers + feel part of the community, thus increasing development power. + +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) + +==================================================================== --> + +<!-- =============================================================== --> +<!-- Document Type Definition --> +<!-- =============================================================== --> + +<!ELEMENT changes (title?, devs?, release+)> +<!ATTLIST changes %common.att;> + + <!ELEMENT release (action+)> + <!ATTLIST release %common.att; + version CDATA #REQUIRED + date CDATA #REQUIRED> + +<!-- =============================================================== --> +<!-- End of DTD --> +<!-- =============================================================== --> diff --git a/src/documentation/content/xdocs/dtd/changes-v13.dtd b/src/documentation/content/xdocs/dtd/changes-v13.dtd new file mode 100644 index 0000000000..8ffed7b69e --- /dev/null +++ b/src/documentation/content/xdocs/dtd/changes-v13.dtd @@ -0,0 +1,95 @@ +<!-- + Copyright 2002-2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<!-- =================================================================== + + Apache Changes DTD (Version 1.2) + +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. + +FIXME: + +CHANGE HISTORY: +[Version 1.0] + 20020611 Initial version. (SN) + 20020613 Include the module of ISO character entity sets (DC) +[Version 1.2] + 20030424 Adopt the loosened content model from document-v12 (JT) + 20040614 Stay current with latest document-v13 (class attribute) + +==================================================================== --> + +<!-- =============================================================== --> +<!-- Include the Documentation DTD --> +<!-- =============================================================== --> + +<!ENTITY % document PUBLIC + "-//APACHE//ENTITIES Documentation V1.3//EN" + "document-v13.mod"> +%document; + +<!-- =============================================================== --> +<!-- Include the Common ISO Character Entity Sets --> +<!-- =============================================================== --> + +<!ENTITY % common-charents PUBLIC + "-//APACHE//ENTITIES Common Character Entity Sets V1.0//EN" + "common-charents-v10.mod"> +%common-charents; + +<!-- =============================================================== --> +<!-- Include the Common elements --> +<!-- =============================================================== --> + +<!ENTITY % common PUBLIC + "-//APACHE//ENTITIES Common Elements V1.0//EN" + "common-elems-v10.mod"> +%common; + +<!-- =============================================================== --> +<!-- Include the Changes module --> +<!-- =============================================================== --> + +<!ENTITY % changes PUBLIC + "-//APACHE//ENTITIES Changes V1.1//EN" + "changes-v11.mod"> +%changes; + +<!-- =============================================================== --> +<!-- End of DTD --> +<!-- =============================================================== --> diff --git a/src/documentation/content/xdocs/dtd/common-charents-v10.mod b/src/documentation/content/xdocs/dtd/common-charents-v10.mod new file mode 100644 index 0000000000..d495c1daa3 --- /dev/null +++ b/src/documentation/content/xdocs/dtd/common-charents-v10.mod @@ -0,0 +1,74 @@ +<!-- + Copyright 2002-2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<!-- =================================================================== + + 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 + +FIXME: + +CHANGE HISTORY: +[Version 1.0] + 20020613 Initial version. (DC) + +==================================================================== --> + +<!-- =============================================================== --> +<!-- Common ISO character entity sets --> +<!-- =============================================================== --> + +<!ENTITY % ISOlat1 PUBLIC + "ISO 8879:1986//ENTITIES Added Latin 1//EN//XML" + "../entity/ISOlat1.pen"> +%ISOlat1; + +<!ENTITY % ISOpub PUBLIC + "ISO 8879:1986//ENTITIES Publishing//EN//XML" + "../entity/ISOpub.pen"> +%ISOpub; + +<!ENTITY % ISOtech PUBLIC + "ISO 8879:1986//ENTITIES General Technical//EN//XML" + "../entity/ISOtech.pen"> +%ISOtech; + +<!ENTITY % ISOnum PUBLIC + "ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN//XML" + "../entity/ISOnum.pen"> +%ISOnum; + +<!ENTITY % ISOdia PUBLIC + "ISO 8879:1986//ENTITIES Diacritical Marks//EN//XML" + "../entity/ISOdia.pen"> +%ISOdia; + +<!-- =============================================================== --> +<!-- End of DTD --> +<!-- =============================================================== --> diff --git a/src/documentation/content/xdocs/dtd/common-elems-v10.mod b/src/documentation/content/xdocs/dtd/common-elems-v10.mod new file mode 100644 index 0000000000..ba7581cba6 --- /dev/null +++ b/src/documentation/content/xdocs/dtd/common-elems-v10.mod @@ -0,0 +1,68 @@ +<!-- + Copyright 2002-2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<!-- =================================================================== + + Apache Common Elements (Version 1.0) + +PURPOSE: + Common elements across DTDs + +TYPICAL INVOCATION: + + <!ENTITY % common PUBLIC + "-//APACHE//ENTITIES Common elements Vx.y//EN" + "common-elems-vxy.mod"> + %common; + + where + + x := major version + y := minor version + +FIXME: + +CHANGE HISTORY: +[Version 1.0] + 20020611 Initial version. (SN) + +==================================================================== --> + +<!-- =============================================================== --> +<!-- Common entities --> +<!-- =============================================================== --> + +<!ENTITY % types "add|remove|update|fix"> +<!ENTITY % contexts "build|docs|code|admin|design"> + +<!-- =============================================================== --> +<!-- Common elements --> +<!-- =============================================================== --> + +<!ELEMENT devs (person+)> +<!ATTLIST devs %common.att;> + +<!ELEMENT action (%content.mix;)*> +<!ATTLIST action %common.att; + dev IDREF #REQUIRED + type (%types;) #IMPLIED + context (%contexts;) #IMPLIED + due-to CDATA #IMPLIED + due-to-email CDATA #IMPLIED + fixes-bug CDATA #IMPLIED> + +<!-- =============================================================== --> +<!-- End of DTD --> +<!-- =============================================================== --> diff --git a/src/documentation/content/xdocs/dtd/document-v13.dtd b/src/documentation/content/xdocs/dtd/document-v13.dtd new file mode 100644 index 0000000000..801a317f51 --- /dev/null +++ b/src/documentation/content/xdocs/dtd/document-v13.dtd @@ -0,0 +1,145 @@ +<!-- + Copyright 1999-2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<!-- =================================================================== + + 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 <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*"> + +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) + 20040614 The attribute "class" is now defined on every element. (RT) + +==================================================================== --> + + +<!-- =============================================================== --> +<!-- 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.3//EN" + "document-v13.mod"> +%document; + +<!-- =============================================================== --> +<!-- End of DTD --> +<!-- =============================================================== --> diff --git a/src/documentation/content/xdocs/dtd/document-v13.mod b/src/documentation/content/xdocs/dtd/document-v13.mod new file mode 100644 index 0000000000..4c60b803bc --- /dev/null +++ b/src/documentation/content/xdocs/dtd/document-v13.mod @@ -0,0 +1,432 @@ +<!-- + Copyright 2002-2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<!-- =================================================================== + + 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: + +FIXME: + +CHANGE HISTORY: +[Version 1.0] + 20020608 Initial version. (SN) + +==================================================================== --> +<!-- =============================================================== --> +<!-- 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 + class NMTOKEN #IMPLIED + xml:lang NMTOKEN #IMPLIED'> +<!ENTITY % common-idreq.att 'id ID #REQUIRED + class NMTOKEN #IMPLIED + 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 + label CDATA #IMPLIED + %common.att; +> +<!-- Warning Paragraph (normally shown with eye-catching colors) --> +<!ELEMENT warning (%content.mix;)*> +<!ATTLIST warning + label CDATA #IMPLIED + %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 --> +<!-- =============================================================== --> diff --git a/src/documentation/content/xdocs/dtd/faq-v12.mod b/src/documentation/content/xdocs/dtd/faq-v12.mod new file mode 100644 index 0000000000..3065a804d3 --- /dev/null +++ b/src/documentation/content/xdocs/dtd/faq-v12.mod @@ -0,0 +1,69 @@ +<!-- + Copyright 2002-2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<!-- =================================================================== + + Apache Faq module (Version 1.1) + +TYPICAL INVOCATION: + + <!ENTITY % faq PUBLIC + "-//APACHE//ENTITIES FAQ Vxy//EN" + "faq-vxy.mod"> + %faq; + + where + + x := major version + y := minor version + +NOTES: + +FIXME: + +CHANGE HISTORY: +[Version 1.0] + 20020608 Initial version. (SN) +[Version 1.2] + 20030505 Allow mixed content in <answer>, to match <question> (JT) + +==================================================================== --> + +<!-- =============================================================== --> +<!-- Element declarations --> +<!-- =============================================================== --> + +<!ELEMENT faqs (authors?, (faq|part)+)> +<!ATTLIST faqs %common.att; + %title.att;> + + <!ELEMENT part (title, (faq | part)+) > + <!ATTLIST part %common.att;> + + <!ELEMENT faq (question, answer)> + <!ATTLIST faq %common.att;> + + <!ELEMENT question (%content.mix;|elaboration)*> + <!ATTLIST question %common.att;> + + <!ELEMENT elaboration (%content.mix;)*> + <!ATTLIST elaboration %common.att;> + + <!ELEMENT answer (%flow;)*> + <!ATTLIST answer author IDREF #IMPLIED> + +<!-- =============================================================== --> +<!-- End of DTD --> +<!-- =============================================================== --> diff --git a/src/documentation/content/xdocs/dtd/faq-v13.dtd b/src/documentation/content/xdocs/dtd/faq-v13.dtd new file mode 100644 index 0000000000..2588ea8d45 --- /dev/null +++ b/src/documentation/content/xdocs/dtd/faq-v13.dtd @@ -0,0 +1,86 @@ +<!-- + Copyright 1999-2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<!-- =================================================================== + + Apache FAQ DTD (Version 1.2) + +PURPOSE: + This DTD was developed to create a simple yet powerful document + type for software FAQ's for use with the Apache projects. + It is an XML-compliant DTD and it's maintained by the Apache XML + project. + +TYPICAL INVOCATION: + + <!DOCTYPE faqs PUBLIC + "-//APACHE//DTD FAQ Vx.y//EN" + "faq-vxy.dtd"> + + where + + x := major version + y := minor version + +NOTES: + FAQs represent a powerful knowledge base and a very good way of solving + common user problems reducing messages on mail lists and reducing the effort + required for software installation and usage. Thid DTD want to be a common + format for FAQ interchange to allow FAQ-O-Matic-type workgroup services to + be published in other formats as well as enhancing data interchange. + +FIXME: + +CHANGE HISTORY: + 19991129 Initial version. (SM) + 20011212 Used public identifiers for external entities (SM) + 20020418 Added an (optional) 'part' element to create sections in a faq (SN) + 20020613 Include the module of ISO character entity sets (DC) +[Version 1.2] + 20030424 Adopt the loosened content model from document-v12 (JT) + 20040614 Stay current with latest document-v13 (class attribute) + +==================================================================== --> + +<!-- =============================================================== --> +<!-- Include the Documentation DTD --> +<!-- =============================================================== --> + +<!ENTITY % document PUBLIC + "-//APACHE//ENTITIES Documentation V1.3//EN" + "document-v13.mod"> +%document; + +<!-- =============================================================== --> +<!-- Include the Common ISO Character Entity Sets --> +<!-- =============================================================== --> + +<!ENTITY % common-charents PUBLIC + "-//APACHE//ENTITIES Common Character Entity Sets V1.0//EN" + "common-charents-v10.mod"> +%common-charents; + +<!-- =============================================================== --> +<!-- Document Type Definition --> +<!-- =============================================================== --> + +<!ENTITY % faq PUBLIC + "-//APACHE//ENTITIES FAQ V1.1//EN" + "faq-v12.mod"> +%faq; + +<!-- =============================================================== --> +<!-- End of DTD --> +<!-- =============================================================== --> diff --git a/src/documentation/content/xdocs/dtd/todo-v11.dtd b/src/documentation/content/xdocs/dtd/todo-v11.dtd index 3aaaa14dbd..476395d9a2 100644 --- a/src/documentation/content/xdocs/dtd/todo-v11.dtd +++ b/src/documentation/content/xdocs/dtd/todo-v11.dtd @@ -1,25 +1,40 @@ +<!-- + Copyright 1999-2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> <!-- =================================================================== - + 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 + 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 + <!DOCTYPE todo PUBLIC "-//APACHE//DTD Todo Vx.y//EN" "todo-vxy.dtd"> - where - + where + x := major version y := minor version - -NOTES: + +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 @@ -27,9 +42,6 @@ NOTES: 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) @@ -39,15 +51,8 @@ CHANGE HISTORY: 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. - + 20020613 Include the module of ISO character entity sets (DC) + ==================================================================== --> <!-- =============================================================== --> @@ -55,39 +60,37 @@ COPYRIGHT: <!-- =============================================================== --> <!ENTITY % document PUBLIC - "-//APACHE//DTD Documentation V1.1//EN" - "document-v11.dtd"> + "-//APACHE//ENTITIES Documentation V1.1//EN" + "document-v11.mod"> %document; - <!-- =============================================================== --> -<!-- Common entities --> +<!-- Include the Common ISO Character Entity Sets --> <!-- =============================================================== --> -<!ENTITY % priorities "showstopper|high|medium|low|wish|dream"> - -<!ENTITY % contexts "build|docs|code|admin|design"> +<!ENTITY % common-charents PUBLIC + "-//APACHE//ENTITIES Common Character Entity Sets V1.0//EN" + "common-charents-v10.mod"> +%common-charents; <!-- =============================================================== --> -<!-- Document Type Definition --> +<!-- Include the Common elements --> <!-- =============================================================== --> -<!ELEMENT todo (devs, actions*)> -<!ATTLIST todo %common.att; - %title.att;> +<!ENTITY % common PUBLIC + "-//APACHE//ENTITIES Common Elements V1.0//EN" + "common-elems-v10.mod"> +%common; - <!ELEMENT devs (person+)> - <!ATTLIST devs %common.att;> +<!-- =============================================================== --> +<!-- Include the Todo module --> +<!-- =============================================================== --> - <!ELEMENT actions (action+)> - <!ATTLIST actions %common.att; - priority (%priorities;) #IMPLIED> +<!ENTITY % todo PUBLIC + "-//APACHE//ENTITIES Todo V1.1//EN" + "todo-v11.mod"> +%todo; - <!ELEMENT action (%content.mix;)*> - <!ATTLIST action %common.att; - assigned-to IDREF #IMPLIED - context (%contexts;) #REQUIRED> - <!-- =============================================================== --> <!-- End of DTD --> <!-- =============================================================== --> diff --git a/src/documentation/content/xdocs/dtd/todo-v11.mod b/src/documentation/content/xdocs/dtd/todo-v11.mod new file mode 100644 index 0000000000..102fca01f3 --- /dev/null +++ b/src/documentation/content/xdocs/dtd/todo-v11.mod @@ -0,0 +1,76 @@ +<!-- + Copyright 1999-2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<!-- =================================================================== + + Apache Todos module (Version 1.0) + +PURPOSE: + This DTD was developed to create a simple yet powerful document + type for software development todo lists for use with the Apache projects. + It is an XML-compliant DTD and it's maintained by the Apache XML + project. + +TYPICAL INVOCATION: + + <!ENTITY % todo PUBLIC + "-//APACHE//ENTITIES Todo Vxy//EN" + "todo-vxy.mod"> + %todo; + + where + + x := major version + y := minor version + +NOTES: + It is important, expecially in open developped software projects, to keep + track of software changes that need to be done, planned features, development + assignment, etc. in order to allow better work parallelization and create + an entry point for people that want to help. This DTD wants to provide + a solid foundation to provide such information and to allow it to be + published as well as distributed in a common format. + +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) + +==================================================================== --> +<!-- =============================================================== --> +<!-- Common entities --> +<!-- =============================================================== --> +<!ENTITY % priorities "showstopper|high|medium|low|wish|dream"> +<!-- =============================================================== --> +<!-- Document Type Definition --> +<!-- =============================================================== --> +<!ELEMENT todo (title?, devs?, actions+)> +<!ATTLIST todo + %common.att; +> + +<!ELEMENT actions (action+)> +<!ATTLIST actions + %common.att; + priority (%priorities;) #IMPLIED +> +<!-- =============================================================== --> +<!-- End of DTD --> +<!-- =============================================================== --> diff --git a/src/documentation/content/xdocs/dtd/todo-v13.dtd b/src/documentation/content/xdocs/dtd/todo-v13.dtd new file mode 100644 index 0000000000..9c28ec853d --- /dev/null +++ b/src/documentation/content/xdocs/dtd/todo-v13.dtd @@ -0,0 +1,99 @@ +<!-- + Copyright 1999-2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<!-- =================================================================== + + Apache Todos DTD (Version 1.2) + +PURPOSE: + This DTD was developed to create a simple yet powerful document + type for software development todo lists for use with the Apache projects. + It is an XML-compliant DTD and it's maintained by the Apache XML + project. + +TYPICAL INVOCATION: + + <!DOCTYPE todo PUBLIC + "-//APACHE//DTD Todo Vx.y//EN" + "todo-vxy.dtd"> + + where + + x := major version + y := minor version + +NOTES: + It is important, expecially in open developped software projects, to keep + track of software changes that need to be done, planned features, development + assignment, etc. in order to allow better work parallelization and create + an entry point for people that want to help. This DTD wants to provide + a solid foundation to provide such information and to allow it to be + published as well as distributed in a common format. + +FIXME: + - do we need anymore working contexts? (SM) + +CHANGE HISTORY: +[Version 1.0] + 19991129 Initial version. (SM) + 19991225 Added actions element for better structure (SM) +[Version 1.1] + 20011212 Used public identifiers for external entities (SM) + 20020613 Include the module of ISO character entity sets (DC) +[Version 1.2] + 20030424 Adopt the loosened content model from document-v12 (JT) + 20040614 Stay current with latest document-v13 (class attribute) + +==================================================================== --> + +<!-- =============================================================== --> +<!-- Include the Documentation DTD --> +<!-- =============================================================== --> + +<!ENTITY % document PUBLIC + "-//APACHE//ENTITIES Documentation V1.3//EN" + "document-v13.mod"> +%document; + +<!-- =============================================================== --> +<!-- Include the Common ISO Character Entity Sets --> +<!-- =============================================================== --> + +<!ENTITY % common-charents PUBLIC + "-//APACHE//ENTITIES Common Character Entity Sets V1.0//EN" + "common-charents-v10.mod"> +%common-charents; + +<!-- =============================================================== --> +<!-- Include the Common elements --> +<!-- =============================================================== --> + +<!ENTITY % common PUBLIC + "-//APACHE//ENTITIES Common Elements V1.0//EN" + "common-elems-v10.mod"> +%common; + +<!-- =============================================================== --> +<!-- Include the Todo module --> +<!-- =============================================================== --> + +<!ENTITY % todo PUBLIC + "-//APACHE//ENTITIES Todo V1.1//EN" + "todo-v11.mod"> +%todo; + +<!-- =============================================================== --> +<!-- End of DTD --> +<!-- =============================================================== --> |