Overview of the DocBook DTD

Eve Maler

ArborText, Inc.

Terry Allen

Fujitsu Software Corporation

Permission to use, copy, modify and distribute the DocBook DTD and its accompanying documentation for any purpose and without fee is hereby granted in perpetutity, provided that the above copyright notice and this paragraph appear in all copies.

The copyright holders make no representation about the suitability of this DTD for any purpose. It is provided "as is" without expressed or implied warranty. If you modify the DocBook DTD in any way, except for declaring and referencing additional general entities and declaring additional notations, identify your DTD as a variant of DocBook.

Please direct all questions, bug reports, or suggestions for changes to the davenport@online.ora.com mailing list or to one of the maintainers:

Terry Allen
Fujitsu Software Corporation
3055 Orchard Drive
San Jose, CA 95134
tallen@fsc.fujitsu.com

Eve Maler
ArborText, Inc.
105 Lexington St.
Burlington, MA 01803
elm@arbortext.com

See http://www.ora.com/davenport/ or ftp://ftp.ora.com/pub/davenport/ for more information.


Table of Contents
Preface
Obtaining DocBook from the Davenport Archive
Using and Modifying This Guide
Sending Comments
Acknowledgments
1. DocBook Introduction and Background
Purpose and Scope
Revision and Maintenance Policy
2. Understanding, Using, and Maintaining DocBook
Quick Start
Interchanging DocBook Documents
Using New Releases of DocBook
Using DocBook with Specific Tools
DTD Validation Warnings
ADEPT•Editor and Document•Architect
Normalizing Documents with nsgmls
RulesBuilder
DocBook Architecture
DocBook Entities
Patterns of Entity Naming and Usage
Previous and Current Parameter Entities
Marked Section Entities
Class (xxx.class) Entities
Mixture (xxx.mix) Entities
Content Model Fragment (xxx.content) Entities
Attribute (xxx.attrib) Entities
3. DocBook Changes Made and Planned
Changes Made from V2.1 to V2.2.1
Changes Made in V2.3
Changes Made in V2.4 and V2.4.1
Changes Planned for V3.0
Changes Planned for V4.0 to Date
List of Tables
2-1. Parameter Entity Equivalences
2-2. Class Entities and Contents
2-3. Object-Level (xxx.mix) Mixture Entities and Contents
2-4. Inline-Level (xxx.char.mix) Mixture Entities and Contents
2-5. Content Model Fragment Entities, Contexts, and Contents
2-6. Attribute Entities
List of Figures
2-1. DocBook Modules and Files
2-2. Entity Referencing Structure
List of Examples
2-1. Parameter Entity Synopsis