Customizer's Guide for 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. Building Variant DTDs Based on DocBook
Setting Up DocBook for Customization
Reusing Individual DocBook Modules
Customization Specifics
Customizing Classes and Mixtures
Customizing Content Model Fragments
Customizing Attribute Lists and Attributes
Removing, Replacing, and Renaming Elements
Redeclaring Entities That Reference Other Entities
Sample Customization
List of Examples
1-1. Template for Customizing Around the Original Driver File
1-2. Template for Customizing Around the Individual Modules
1-3. Template for Customizing in an Internal DOCTYPE Subset
1-4. Main Customization Layer for Sample DocBook Variant
1-5. rdbpool.mod Redeclaration Module for Sample DocBook Variant