]> granicus.if.org Git - docbook-dsssl/commitdiff
DocBook V1.2.1
authorNorman Walsh <ndw@nwalsh.com>
Tue, 19 Sep 2000 19:24:13 +0000 (19:24 +0000)
committerNorman Walsh <ndw@nwalsh.com>
Tue, 19 Sep 2000 19:24:13 +0000 (19:24 +0000)
docbook/sgml/ORAents.v3m [new file with mode: 0644]
docbook/sgml/README
docbook/sgml/docbook1.2.1.doc.sgml [new file with mode: 0644]
docbook/sgml/docbook1.2.1.dtd [new file with mode: 0644]
docbook/sgml/sgml.declaration
docbook/sgml/xlsc.sgm

diff --git a/docbook/sgml/ORAents.v3m b/docbook/sgml/ORAents.v3m
new file mode 100644 (file)
index 0000000..0e5b09a
--- /dev/null
@@ -0,0 +1,33 @@
+<!-- ORA entity set for v 3 motif  -->
+
+<!ENTITY amtfA    "<CITESECT>Appendix A, Managing Your Environment</CITESECT>" >
+<!ENTITY amtfB    "<CITESECT>Appendix B, Release 5 Standard Fonts</CITESECT>" >
+<!ENTITY amtfC    "<CITESECT>Appendix C, Standard Bitmaps</CITESECT>" >
+<!ENTITY amtfD    "<CITESECT>Appendix D, Standard Cursors</CITESECT>" >
+<!ENTITY amtfE    "<CITESECT>Appendix E, xterm Control Sequences</CITESECT>" >
+<!ENTITY amtfF    "<CITESECT>Appendix F, Translation Table Syntax</CITESECT>" >
+<!ENTITY amtfG    "<CITESECT>Appendix G, Widget Resources</CITESECT>" >
+<!ENTITY amtfH    "<CITESECT>Appendix H, Obtaining Example Programs</CITESECT>" >
+<!ENTITY bmtf00    "<CITEBOOK>Volume Zero, X Protocol Reference Manual</CITEBOOK>" >
+<!ENTITY bmtf01    "<CITEBOOK>Volume One, Xlib Programming Manual</CITEBOOK>" >
+<!ENTITY bmtf02    "<CITEBOOK>Volume Two, Xlib Reference Manual</CITEBOOK>" >
+<!ENTITY bmtf04    "<CITEBOOK>Volume Four, X Toolkit Intrinsics Programming Manual</CITEBOOK>" >
+<!ENTITY bmtf05    "<CITEBOOK>Volume Five, X Toolkit Intrinsics Reference Manual</CITEBOOK>" >
+<!ENTITY bmtf06    "<CITEBOOK>Volume Six, Motif Programming Manual</CITEBOOK>" >
+<!ENTITY bmtf08    "<CITEBOOK>Volume Eight, X Window System Administrator's Guide</CITEBOOK>" >
+<!ENTITY cmtf0   "<CITESECT>Preface</CITESECT>" >
+<!ENTITY cmtf01  "<CITESECT>Chapter 1, An Introduction to the X Window System</CITESECT>" >
+<!ENTITY cmtf02  "<CITESECT>Chapter 2, Getting Started</CITESECT>" >
+<!ENTITY cmtf03  "<CITESECT>Chapter 3, Working in the X Environment</CITESECT>" >
+<!ENTITY cmtf04  "<CITESECT>Chapter 4, More about the mwm Window Manage</CITESECT>" >
+<!ENTITY cmtf05  "<CITESECT>Chapter 5, The xterm Terminal Emulator</CITESECT>" >
+<!ENTITY cmtf06  "<CITESECT>Chapter 6, Font Specification</CITESECT>" >
+<!ENTITY cmtf07  "<CITESECT>Chapter 7, Graphics Utilities</CITESECT>" >
+<!ENTITY cmtf08  "<CITESECT>Chapter 8, Other Clients</CITESECT>" >
+<!ENTITY cmtf09  "<CITESECT>Chapter 9, Working with Motif Applications</CITESECT>" >
+<!ENTITY cmtf10  "<CITESECT>Chapter 10, Command-line Options</CITESECT>" >
+<!ENTITY cmtf11  "<CITESECT>Chapter 11, Setting Resources</CITESECT>" >
+<!ENTITY cmtf12  "<CITESECT>Chapter 12, Specifying Color</CITESECT>" >
+<!ENTITY cmtf13  "<CITESECT>Chapter 13, Customizing mwm</CITESECT>" >
+<!ENTITY cmtf14  "<CITESECT>Chapter 14, Setup Clients</CITESECT>" >
+
index 524325c5890c1b74f76e2c33d454cfc512670c9e..5ef0e7d238c0bde93a2e4ef469f6b5c85ef4be9c 100644 (file)
@@ -2,26 +2,62 @@ README
 
 This directory contains several versions of the DocBook DTD,
 their documentation, an SGML declaration, and some sample files.  
-As of 2 March 1993 two versions of this DTD are available, 1.0 
-(for historical reference) and 1.2 (the current version).  
+As of 13 March 1993 two versions of this DTD are available, 1.0 
+(for historical reference) and 1.2.1 (the current version).  
 The documentation for DTD version 1.0 is out of date, 
 but may still be useful, especially for RefEntries (man pages).  
 
-As of 2 March 1993 the documentation for the DTD version 1.2 consists of 
-an alphabetical list of elements, with definitions.  This list
-is available in both PostScript and SGML formats.
+As of 13 March 1993 the documentation for the DTD version 1.2.1 
+consists of an alphabetical list of elements, with definitions.  
+This list is available in both PostScript and SGML formats.
 Additional documentation will be forthcoming.  
 
-DocBook 1.2 is an expanded and revised version of 1.0, including 
+DocBook 1.2 was an expanded and revised version of 1.0, including 
 many in-line elements, some specific, some general and inclusive.  
 Valid documents may of course be constructed with a subset of
 these in-line elements---don't feel you must use them all.
 
+DocBook 1.2.1 merely fixes some errors and omissions in 1.2 (see
+the list below).
+
 The DTD does not establish detailed rules for the usage of 
 elements.  This is a matter for editors and writers to deal with.
 
 Please note that the DTD has an associated SGML declaration,
 also to be found in this directory.
 
-To get all of the files relevant to version 1.2, obtain the file
-named docbook1.2.shar.
+To get all of the files relevant to version 1.2.1, obtain the files
+named docbook1.2.1.shar, docbook.ps.Z, and docbook1.2.1.doc.ps.Z.
+
+
+***  CHANGES in 1.2.1
+
+The version number in the public identifier for the DTD was corrected
+       and incremented (was 1.1.1, should have been 1.2, now is 1.2.1).
+
+Semicolons missing from some parameter entities have been supplied.
+
+BookAcronym, Holder, Revision, RevNumber, RevRemark, AuthorInitials, 
+       Year, Firstname, and Surname have been removed from 
+       docinfo.content.gp, as they may occur only within other 
+       elements already in this parameter entity.
+
+OtherAuthor should have been OtherName, and now is.  OtherName is an
+       alternative to Firstname and (or) Surname in Author or Editor.
+
+The HasRefentry attribute has been removed from the Primary, Secondary,
+       etc. index elements.
+
+FORMAL has been set to YES in the SGML declaration.
+
+Several errors in the file docbook1.2.doc.sgml have been corrected,
+       and an external entity file has been provided for it (ORAents.v3m).
+
+Part has been allowed in Book, where it had been omitted by mistake.
+       Suggestions for improving the Book model are invited (the addition
+       of a Body element has been suggested).  Particularly interesting
+       would be examples of real books that can't be represented 
+       in this model.
+
+The DOCTYPE line has been deleted from the sample man page.
+
diff --git a/docbook/sgml/docbook1.2.1.doc.sgml b/docbook/sgml/docbook1.2.1.doc.sgml
new file mode 100644 (file)
index 0000000..766255b
--- /dev/null
@@ -0,0 +1,1094 @@
+<DOCBOOK>
+<CHAPTER>
+<TITLE>DocBook DTD 1.2:  The Elements Alphabetized</TITLE>
+<ITEMIZEDLIST>
+<LISTITEM><PARA>Abstract is a summary of a document's content.  It 
+contains Paras and may bear a Title.  Abstract
+has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Acronym is a pseudoword made up of the initials or
+initial parts of a conventional series of words.  For
+purposes of the DocBook DTD Acronym may also be a string
+of initials.  Acronym contains plain text and
+has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Action is a function to be invoked in response to a user event.
+It contains plain text and has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Anchor marks a target for a Link, and may appear almost anywhere.
+Anchor has no content, and no end tag.
+Anchor has common and Pagenum attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Appendix may contain anything
+found in a Chapter.  
+It may have a DocInfo and
+must have a Title and may have a TitleAbbrev.
+Appendix has common and  Number attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Application is the name of a software program that does something
+useful.  Application may contain
+plain text and
+has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Author is part of DocInfo and consists of
+one or more optional Firstnames and an optional Surname element.
+Author also occurs in BiblioEntry.  It has 
+common attributes.
+<LITERALLAYOUT>
+&lt;AUTHOR&gt;&lt;FIRSTNAME&gt;Marmaduke Anthony&lt;&sol;FIRSTNAME&gt;
+&lt;SURNAME&gt;Pickthall&lt;&sol;SURNAME&gt;&lt;&sol;AUTHOR&gt;
+</LITERALLAYOUT>
+</PARA></LISTITEM>
+<LISTITEM><PARA>AuthorBlurb is a short description of a document's
+author.  It 
+contains Paras and may bear a Title.  AuthorBlurb
+has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>AuthorInitials indicate the author of
+a Revision or Comment.  
+AuthorInitials contains plain text and
+has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>BiblioEntry is an entry in a Bibliography.  For
+flexibility, it may contain a TitleAbbrev, must
+contain at least one of Author, CorpAuthor, 
+Editor, or Title, may
+have any or all of 
+Subtitle, Date, and Publisher,
+and following all of that, plain text.  BiblioEntry
+has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Bibliography may be a book 
+component on its own, or it may appear within a Preface, Chapter, 
+or Appendix.  It may have a DocInfo,
+a Title and a TitleAbbrev, may have one or more introductory Paras,
+and contains BiblioEntries.  No provision
+has been made for bibliographies that are divided into sections.
+Bibliography has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>BlockQuote is a quotation set off from the main text,
+rather than occurring in-line.  It  may be titled, and 
+may contain anything found in a Sect except another 
+Sect---that
+is, it may contain Paras, lists, and so forth.  BlockQuote has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Book is <EMPHASIS>NOT THE SAME AS DOCBOOK.</EMPHASIS>
+A Book is loosely
+defined as having a required DocInfo, then an optional ToC,
+any number of LoTs, any number of Prefaces, one or more Chapters, 
+the following:  Appnedix, Bibliography, and
+then, in order, any number of References, Appendixes,
+Glossaries, Bibliographies, and Indexes.
+Book has common and Number
+attributes (you can supply the number of a Book through
+this attribute or as the content of the VolumeNumber
+element in DocInfo).  
+</PARA></LISTITEM>
+<LISTITEM><PARA>BookAcronym is an optional part of BookTitle, part of
+DocInfo, and
+may be used alongside or in preference to TitleAbbrev.
+BookAcronym contains plain text and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>BookTitle is part of DocInfo, and contains, in order,
+a mandatory Title and optional Subtitle, TitleAbbrev, ReleaseInfo, 
+and Book Acronym.  BookTitle may also appear as the first element
+of DocBook.  BookTitle has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Button is a button in a graphical user interface.  It 
+contains plain text and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Caution is an admonition set off from the text and supplied
+with a title, which is ``Caution'' unless another Title is
+supplied explicitly.  The contents of a Caution 
+may include Paras, lists, and so forth.
+Caution has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Chapter may contain anything except 
+higher-level elements
+such as  Part, Book, and Set.  It may have a DocInfo,
+must have a Title, and may have a TitleAbbrev.
+Chapter has common and Number attributes. 
+</PARA></LISTITEM>
+<LISTITEM><PARA>Character is a character, that is, an element of a writing
+system.  Characters may belong to Charsets, and in some contexts
+one may speak of fonts as representing characters.  But <EMPHASIS>cf.</EMPHASIS>
+Glyph, Font.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Charset is a conventionally defined 
+set of characters, (not a font).  Charset
+contains plain text and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Citation is any in-line bibliographic
+reference to another published work that uses a reference
+string, such as an abbreviation in a Bibliography.
+Citation may contain plain text only, and has 
+common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>CiteBook is the name of another book (or journal)
+cited in the text.  CiteBook may contain in-line elements,
+and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>CiteChap is a reference to a specific chapter 
+(or other component) of any
+book cited in the text, including the book in which 
+the CiteChap appears.  CiteChap may contain in-line elements,
+and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>CiteRefEntry is a reference to a RefEntry
+in any
+book cited in the text, including the book in which 
+the CiteRefEntry
+appears.  CiteRefEntry may contain in-line elements,
+and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>CiteSect is a reference to a specific section of another
+document cited in the text, including the document in which
+the CiteSect appears. CiteSect may contain in-line elements,
+and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Classname is the name of the class to which a 
+program component belongs.  
+Classname contains plain text and has common 
+and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Command is the name of an executable program, or
+the entry a user makes to execute a command.
+Command may contain 
+plain text, FunctionParam, VarParam, Anchor, Optional,
+and Option,
+and has common and HasRefEntry 
+attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Comment is a remark made within the document file that
+is intended for use during interim stages of production.  A
+finished piece of computer documentation intended for an 
+end user would have no visible Comments.  Comment may 
+appear almost anywhere, and may contain almost anything
+below the Section level;
+it has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>ComputerOutput is data presented to the user by a
+computer.  It may contain plain text and Anchors,
+and has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Constant is a fixed value. Constant contains plain text and
+has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Copyright is part of DocInfo and consists of one or
+more Years and any number of Holders.  Copyright has common
+attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>CorpAuthor is the corporate author of a book, for use 
+in DocInfo or BiblioEntry.  It has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>CorpName is the name of a corporation.  It contains
+plain text and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Date appears in DocInfo, BiblioEntry, and Revision, and 
+contains plain text.  It has common attributes.  No provision
+has been made for representing eras; you could include this
+information along with the date data.
+</PARA></LISTITEM>
+<LISTITEM><PARA>DbField is the name of a field in a database.  
+DBField contains plain text and 
+has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>DbName is the name of a database or database file.  
+DbName contains plain text and 
+has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>DbRecord is the name of a record in a database.  
+DbRecord contains plain text and 
+has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>DbTable is the name of a database table.  DbTable contains plain text and 
+has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>DocBook is the base document element for this DTD.
+It is only a wrapper and has no semantic value.
+</PARA></LISTITEM>
+<LISTITEM><PARA>DocInfo is a book component, containing one or more of the
+following:  Author, AuthorInitials, BookAcronym,
+BookTitle, Copyright, CorpAuthor, CorpName, Date, 
+Editor, Edition, InvPartNumber, ISBN, LegalNotice,
+OrgName, PrintHistory, ProductName, ProductNumber,
+Publisher, PubsNumber, RevHistory, Series, 
+and VolumeNumber.  No order is enforced among these
+elements, but you are urged to begin with BookTitle and Author(s).
+DocInfo has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Edition is the edition of a document.  It contains
+plain text and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Editor is like Author, an element of DocInfo and 
+BiblioEntry.  It consists of
+one or more optional Firstnames and an optional Surname element.
+It has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Emphasis is provided for use where one would traditionally employ italics
+(more rarely, bold) to emphasize a word or phrase.  Emphasis 
+may contain only plain text; it has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Epigraph is to be used for a brief section of poetry or prose
+at the start of a chapter.  It contains Paras, and has and 
+common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Equation is a mathematical equation set off on a line
+by itself, or occurring in-line.  An Equation has an optional
+Title and TitleAbbrev, and contains a Graphic, <EMPHASIS>q.v.</EMPHASIS>
+Equation has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Error is an error reported by a computer.  Error
+contains plain text and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>EventStructure is the code that defines an Event.
+EventStructure contains plain text and has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>EventType is a classification of an event.
+EventType
+contains plain text and has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Example is intended for sections of program source code
+that are provided as examples in the text.  
+A Example has an optional Title,
+optional TitleAbbrev, and one or more Screens, LiteralLayouts, or
+ProgramListings, in any combination.  Example has common
+attributes and bears the 
+``linespecific'' Notation attribute. 
+</PARA></LISTITEM>
+<LISTITEM><PARA>ExternalLink is like Link, <EMPHASIS>q.v.,</EMPHASIS> except that its
+Linkend and Endlink attributes are not defined as 
+SGML IDREFs; this is so you can make reference to 
+external documents without
+incurring parsing errors.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Figure is an illustration.  A Figure must have a Title, and may have a
+TitleAbbrev; it may then contain
+one or more of the following: 
+BlockQuote,  Comment, Equation, Example, 
+FigureFileRef, Graphic, IndexTerm,
+LiteralLayout, ProgramListing, Screen, Synopsis,
+and Table.  
+It has an ID attribute, and also 
+Height, Width, Align, and Float attributes.   To
+reference an external file containing graphical
+content use the Graphic element.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Filename is the name of a file, including pathname if this
+information is present.  Filename may contain 
+plain text, FunctionParam, VarParam, and Anchor, 
+and has common and HasRefEntry attributes.  
+</PARA></LISTITEM>
+<LISTITEM><PARA>Firstname is part of Author and Editor, <EMPHASIS>q.q.v.</EMPHASIS>  It contains
+plain text and has common attributes. 
+</PARA></LISTITEM>
+<LISTITEM><PARA>FirstTerm is to be used for the first occurrence 
+of a word in a given context, when
+the style of the document is such that these first occurrences are
+differentiated in some manner.  A FirstTerm may contain
+plain text only, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Footnote is the text of a footnote.    
+The point in the text where the mark for a specific 
+footnote goes is indicated by FootnoteRef; the text of
+the Footnote may appear somewhere else in the file.
+A Footnote may contain all of the 
+permissible contents of Paras.
+Footnote has common and Number attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Font is a collection of Glyphs, <EMPHASIS>q.v.</EMPHASIS>  Font 
+contains plain text and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>FootnoteRef indentifies the location for a footnote mark.
+It may contain plain text, which is the mark to be displayed,
+or it may be empty.  It has ID, Linkend, and Mark
+attributes:  the Linkend attribute has as its value the ID of
+the associated Footnote, and the Mark attribute provides
+another way of indicating the contents of the mark (such as an asterisk, *).
+</PARA></LISTITEM>
+<LISTITEM><PARA>ForeignPhrase is any word or words
+from a language other than
+that of the document which it is desired to mark off
+in some way.  In English, <FOREIGNPHRASE>inter alia</FOREIGNPHRASE> and
+<FOREIGNPHRASE>c'est la vie</FOREIGNPHRASE> are ForeignPhrases.
+ForeignPhrase contains plain text and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Function is a subroutine in a program or external
+library.   Function may contain 
+plain text, FunctionParam, VarParam, and Anchor, and
+has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>FunctionParam identifies an argument for a Function.
+It may contain plain text, Subscript, and Superscript,
+and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Glossary may occur within a Chapter, Appendix, or Preface,
+or may be a book component in its own right.
+It contains an optional DocInfo,
+optional Title and TitleAbbrev, may contain
+any number of Paras, and then consists of GlossaryEntries.
+No provision has been made for Glossaries divided into sections.
+Glossary has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>GlossaryDef is the definition attached to a GlossaryTerm
+in a GlossaryEntry, which occurs in a Glossary.  It may
+contain in-line elements, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>GlossaryEntry is an entry in a Glossary, containing
+a GlossaryTerm and GlossaryDef.  Please note that GlossaryEntry occurs 
+in a Glossary, not in the text of (<EMPHASIS>e.g.</EMPHASIS>) a Chapter
+(although a Glossary may be included within a 
+Chapter).  GlossaryEntry
+has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>GlossaryTerm is an in-line element for tagging terms in the 
+text of a Chapter (for example) that are glossed in a Glossary,
+and also for tagging those terms in GlossaryEntries, in the
+Glossary itself.  As you may not want to tag all occurrences
+of these words outside of Glossaries, you might consider 
+GlossaryTerm, when used outside of Glossaries, to be similar
+to FirstTerm, except that GlossaryTerm may contain other 
+in-line
+elements.  GlossaryTerm has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Glyph is a mark, a component of a font.  A character
+or ligature might be made up of one, two, or more Glyphs.
+Glyph contains plain text and has common attributes.
+<EMPHASIS>Cf.</EMPHASIS> Character.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Graphic may occur within a Figure, Table, Screen, 
+Paragraph, or Equation, to enclose graphical data or to 
+point to an external file containing the contents of one of these
+elements.  Graphic contains CDATA (data in which 
+SGML entities and tags, other than the Graphic end tag, are not
+recognized by the SGML parser) and has format,
+Fileref, Entityref, and ID attributes.
+The format attribute may have the value of 
+GIF, TIFF, CGM, DVI, EPS, TEX, TBL, EQN, DITROFF, or PS. 
+If it is desired to point to an external file, a filename may 
+be supplied as the value of the Fileref attribute, or an
+external entity may be supplied as the value of the 
+Entityref attribute.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Hardware is any name for a physical part of a computer system.  It
+may contain plain text, FunctionParam, VarParam, and Anchor, 
+and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Highlights is a list of main points that are discussed
+a book component such as a Chapter.  It may contain 
+Paras and lists, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Holder is part of Copyright and is the name of the
+holder of the copyright of the document.  It may contain 
+plain text only, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Honorific is a person's title, to be used as part of Author
+or Editor.  It has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>HWapplic describes the hardware to which 
+given context (such as a RefEntry) is relevant.  RefClass is
+a good place to put HWapplic information.  HWapplic
+contains plain text and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Icon is the name of an icon or image
+presented on a computer screen.  
+Icon contains plaint text and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Important 
+is an admonition set off from the text and supplied
+with a title, which is ``Important'' unless another Title is
+supplied explicitly.  The contents of an Important 
+may include Paras, lists, and so forth.
+Important has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Index may occur within a Chapter, Appendix, or
+Preface, or may be a book
+component on its own.
+It contains an optional DocInfo, Title, and TitleAbbrev, may contain
+any number of Paras, and then consists of IndexEntries.
+No provision has been made for Indices divided into sections.  Index has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>IndexAs may be nested within the IndexTerm components
+Primary, Secondary, and Tertiary to indicate an 
+alternate string by which the indexed term (the other 
+content of Primary, Secondary, or Tertiary) should be
+indexed in the Index.  You might want to use this element
+if you tag IndexTerms in the body of the text, rather
+than as separate elements.   IndexAs contains in-line
+elements, and has common attributes. 
+</PARA></LISTITEM>
+<LISTITEM><PARA>IndexEntry is a part of Index, and contains a
+PrimaryIE, which may be accompanied by SecondaryIE,
+TertiaryIE, SeeIE, and SeeAlsoIE.  It has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>IndexTerm is a word or phrase to be indexed.  
+IndexTerm appears in the text, not in the Index; you 
+can apply IndexTerm
+to words in the flow of text or include 
+IndexTerms as separate elements.
+Primary, Secondary, and Tertiary 
+index items are nested within this tag, as are See and
+SeeAlso items.  IndexTerm has common, Span, and PageNum
+ attributes.
+The Span attribute, which may have the value
+Start or End, may be used for showing a span
+of text to be indexed.  
+The PageNum attribute may be used to
+indicate the page on which the indexed term is found in print.  
+</PARA></LISTITEM>
+<LISTITEM><PARA>Interface is the name of any part of a graphical user
+interface,
+such as a button, icon, menu, menu selection, or window; a more
+specific element may be used instead.  Interface 
+plain text, FunctionParam, VarParam, and 
+Anchor, and has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>InterfaceDefinition is a specification for a graphical user
+interface.  It contains plain text and
+has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>InvPartNumber is an inventory part number, which
+may occur in DocInfo.  It contains plain text and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>ISBN is part of DocInfo, and should be used for the International
+Standard Book Number of the document if it has one.  (You could use
+it for an ISSN, also.)  ISBN contains plain text only, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>ItemizedList is a list in which each item is marked with
+a bullet, dash, or other dingbat (or no mark at all).  It 
+consists of one or more ListItems.  A ListItem in an
+ItemizedList contains Paras and other objects, which
+may in turn contain other lists; an ItemizedList may be 
+nested within other lists, too.  ItemizedList
+has common attributes and
+a Mark attribute.  Your application might supply the mark to be used
+for an ItemizedList, but you can use this attribute to 
+indicate the mark you desire to be used (such as
+&bull;); for no mark at all, use the attribute but give it
+no value.
+ItemizedList may be nested within Task, so as to provide a 
+Title and introductory matter.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Keycap is the text printed on a physical key on a 
+computer keyboard, not necessarily the same thing as a
+Keycode.  Keycap contains plain text and has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Keycode is the computer's numeric designation of a key on
+a computer keyboard.  Keycode contains plain text and has common and HasRefEntry 
+attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Keysym is a key symbol name, which is not necessarily the same thing
+as a Keycap.  The Keysym for the H key (Keycap H) is h, for
+example.  Keysym contains plain text and has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>LegalNotice is part of DocInfo, for
+acknowledgement of trademarks and so forth.  It consists of
+Paras and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>LineAnnotation is a writer's or editor's comment on
+a line of program code within an Example, ProgramListing,
+or Screen.  The code's own comments are not 
+LineAnnotations.  LineAnnotation contains plain text
+and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Link is a hypertext link.  It may contain in-line elements
+and has Endterm, Linkend, and Type attributes.  The required
+Linkend attribute specifies the target of the link, 
+and the optional Endterm attribute specifies 
+text that is to be fetched from elsewhere in the document
+to appear in the Link. You can also supply this text directly as
+the content of the Link. 
+The use of the optional Type attribute is undefined, allowing
+you to create local link types.
+</PARA></LISTITEM>
+<LISTITEM><PARA>ListItem is a wrapper for the elements of
+item in an ItemizedList or OrderedList; it also
+occurs within VarListEntry in VariableList.
+It may contain just about anything except Sects and book 
+components.
+ListItem has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Literal is any literal string, used in-line, that is part of
+data in a computer.  This may be as precise as
+the value of an argument, but Literal may also be used
+as a catch-all element.  Literal may contain plain text
+and Anchor; it is not meant as a wrapper for in-line
+elements.  Literal
+has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>LiteralLayout is the wrapper for lines set off from
+the main text that are not tagged as Screens, Examples,
+or ProgramListing, in which line breaks and leading
+white space are to be regarded as significant.
+LiteralLayout 
+contains in-line elements; it has common attributes
+and the ``linespecific'' Notation attribute.
+</PARA></LISTITEM>
+<LISTITEM><PARA>LoT is the generic tag for such things as a List
+of Figures or List of Tables.  An LoT may occur within a Chapter, 
+or Appendix, or may be a book 
+component on its own.
+It contains an optional DocInfo, Title, and TitleAbbrev, 
+followed by multiple LoTentries.  LoT has 
+common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>LoTentry is an element of LoT, and contains
+the text of the thing to be listed,
+including, if desired, in-line elements.  LoTentry has 
+common and PageNum attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Macro is the name of a computer macro.  It contains plain 
+text and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>ManVolNum, which is specific to UNIX man pages,
+ designates the section of a complete set of
+reference pages that a reference page belongs to.  It appears
+within RefMeta, contains plain text, and has common
+attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Mask specifies which values in a specified structure should
+be read when updating resource values.  Mask contains plain text 
+and has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Menu is part of a graphical user interface, containing
+choices of actions for the user.  Menu contains
+plain text and has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>MenuItem is a choice in a menu.  MenuItem contains
+plain text and has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Note is a message to the user, set off from the text and supplied
+with a title, which is ``Note'' unless another Title is
+supplied explicitly.  The contents of a Note
+may include Paras, lists, and so forth.
+Note has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Option is a option to a Command (in the Command ``ls -l''
+``-l'' is an Option), but is not nested within Command.  It may
+contain plain text, FunctionParam, VarParam, and Anchor, and
+has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Optional is for use in Synopsis, as in a
+RefEntry, where optional parameters 
+conventionally are shown in square
+brackets.  Optional should replace those brackets; it may contain
+any element listed in the parameter 
+entity computerterms.gp, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>OrderedList is a numbered or lettered list, consisting of
+ListItems.  A ListItem in an
+OrderedList contains Paras and other objects, which
+may in turn contain other lists; an OrderedList may be 
+nested within
+other lists, too.    
+OrderedList has common attributes, along with 
+a Numeration attribute, which
+may have the value Arabic, Upperalpha, Loweralpha,
+Upperroman, or Lowerroman.  The default is Arabic.  
+ OrderedList
+also has an InheritNum attribute, specifying that for a
+nested list the numbering of ListItems should include the 
+number of the item within which they are nested (2a, 2b, etc.,
+rather than a, b, etc.).  Orderedlist also has
+a Continuation attribute, with values Yes or No,
+which may be used to
+indicate whether the numbering of a list begins afresh (No)
+or continues that of the immediately preceding list (Yes).  The
+default is No, so you need supply the Continuation attribute only
+if your list continues the numbering of the preceding list.
+</PARA></LISTITEM>
+<LISTITEM><PARA>OrgName is the name of an organization that is not
+a corporation (<EMPHASIS>cf.</EMPHASIS> CorpName), for use in DocInfo.  
+It contains plain text
+and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>OSname is the name of an operating system.
+It contains plain text
+and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>OtherName is provided as an alternative to Firstname
+and Surname in Author and Editor.  It has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Para is a paragraph.  It may have a Title, by means of which
+authors may evade the Sect hierarchy, as with a ``bridgehead.'' 
+Para may contain any in-line element, any list, Graphic, Equation,
+Synopsis, Table, BlockQuote, ProgramListing, LiteralLayout,
+Screen, and Figure.  Abstract, AuthorBlurb, Caution, Important, Note, and
+Warning are excluded, as are Sects and higher-level elements.
+Para has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Part may be used to compose a Book.  It
+contains a Title, an optional TitleAbbrev, an optional PartIntro, 
+followed by two or more Chapters or Appendices.
+Part has common and Number attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>PartIntro is a part of Part, and may also appear in 
+Reference.  In Part, it should introduce the 
+contents of the Part.  It may contain just about anything except 
+Sects.  PartIntro has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Preface is a book component, just like a Chapter,
+<EMPHASIS>q.v.</EMPHASIS>  Use the Title element to provide the word ``Preface''
+or other string as desired.  Preface has common attributes.  
+</PARA></LISTITEM>
+<LISTITEM><PARA>Primary is a word or phrase occurring in 
+the text that is to
+appear in the index under as a primary entry.  It must be
+nested within IndexTerm tags.  Primary may contain in-line elements and IndexAs, <EMPHASIS>q.v.</EMPHASIS> Primary.  Primary has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>PrimaryIE is a primary entry in an Index, not in the 
+text.  It may contain only plain text, and has common
+attributes and a Linkends attribute, which has the
+value of some list of element IDs.  
+</PARA></LISTITEM>
+<LISTITEM><PARA>PrintHistory is part of DocInfo, <EMPHASIS>q.v.</EMPHASIS>  It contains Paras
+and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>ProductName is a formal name for any product, part
+of DocInfo.  It contains plain text and has common
+attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>ProductNumber is a number assigned to a product,
+part of DocInfo.  It contains plain text and has common
+attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>ProgramListing contains a listing of a program, including
+LineAnnotations.  
+Line breaks and leading 
+white space are significant in a ProgramListing.  Programlisting
+may contain in-line elements, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Prompt is a prompt appearing on a computer screen, 
+such as the percent sign (%), 
+including any other text appearing there (marmaduke%).
+Prompt may contain only plain text and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Property is the name of a defined set of data
+associated with a window.  Property may contain 
+in-line elements, and has common attributes. 
+</PARA></LISTITEM>
+<LISTITEM><PARA>ProtocolRequest is a message sent from a program to the
+server. ProtocolRequest contains plain text and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>PubsNumber is a number assigned to a publication
+other than ISBN, for use
+in DocInfo.  <EMPHASIS>Cf.</EMPHASIS> also InvPartNumber.  PubsNumber
+contains plain text and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Publisher is an element of DocInfo and BiblioEntry.  It may contain
+plain text only, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Quote is supplied for in-line quotations.  For block quotes 
+use BlockQuote.  Quote may contain in-line elements and has 
+common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>RefClass is an element of RefNameDiv, in which the 
+applicability or scope of the topic of a RefEntry may be
+indicated (such as the element SWapplic or 
+a string such as ``LocalBlocking'').  It may contain
+in-line elements and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>RefDescriptor is a substitute for RefName to be used when a
+RefEntry covers more than one topic and none of the topic name
+is to be used as the sort name.  RefDescriptor contains plain
+text and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>RefEntry is a reference page.  RefEntry
+has common attributes.  For more on RefEntries see 
+version 1.0 of the <CITEBOOK>Guide to the DocBook DTD.</CITEBOOK>
+</PARA></LISTITEM>
+<LISTITEM><PARA>Reference is a collection of RefEntries.  It may
+be a book
+component on its own, 
+or it may appear within a Preface, Chapter, or Appendix.
+Reference has an optional DocInfo,
+a required Title, 
+an optional TitleAbbrev, an optional PartIntro, and 
+one or more RefEntries.  
+Reference has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>RefFileName is the primary name given to the reference page for
+sorting and indexing.  It may be the same as the first of
+the RefNames, or it may be the same as the 
+RefDescriptor.
+RefFileName may contain only plain text, and has common 
+attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>RefMeta is the first major division of a reference page,
+in which metainformation about the reference page is supplied.
+RefMeta is optional, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>RefMiscInfo marks information in RefMeta that may be
+supplied by vendors, such as copyright, release date, revision
+date, print status, operating system, hardware architecture, 
+or a descriptive phrase for use in a print header.   It
+may contain only plain text, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>RefName is the name of the subject or subjects of a
+reference page, and appears within RefNameDiv.  It
+may contain plain text and in-line elements, 
+and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>RefNameDiv is the second major division of a reference page,
+in which the name (RefName) or names of the subject or subjects of the
+reference page are given, along with a RefPurpose.
+RefNameDiv has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>RefPurpose is a short phrase describing the subject of
+the reference page.  It follows the RefNames in
+the RefNameDiv division.  It may contain in-line elements, 
+and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>RefSect1 is equivalent to a Sect1 in the DocBook DTD.
+It contains a Title, followed by any of the allowable contents
+of a Sect, except that only one level of subsection
+is allowed, called RefSect2.  RefSect1 has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>RefSect2 is equivalent to a Sect2 in the DocBook DTD, and may
+occur within RefSect1 or RefSynopsisDiv.  It may contain any of the 
+allowable contents of a Sect, except that no further subsections
+are allowed.  RefSect2 has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>RefSynopsisDiv is the third major division of a reference page,
+in which the syntax of the subject of the reference page is
+indicated.  It contains a Synopsis, and may have
+subdivisions, which must be RefSect2s, not RefSect1s (that is,
+RefSynopsisDiv counts as a RefSect1).
+RefSynopsisDiv has common attributes and a Name 
+attribute, which may be either Synopsis or Syntax;
+the default is Synopsis.
+</PARA></LISTITEM>
+<LISTITEM><PARA>ReleaseInfo is an element of DocInfo, in which
+information about a particular version of a document may
+occur.  It may contain only plain text, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Resource is a configurable setting available to a program
+that controls its behavior or appearance.
+Resource
+may contain plain text only, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>ReturnValue is a value returned by a function.
+ReturnValue may contain plain text only, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>RevHistory is a section of DocInfo
+consisting of Revisions.  It has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Revision is an entry in RevHistory, describing some
+revision made to the text.  A Revision has a mandatory
+Revisionnumber and Date, one or more sets of AuthorInitials, and a 
+Revisionremark.  It has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>RevNumber is an element of Revision, <EMPHASIS>q.v.</EMPHASIS>  
+It may contain only plain text, and has common
+attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>RevRemark is an element 
+of Revision, describing the Revision.
+It may contain only plain text, and has common
+attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Screen is intended to represent what the user sees or
+might see on a computer screen.
+A Screen may
+consist of in-line elements (in which line breaks 
+and leading white space are considered
+significant) or a ScreenInfo and a Graphic.  Screen has common attributes and the Notation attribute
+``linespecific.''
+</PARA></LISTITEM>
+<LISTITEM><PARA>ScreenInfo is a part of Screen, <EMPHASIS>q.v.</EMPHASIS>  A ScreenInfo 
+indicates how the Graphic with which it is paired was created
+as a guide for future revisions.  It may contain only plain
+text, and has common
+attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Secondary is a word or phrase in the text that is to
+appear in the index beneath a Primary entry.  It must be
+nested within IndexTerm tags and must follow a Primary element.
+Secondary may contain in-line elements
+and IndexAs, and has common and 
+HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>SecondaryIE is part of IndexEntry, like PrimaryIE, <EMPHASIS>q.v.</EMPHASIS>
+</PARA></LISTITEM>
+<LISTITEM><PARA>Sect1 marks a section of a document that
+begins with a first-level heading.  Anything may occur
+within a Sect1 except a DocInfo, Preface,
+Chapter, Appendix, or
+another Sect1, including a Glossary, Bibliography, RefEntry, Reference, Toc, Index,
+or LoT. Sect1 must have a Title, which is the text
+of the heading itself, it may have a TitleAbbrev, and must
+include some content other than in-line elements and
+plain text; these must occur in Paras or other
+objects.  Sect1--5 have common
+and Number attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Sect2  is a section beginning with a second-level
+heading, and must be nested within a Sect1.  
+Allowable and required content
+for Sect2s are like those for Sect1s.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Sect3. <EMPHASIS>Cf.</EMPHASIS> Sect2.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Sect4. <EMPHASIS>Cf.</EMPHASIS> Sect2.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Sect5. <EMPHASIS>Cf.</EMPHASIS> Sect2.  No further subdivisions are
+supplied in the DocBook DTD.
+</PARA></LISTITEM>
+<LISTITEM><PARA>See is part of IndexTerm, indicating, for
+a word or phrase in the text, the index entry to
+which the reader is to be directed when he consults
+the stub index entry for another element within
+the IndexTerm.
+See must be nested within IndexTerm tags and must
+follow a Primary or Secondary element.  
+See may contain in-line
+elements and has common and HasRefEntry attributes..
+</PARA></LISTITEM>
+<LISTITEM><PARA>SeeAlso is like See, but indicates 
+the index entries to which the reader is <EMPHASIS>also</EMPHASIS>
+to be directed when he consults a full index entry.
+SeeAlso must be nested within IndexTerm tags and must
+follow a Primary or Secondary element.   
+SeeAlso may contain in-line
+elements and has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>SeeAlsoIE is a ``see also'' entry in an Index, not in the 
+text, occurring 
+unnested within IndexEntry at the PrimaryIE or
+SecondaryIE level.  
+It may contain plain text only, and has common
+attributes and a Linkends attribute, which has the
+value of some list of IndexEntry IDs.
+</PARA></LISTITEM>
+<LISTITEM><PARA>SeeIE is a ``see'' entry in an Index, not in the 
+text, occurring 
+unnested within IndexEntry at the PrimaryIE or
+SecondaryIE level.  
+It may contain plain text only, and has common
+attributes and a Linkend attribute, which has the
+value of some IndexEntry ID.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Seg is a component of a SegmentedList.  Segs are the only
+content of a SegmentedList's 
+SegListItems.  They may contain in-line
+elements.  Seg has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>SegListItem is a list item in a SegmentedList.  It consists
+of two or more Segs, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>SegmentedList is a list of sets of units without additional text
+(and is thus different from the VarListItem,
+composed of Terms and ListItem,
+in a VariableList).  A SegmentedList may be used to represent 
+sets of information often presented as simple tables.  A SegmentedList
+may have a Title and TitleAbbrev, followed by any number
+of SegTitles, and two or more SegListItems.  SegmentedList
+has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>SegTitle is a title that pertains to one Seg in each 
+SegListItem:  the first SegTitle to the first Seg, the second SegTitle
+to the second Seg, and so on.  SegTitles may contain in-line elements,
+and are grouped at the beginning of a SegmentedList, before the SegListItems.
+SegTitle has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Series is part of DocInfo and names the publication series of
+which the book is a part.  Series may contain only plain text and
+has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Set is a set of Books.  It has an optional DocInfo and 
+must contain two or more Books.  Set has common attributes. 
+</PARA></LISTITEM>
+<LISTITEM><PARA>Sidebar is a segment of text isolated from the narrative flow
+of the main text, typically boxed.  A Sidebar may have
+a Title and a TitleAbbrev, and must have text formatted in
+some fashion:  allowable contents 
+include Paras, lists, Figures, and
+Tables.  No Sects allowed.  Sidebar has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>StructField is a field in a Structure.  It may
+contain plain text only, and has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>StructName is the name of a Structure.  It may
+contain plain text only, and has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Subscript tags subscripts.  It may contain plain text
+and another 
+Subscript, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Subtitle is for use in BookTitle.  It contains plain text and
+has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Superscript tags superscripts.  
+It may contain plain text and another Superscript, 
+and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Surname is an element of Author in DocInfo, supplied so 
+that a group of documents may be indexed
+by their authors's surnames.  It may contain 
+plain text only, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>SWapplic specifies the applicability of information
+given a software context.
+RefClass is a good place to put SWapplic information.
+SWapplic contains plain text only and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Symbol is a name that is replaced by a value before processing.
+Symbol contains plain text and
+has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Synopsis marks the line or lines that provide the
+syntax of a command or function.  It appears
+within RefSynopsisDiv, and may occur elsewhere in
+a document, too.  
+Synopsis may contain in-line elements; within it,
+line breaks and white space are significant.  It 
+has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>SystemItem may be used for any
+system-related item, as a catch-all.
+It may contain plain text, FunctionParam, VarParam, 
+Anchor, and Optional, 
+and has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>SystemName is the name of any system.  It may
+contain plain text only, and has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Table is an array of text.   A Table may have
+a Title, TitleAbbrev, and Graphic; following those
+elements
+it may have a TableSpec (containing such things as troff
+formatting information), any 
+number of TableColHeads (containing headings
+for the columns of the Table), and one or more TableRows of
+TableCells.  Table has common and Number attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>TableCell is a part of a TableRow in a Table.  It may contain
+in-line elements and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>TableColHead is an optional part of Table, containing
+headings for the columns of the Table as TableCells.
+It has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>TableRow is part of Table.  A Table has TableRows of TableCells.
+It has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>TableSpec tags formatting information for a Table; it is
+not the text of a Table's heading.  It may contain 
+in-line elements and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Task is any set of Paras and lists that 
+instructs the reader how to perform a given task.  Task
+may have a Title and TitleAbbrev, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Term is the hanging term attached to a ListItem within 
+a VarListEntry in a
+VariableList; visually, a VariableList 
+is a set of Terms with attached items such as paragraphs.  Each
+ListItem may be associated with a set of Terms.  Term may contain
+in-line elements or Synopsis, and has 
+common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Tertiary is a word or phrase that is to
+appear in the index under a Secondary entry.  It must be
+nested within IndexTerm tags and must follow a Secondary element.
+Tertiary may contain in-line elements, and has 
+common and
+HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>TertiaryIE is part of IndexEntry, like PrimaryIE, <EMPHASIS>q.v.</EMPHASIS>
+</PARA></LISTITEM>
+<LISTITEM><PARA>Tip is a suggestion to the user, set off from the text and supplied
+with a title, which is ``Tip'' unless another Title is
+supplied explicitly.  The contents of a Tip 
+may include Paras, lists, and so forth.
+Tip has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Title is a string of characters, the text of a heading
+or element title.  It is NOT the title of a Book:  that is
+BookTitle.  Title may contain
+in-line elements, and has common and PageNum attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>TitleAbbrev is an optional element of
+anything titled.  You may want to employ this element when a
+title is so long that you fear it will be truncated in
+some element of an online display, such as a title bar.  
+TitleAbbrev may contain
+in-line elements, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>ToC is a Table of Contents, which may be 
+a book component on its own or may
+occur within other book components.  It may
+have a DocInfo, Title, and TitleAbbrev, 
+and contains ToCentry1s. ToC has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>ToCentry1 is the top-level tag for items in a ToC.  In 
+the manner of
+Sect1, it may contain subsidiary groups (<EMPHASIS>e.g.,</EMPHASIS> for headings and
+subheadings within a chapter), named ToCentry2--5.  ToCentry1--5s
+have common attributes and 
+a PageNum attribute, for indicating the page numbers on which
+the ToCentries appear in a print book.  ToCentry1--5 may contain
+in-line elements.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Token is a unit of information in the context of lexical analysis.
+ Token contains plain text and
+has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Type indicates the classification of a value.
+ Type contains plain text and
+has common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>UserInput is an in-line element used to tag data entered by the user.
+You might use this element most frequently in LiteralLayouts and 
+Screens.  UserInput may contain in-line elements, and has 
+common and HasRefEntry attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>VariableList is a list of VarListEntries, which are
+composed of sets of one or more Terms with associated
+ListItems, which contain Paras.  Inclusions 
+are as for OrderedList, <EMPHASIS>q.v.</EMPHASIS>   VariableList has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>VarListEntry is a component of VariableList, <EMPHASIS>q.v.</EMPHASIS>
+</PARA></LISTITEM>
+<LISTITEM><PARA>VarParam tags any character string that is to be
+replaced by a real name or value by the user.  In
+``cat filename,'' filename is a VarParam.  If a
+VarParam is also, say, a Command, nest the VarParam
+tags within the Command tags:  VarParam may contain only
+plain text, Superscript, and Subscript, 
+not in-line elements.  It has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>VolumeNumber is the number of a Book in
+relation to a set or Set.  It contains plain text
+and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Warning is an admonition set off from the text and supplied
+with a title, which is ``Warning'' unless another Title is
+supplied explicitly.  The contents of a Warning 
+may include Paras, lists, and so forth.
+Warning has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>WordAsWord is supplied for use when a word (or letter or
+number) is used not to represent the thing or idea it usually
+represents, but merely as the word itself.  For example, 
+``The term &lt;WORDASWORD&gt;Gothic&lt;&sol;WORDASWORD&gt; means different
+things to art historians and typographers,'' or for a single character,
+``the
+letter &lt;WORDASWORD&gt;X&lt;&sol;WORDASWORD&gt;''.  WordAsWord may 
+contain only plain text, and has common attributes.
+</PARA></LISTITEM>
+<LISTITEM><PARA>XRef is a cross reference link to another part of the document,
+such as a Table, Figure, or Example.  An XRef 
+may contain text or be empty; it has an Endterm attribute, the value of which  
+may be set to the ID of the text to appear in the cross reference if no
+content is supplied.  
+An XRef that has both content and an Endterm attribute is faulty.
+XRef also has a Linkend attribute, the value of which is the ID of the 
+target of the XRef.
+</PARA></LISTITEM>
+<LISTITEM><PARA>Year is part of DocInfo and BiblioEntry (year of publication of the
+book).  Year may contain only plain text, and has common attributes.
+</PARA></LISTITEM>
+</ITEMIZEDLIST> 
+</CHAPTER>
+</DOCBOOK>
diff --git a/docbook/sgml/docbook1.2.1.dtd b/docbook/sgml/docbook1.2.1.dtd
new file mode 100644 (file)
index 0000000..6e75004
--- /dev/null
@@ -0,0 +1,931 @@
+<!--           DocBook DTD           Release 1.2.1
+
+   13 March 1993  1:00 PST
+
+   Copyright 1992, 1993  HaL Computer Systems, Inc., and
+     O'Reilly & Associates, Inc.
+
+   Permission to use, copy, modify and distribute the DocBook DTD and
+     its accompanying documentation for any purpose and without fee is
+     hereby granted, provided that this copyright notice appears in all
+     copies.  If you modify the DocBook DTD, rename your modified
+     version.  HaL Computer Systems and O'Reilly & Associates make no
+     representation about the suitability of the DTD for any purpose.
+     It is provided "as is" without expressed or implied warranty.
+
+   The DocBook DTD is maintained by O'Reilly & Associates.  Please
+     direct all questions, bug reports, or suggestions for changes to
+     docbook@ora.com or by mail to: Terry Allen, O'Reilly & Associates,
+     Inc., 103A Morris Street, Sebastopol, California, 95472.
+
+   Please note that an SGML declaration is provided for this DTD.
+     
+   Public Identifier:
+       "-//HaL and O'Reilly//DTD DocBook 1.2.1//EN"
+                                 -->
+
+<!-- ==================================================================
+       NOTATIONS  -->
+
+<!NOTATION GIF         SYSTEM "GIF" >
+<!NOTATION TIFF                SYSTEM "TIFF" >
+<!NOTATION CGM         SYSTEM "CGM" >
+<!NOTATION DVI         SYSTEM "DVI" >
+<!NOTATION EPS         SYSTEM "EPS" >
+<!NOTATION TEX         SYSTEM "TEX 3.14" >
+<!NOTATION TBL         SYSTEM "TBL" >
+<!NOTATION EQN         SYSTEM "EQN" >
+<!NOTATION PS          SYSTEM "PS" >
+<!NOTATION DITROFF     SYSTEM "DITROFF" >
+<!NOTATION PIC         SYSTEM "-//AT&T//NOTATION PIC-1//EN" >
+<!NOTATION linespecific        SYSTEM "line ends and leading white space
+                                must be preserved in output" >
+
+<!-- ==================================================================
+       PUBLICLY DECLARED EXTERNAL ENTITIES   -->
+
+<!-- Uncomment the ENTITY declaration for your application. -->
+
+<!--
+<!ENTITY % ISOamsa PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Arrow Relations//EN">
+          %ISOamsa;
+  -->
+<!--
+<!ENTITY % ISOamsa SYSTEM "iso-amsa.gml">
+          %ISOamsa;
+  -->
+
+<!--
+<!ENTITY % ISOamsb PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Binary Operators//EN">
+          %ISOamsb;
+  -->
+<!--
+<!ENTITY % ISOamsb SYSTEM "iso-amsb.gml">
+          %ISOamsb;
+  -->
+
+<!--
+<!ENTITY % ISOamsc PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Delimiters//EN">
+          %ISOamsc;
+  -->
+<!--
+<!ENTITY % ISOamsc SYSTEM "iso-amsc.gml">
+          %ISOamsc;
+  -->
+
+<!--
+<!ENTITY % ISOamsn PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Negated Relations//EN">
+          %ISOamsn;
+  -->
+<!--
+<!ENTITY % ISOamsn SYSTEM "iso-amsn.gml">
+          %ISOamsn;
+  -->
+
+<!--
+<!ENTITY % ISOamso PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Ordinary//EN">
+          %ISOamso;
+  -->
+<!--
+<!ENTITY % ISOamso SYSTEM "iso-amso.gml">
+          %ISOamso;
+  -->
+
+<!--
+<!ENTITY % ISOamsr PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Relations//EN">
+          %ISOamsr;
+  -->
+<!--
+<!ENTITY % ISOamsr SYSTEM "iso-amsr.gml">
+          %ISOamsr;
+  -->
+
+<!--
+<!ENTITY % ISObox  PUBLIC "ISO 8879:1986//ENTITIES Box and Line Drawing//EN">
+          %ISObox;
+  -->
+<!--
+<!ENTITY % ISObox  SYSTEM "iso-box.gml">
+          %ISObox;
+  -->
+
+<!--
+<!ENTITY % ISOcyr1 PUBLIC "ISO 8879:1986//ENTITIES Russian Cyrillic//EN">
+          %ISOcyr1;
+  -->
+<!--
+<!ENTITY % ISOcyr1 SYSTEM "iso-cyr1.gml">
+          %ISOcyr1;
+  -->
+
+<!--
+<!ENTITY % ISOcyr2 PUBLIC "ISO 8879:1986//ENTITIES Non-Russian Cyrillic//EN">
+          %ISOcyr2;
+  -->
+<!--
+<!ENTITY % ISOcyr2 SYSTEM "iso-cyr2.gml">
+          %ISOcyr2;
+  -->
+
+<!--
+<!ENTITY % ISOdia  PUBLIC "ISO 8879:1986//ENTITIES Diacritical Marks//EN">
+          %ISOdia;
+  -->
+<!--
+<!ENTITY % ISOdia  SYSTEM "iso-dia.gml">
+          %ISOdia;
+  -->
+
+<!--
+<!ENTITY % ISOgrk1 PUBLIC "ISO 8879:1986//ENTITIES Greek Letters//EN">
+          %ISOgrk1;
+  -->
+<!--
+<!ENTITY % ISOgrk1 SYSTEM "iso-grk1.gml">
+          %ISOgrk1;
+  -->
+
+<!--
+<!ENTITY % ISOgrk2 PUBLIC "ISO 8879:1986//ENTITIES Monotoniko Greek//EN">
+          %ISOgrk2;
+  -->
+<!--
+<!ENTITY % ISOgrk2 SYSTEM "iso-grk2.gml">
+          %ISOgrk2;
+  -->
+
+<!--
+<!ENTITY % ISOgrk3 PUBLIC "ISO 8879:1986//ENTITIES Greek Symbols//EN">
+          %ISOgrk3;
+  -->
+<!--
+<!ENTITY % ISOgrk3 SYSTEM "iso-grk3.gml">
+          %ISOgrk3;
+  -->
+
+<!--
+<!ENTITY % ISOlat1 PUBLIC "ISO 8879:1986//ENTITIES Added Latin 1//EN">
+          %ISOlat1;
+  -->
+<!--
+<!ENTITY % ISOlat1 SYSTEM "iso-lat1.gml">
+          %ISOlat1;
+  -->
+
+<!--
+<!ENTITY % ISOlat2 PUBLIC "ISO 8879:1986//ENTITIES Added Latin 2//EN">
+          %ISOlat2;
+  -->
+<!--
+<!ENTITY % ISOlat2 SYSTEM "iso-lat2.gml">
+          %ISOlat2;
+  -->
+
+<!--
+<!ENTITY % ISOnum  PUBLIC "ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN">
+          %ISOnum;
+  -->
+<!--
+<!ENTITY % ISOnum  SYSTEM "iso-num.gml">
+          %ISOnum;
+  -->
+
+<!--
+<!ENTITY % ISOpub  PUBLIC "ISO 8879:1986//ENTITIES Publishing//EN">
+          %ISOpub;
+  -->
+<!--
+<!ENTITY % ISOpub  SYSTEM "iso-pub.gml">
+          %ISOpub;
+  -->
+
+<!--
+<!ENTITY % ISOtech PUBLIC "ISO 8879:1986//ENTITIES General Technical//EN">
+          %ISOtech;
+  -->
+<!--
+<!ENTITY % ISOtech SYSTEM "iso-tech.gml">
+          %ISOtech;
+  -->
+
+
+<!-- ==================================================================  
+       PARAMETER ENTITIES to allow inclusion of local modifications.  
+       To include your local terms, table content model, graphics 
+       format, or other local item,
+       
+       1.  At the head of your instance, after the DOCTYPE line, 
+       include a reference to an external entity file that
+       that includes all the local terms, table content models,
+       and (or) graphics formats you are using:
+
+       <!DOCTYPE docbook SYSTEM "/yourpath/docbook.dtd" [
+       <!ENTITY % localmods SYSTEM "/yourpath/localmodfile" >
+       %localmods
+       ]>
+
+       You may need to set up attributes for your local elements.
+       
+       N.B.:  Depending on the flags you set, your parser may report 
+       as errors that it has found duplicate specifications of 
+       these parameter entities.  This is harmless, as the 
+       duplicates are those included below, which are unneeded. 
+
+       2.  In the referenced external entity file, redefine
+       the parameter entities for your local modifications.
+       Be sure to include the elements currently defined as
+       the content of the following entities if you need
+       to use them alongside your local modifications.
+                               -->
+
+<!ENTITY % local.refnav "RefEntry" >
+<!ENTITY % local.terms "Optional" >
+<!ENTITY % local.tables "Table" >
+<!ENTITY % local.notations "TEX" >
+<!ENTITY % local.refclasses "RefClass" >
+<!ENTITY % local.links "Link" >
+<!ENTITY % local.lists "SegmentedList" >
+
+<!-- =====================================================================
+       ATTRIBUTE LIST for a set of common attributes.  Remap can be
+         used to indicate the value of the element in the original
+         source.  -->
+
+<!ENTITY % commonatts
+               "id     ID      #IMPLIED
+               Remap   CDATA   #IMPLIED">
+
+<!-- ===================================================================
+       OTHER PARAMETER ENTITIES  -->
+
+<!--    Book Contents:  these are pieces it may be convenient to validate
+               on their own  -->
+
+<!ENTITY % bookcontent.gp "Appendix | Bibliography 
+                               | Chapter | DocInfo | Glossary
+                               | Index | LoT | Part | Preface 
+                               | RefEntry | Reference | ToC" >
+
+<!--    Contents that can appear almost anywhere  -->
+
+<!ENTITY % links.gp "ExternalLink | FootnoteRef
+                               | %local.links; | XRef" >
+
+<!ENTITY % basechar.gp "%links.gp; | #PCDATA | FunctionParam 
+                       | IndexTerm | VarParam | Anchor" >
+
+<!--  entities to make up inlinechar.gp  -->
+
+<!ENTITY % words.gp "Acronym | Character | Charset | Citation 
+                               | CiteBook | CiteChap 
+                               | CiteRefEntry  | CiteSect | Comment
+                               | Emphasis | FirstTerm 
+                               | Font | ForeignPhrase
+                               | GlossaryDef | GlossaryTerm | Glyph 
+                               | Quote | Subscript | Superscript 
+                               | Trademark | WordAsWord" >
+               <!ATTLIST  (%words.gp;) %commonatts; >
+
+<!ENTITY % docinfo.content.gp "Author | AuthorInitials
+                               | BookTitle 
+                               | Copyright | CorpAuthor | CorpName | Date
+                               | Editor | Edition 
+                               | InvPartNumber | ISBN 
+                               | LegalNotice | OrgName | PrintHistory 
+                               | ProductName | ProductNumber
+                               | Publisher | PubsNumber | ReleaseInfo
+                               | RevHistory | Series 
+                               | Subtitle | VolumeNumber" >
+               <!ATTLIST  (%docinfo.content.gp;)       %commonatts; >
+
+<!ENTITY % computerterms.gp "Action | Application | Button
+                               | Classname | Command 
+                               | ComputerOutput | Constant
+                               | DbName | DbTable | DbField | DbRecord
+                               | Error | EventType | EventStructure
+                               | Filename | Option | Function 
+                               | Hardware | HWapplic | Icon 
+                               | Interface | InterfaceDefinition
+                               | KeyCap | KeyCode | KeySym
+                               | LineAnnotation | Literal
+                               | Macro | Mask | Menu | MenuItem
+                               | Prompt | Property | OSname
+                               | ProtocolRequest
+                               | Resource | ReturnValue
+                               | StructField | StructName
+                               | SWapplic | Symbol
+                               | SystemItem | SystemName 
+                               | Token | Type | UserInput" >
+       <!ATTLIST  (%computerterms.gp;) %commonatts; 
+                                       HasRefEntry     (Yes|No)        No >
+
+
+<!ENTITY % inlinechar.gp "%basechar.gp; | %computerterms.gp;
+                               | %docinfo.content.gp; 
+                               | %local.terms; | %words.gp;" > 
+
+<!ENTITY % paracontent.gp "%inlinechar.gp; | Graphic | Equation
+                               | Synopsis" >
+
+<!--   All the varieties of lists  -->
+
+<!ENTITY % list.gp "ItemizedList | OrderedList | %local.lists; 
+                               | VariableList | SimpleList" >
+
+<!--   More elements for other parameter entities   -->
+
+<!ENTITY % object.gp "BlockQuote | Caution | Equation
+                               | Example | Footnote | Graphic 
+                               | Important | LiteralLayout 
+                               | %local.tables; | Note | ProgramListing 
+                               | Screen | Synopsis | Task
+                               | Tip | Warning" > 
+
+<!ENTITY % component.gp "Abstract | Anchor | AuthorBlurb | BiblioEntry 
+                               | Epigraph | Figure | Highlights 
+                               | IndexTerm | %links.gp;
+                               | %list.gp; | %object.gp; 
+                               | Para | Sidebar " >
+
+<!ENTITY % refnav.gp "%local.refnav; | Toc | LoT | Index
+                               | Glossary | Bibliography | Reference" >
+
+<!--   The sect1.gp parameter entity is used in Chapter, Preface,
+               and Appendix   -->
+
+<!ENTITY % sect1.gp "((%refnav.gp;)*, (%component.gp;)+, Sect1*, (%refnav.gp;)?)" > 
+
+
+
+<!-- ====================================================================
+       TOP-LEVEL DOCUMENT STRUCTURE  -->
+
+<!--  The intended base document element is DocBook, which has the Version 
+       attribute so that your instance can specify which version of 
+       this DTD it conforms to.  N.B.:  a DocBook instance need 
+       not be a complete book.  DocBooks may be nested within
+       other DocBooks  -->
+
+<!ELEMENT DocBook      - -  (BookTitle?, ((((%bookcontent.gp;)+)
+                               | Book | Set) | Docbook+))>
+       <!ATTLIST DocBook  Version CDATA "1.2">
+
+<!--    A model for a Set of Books  -->
+
+<!ELEMENT Set  - - (DocInfo?, Book, Book+)>
+               <!ATTLIST  Set
+                                       %commonatts; >
+
+<!--   A prescriptive model for a Book  -->
+
+<!ELEMENT Book - - (DocInfo, Toc?, LoT*, 
+                       Preface*, (Chapter+ | Part+),
+                       Reference*, Appendix*, 
+                       Glossary*, Bibliography*, Index*)>
+               <!ATTLIST  Book 
+                                %commonatts;
+                                Number  CDATA   #IMPLIED >
+
+<!-- ===================================================================
+     GENERAL STRUCTURES FOR BOOKS.  A Part contains two or more 
+       Chapters or Appendices.  A Preface, ToC, LoT, Bibliography, 
+       Glossary, or Index can be a chapter-level component, while ToC, 
+       LoT, Bibliography, Glossary, RefEntry, and Index may also appear 
+       within chapter-level components.  
+       -->
+
+<!ELEMENT Part - - (Title, TitleAbbrev?, PartIntro?, ((Chapter, Chapter+)
+                               | (Appendix, Appendix+)))>
+               <!ATTLIST Part  
+                               %commonatts;
+                               Number  CDATA   #IMPLIED >
+
+<!ELEMENT PartIntro    - - ((%component.gp;)+)>
+               <!ATTLIST PartIntro     
+                               %commonatts;
+                               Number  CDATA   #IMPLIED >
+
+<!--   Most of the book component elements  -->
+
+<!ELEMENT DocInfo      - -  ((%docinfo.content.gp)+)>
+               <!ATTLIST  DocInfo 
+                                       %commonatts; >
+               
+<!ELEMENT Preface      - -  (DocInfo?, Title, TitleAbbrev?, %sect1.gp;)>
+               <!ATTLIST  Preface
+                                       %commonatts; >
+
+<!ELEMENT Chapter      - -  (DocInfo?, Title, TitleAbbrev?, %sect1.gp;)>
+               <!ATTLIST Chapter
+                               %commonatts;
+                               Number  CDATA   #IMPLIED >
+
+<!ELEMENT Appendix     - -  (DocInfo?, Title, TitleAbbrev?, %sect1.gp;)>
+               <!ATTLIST  Appendix
+                               %commonatts;
+                               Number  CDATA   #IMPLIED >
+
+<!ELEMENT Reference    - -  (DocInfo?, Title, TitleAbbrev?, PartIntro?, RefEntry+)>
+                <!ATTLIST  Reference
+                                        %commonatts; >
+
+<!ELEMENT ToC  - -  (DocInfo?, (Title, TitleAbbrev?)?, ToCentry1+)>
+                <!ATTLIST  ToC
+                                        %commonatts; >
+
+<!ELEMENT LoT  - -  (DocInfo?, (Title, TitleAbbrev?)?, LoTentry+)>
+                <!ATTLIST  LoT
+                                        %commonatts; >
+
+<!ELEMENT Bibliography - -  (DocInfo?, (Title, TitleAbbrev?)?, Para*, BiblioEntry+)>
+                <!ATTLIST  Bibliography
+                                        %commonatts; >
+
+<!ELEMENT Glossary     - -  (DocInfo?, (Title, TitleAbbrev?)?, Para*, GlossaryEntry+)>
+                <!ATTLIST  Glossary
+                                        %commonatts; >
+
+<!ELEMENT Index        - -  (DocInfo?, (Title, TitleAbbrev?)?, Para*, IndexEntry+)>
+                <!ATTLIST  Index
+                                        %commonatts; >
+
+<!--  ============================================================
+       SECTIONS -->
+
+<!ELEMENT Sect1 - -  (Title, TitleAbbrev?, (%refnav.gp;)*, (%component.gp;)+,
+                        Sect2*, (%refnav.gp;)*)>
+                <!ATTLIST  Sect1
+                                        %commonatts;
+                                        Number  CDATA   #IMPLIED >
+
+<!ELEMENT Sect2 - -  (Title, TitleAbbrev?, (%refnav.gp;)*, (%component.gp;)+,
+                        Sect3*, (%refnav.gp;)*)>
+                <!ATTLIST  Sect2
+                                        %commonatts;
+                                        Number  CDATA   #IMPLIED >
+
+<!ELEMENT Sect3 - -  (Title, TitleAbbrev?, (%refnav.gp;)*, (%component.gp;)+,
+                        Sect4*, (%refnav.gp;)*)>
+                <!ATTLIST  Sect3
+                                        %commonatts;
+                                        Number  CDATA   #IMPLIED >
+
+<!ELEMENT Sect4 - -  (Title, TitleAbbrev?, (%refnav.gp;)*, (%component.gp;)+,
+                        Sect5*, (%refnav.gp;)*)>
+                <!ATTLIST  Sect4
+                                        %commonatts;
+                                        Number  CDATA   #IMPLIED >
+
+<!ELEMENT Sect5 - -  (Title, TitleAbbrev?, (%refnav.gp;)*,
+                        (%component.gp;)+, (%refnav.gp;)*)>
+                <!ATTLIST  Sect5
+                                       %commonatts;
+                                       Number  CDATA   #IMPLIED >
+
+<!ELEMENT Task - - ((Title, TitleAbbrev?)?, (Para | %list.gp;)+)>
+               <!ATTLIST  Task         %commonatts; >
+
+<!ELEMENT Sidebar      - -  ((Title, TitleAbbrev?)?, (%component.gp;)+)>
+               <!ATTLIST Sidebar       %commonatts; >
+
+<!--  ============================================================
+        PARAGRAPHS and RELATED ELEMENTS  -->
+
+<!ELEMENT Para         - - (Title?, (%inlinechar.gp; | %list.gp; | %object.gp;)+)>
+               <!ATTLIST  Para
+                                       %commonatts; >
+
+<!ELEMENT (Abstract | AuthorBlurb 
+                       | Comment )     - -  (Title?, (%paracontent.gp;)+)>
+               <!ATTLIST (Abstract | Authorblurb)
+                                %commonatts; >
+
+<!ELEMENT (Tip | Caution | Warning | Important | Note
+                       | BlockQuote)   - - (Title?, (%component.gp;)+)>
+               <!ATTLIST (Tip | Caution | Warning | Important 
+                       | Note | BlockQuote )   %commonatts; >
+
+<!ELEMENT Highlights   - -  ((%list.gp; | Para 
+                       | (Tip | Caution | Warning | Important | Note))+)>
+               <!ATTLIST  Highlights   %commonatts; >
+
+<!ELEMENT Footnote     - -  ((%component.gp;)+)>
+               <!ATTLIST  Footnote
+                                       %commonatts;
+                                       Number  CDATA   #IMPLIED >
+
+<!ELEMENT Epigraph     - -  ((Para)+)>
+               <!ATTLIST  Epigraph 
+                                       %commonatts; >
+
+<!ELEMENT Title        - -  ((%inlinechar.gp;)+) >
+               <!ATTLIST Title %commonatts; 
+                               Pagenum CDATA   #IMPLIED >
+
+<!ELEMENT TitleAbbrev  - - ((%inlinechar.gp;)+) >
+               <!ATTLIST TitleAbbrev   %commonatts; >
+
+<!-- ==============================================================
+       LISTS  -->
+
+<!-- The Mark attribute specifies the mark that should appear before
+       each ListItem, such as Bullet, Dash, Box, Check. 
+       You might want to make these entities (such as &bullet;) -->
+
+<!ELEMENT ItemizedList - -  (ListItem+)>
+       <!ATTLIST  ItemizedList   
+               %commonatts;
+               Mark    CDATA   #IMPLIED>
+
+<!ELEMENT ListItem     - -  ((Para | %list.gp; | Figure
+                               | %object.gp;)*)>
+               <!ATTLIST  ListItem     %commonatts; >
+
+<!ELEMENT SegmentedList        - -  ((Title, TitleAbbrev?)?, 
+                                       SegTitle*, SegListItem+)>
+               <!ATTLIST  SegmentedList        %commonatts; >
+
+<!ELEMENT SegTitle     - -  ((%inlinechar.gp;)+)>
+               <!ATTLIST  SegTitle     %commonatts; 
+                               HasRefEntry     (Yes|No)        No >
+
+<!ELEMENT SegListItem  - -  (Seg, Seg+)>
+               <!ATTLIST  SegListItem  %commonatts; >
+
+<!ELEMENT Seg  - - ((%inlinechar.gp;)+)>
+               <!ATTLIST  Seg  %commonatts; 
+                               HasRefEntry     (Yes|No)        No >
+
+<!ELEMENT OrderedList  - -  (ListItem+)>
+        <!ATTLIST  OrderedList  
+               %commonatts;
+               Numeration      (Arabic | Upperalpha | Loweralpha
+                               | Upperroman | Lowerroman) Arabic
+               InheritNum  (Inherit | Ignore)  Ignore 
+               Continuation  (Yes | No)  No >
+
+<!ELEMENT VariableList - -  ((Title, TitleAbbrev?)?, VarListEntry+)>
+               <!ATTLIST  VariableList %commonatts; >
+
+<!ELEMENT VarListEntry - -  (Term+, ListItem)>
+               <!ATTLIST  VarListEntry %commonatts; >
+
+<!ELEMENT Term         - -  (((%inlinechar.gp;)+ | Synopsis))>
+               <!ATTLIST  Term %commonatts; 
+                               HasRefEntry     (Yes|No)        No >
+
+<!ELEMENT SimpleList   - -  (Term+)>
+               <!ATTLIST  SimpleList %commonatts;
+                               Wrap    (Vert | Horiz | None)   None>
+
+<!--  ================================================================
+      LINKS 
+       Use of the HyTime terms Linkend and Endterm 
+       does not indicate that HyTime processing is required.
+       Link has both Endterm and Linkend attributes:  
+       Linkend is the spot linked to, Endterm identifies information
+       that may be used by the Link.  You might, for example,
+       make the Linkend a Sect2 and make the Endterm its Title.
+       -->
+
+<!ELEMENT Anchor       - O  EMPTY>
+               <!ATTLIST  Anchor
+                                       %commonatts;
+                                       Pagenum CDATA #IMPLIED >
+
+<!ELEMENT Link  - -  ((%inlinechar.gp;)+)>
+        <!ATTLIST Link
+                Endterm IDREF   #IMPLIED
+                Linkend IDREF   #REQUIRED
+                Type    CDATA   #IMPLIED>
+
+<!--  ExternalLink avoids using IDREFs so you can link to a location
+       not available to the SGML parser without incurring parsing errors 
+                       -->
+
+<!ELEMENT ExternalLink - -  ((%inlinechar.gp;)+)>
+        <!ATTLIST ExternalLink  
+               Endterm CDATA   #IMPLIED
+               Linkend CDATA   #REQUIRED
+                Type    CDATA   #IMPLIED>
+
+<!ELEMENT FootnoteRef  - O (#PCDATA)>
+        <!ATTLIST FootnoteRef   
+               id      ID      #IMPLIED
+               Linkend IDREF   #REQUIRED
+                Mark    CDATA   #IMPLIED>
+
+<!ELEMENT XRef - - (#PCDATA)>
+       <!ATTLIST XRef   
+               Endterm IDREF   #IMPLIED
+               Linkend IDREF   #REQUIRED>
+
+<!--  =================================================================
+      OBJECTS  -->
+
+<!ELEMENT Example      - -  (Title, TitleAbbrev?,
+                               (Screen | LiteralLayout | ProgramListing)+)>
+               <!ATTLIST  Example      %commonatts; 
+                        format  NOTATION (linespecific) linespecific >
+
+<!ELEMENT ProgramListing       - -  ((%inlinechar.gp;)+)>
+               <!ATTLIST  ProgramListing       %commonatts; 
+                        format  NOTATION (linespecific) linespecific >
+
+<!ELEMENT LiteralLayout        - -  ((%inlinechar.gp;)+)>
+               <!ATTLIST  LiteralLayout        %commonatts; 
+                        format  NOTATION (linespecific) linespecific >
+
+<!ELEMENT Screen       - -  (((%inlinechar.gp;)+) | (ScreenInfo, Graphic))>
+               <!ATTLIST  Screen       %commonatts; 
+                        format  NOTATION (linespecific) linespecific >
+
+<!ELEMENT ScreenInfo   - -  (#PCDATA)>
+               <!ATTLIST  ScreenInfo   %commonatts; >
+
+<!--  Graphic is for in-line use or inclusion in another element.
+       Graphical data can be the content of Graphic, or you 
+       can reference an external file through the 
+       Fileref attribute, either as an entity or a filename.  -->
+
+<!ELEMENT Graphic      - -  CDATA>
+        <!ATTLIST  Graphic 
+               format NOTATION (%local.notations; | GIF | TIFF
+                                       | CGM | DVI | EPS 
+                                       | TBL | EQN | PS 
+                                       | DITROFF | PIC) #IMPLIED
+               Fileref         CDATA   #IMPLIED 
+               Entityref       ENTITY  #IMPLIED        
+               id              ID      #IMPLIED>
+
+<!-- N.B.:  Graphic occurs in object.gp, so does not appear explicitly
+               in Figure.    -->
+
+<!ELEMENT Figure       - -  (Title, TitleAbbrev?, 
+                               (%object.gp; | IndexTerm)*)> 
+       <!ATTLIST Figure        id      ID              #IMPLIED
+                                       Height  CDATA           #IMPLIED
+                               Width   CDATA           #IMPLIED
+                               Align   (l|c|r)         l
+                               Float   (YES | NO)      NO >
+
+<!ELEMENT Equation     - -  ((Title, TitleAbbrev?)?, Graphic)>
+               <!ATTLIST Equation      %commonatts; >
+
+<!--  ================================================================
+      TABLE
+       A simple model; you can use any other table model by making
+       a local modification.  -->
+
+<!ELEMENT Table        - -  ((Title, TitleAbbrev?)?, Graphic?, 
+                               (TableSpec?, TableColHead*, TableRow+)?)>
+                       <!ATTLIST  Table        %commonatts;
+                                               Number  CDATA   #IMPLIED >
+
+<!ELEMENT TableSpec    - -  (%inlinechar.gp;)>
+                       <!ATTLIST  TableSpec    %commonatts; >
+
+<!ELEMENT TableColHead - -  (TableCell+)>
+                       <!ATTLIST  TableColHead %commonatts; >
+
+<!ELEMENT TableCell    - -  ((Para | %inlinechar.gp;)+)>
+                       <!ATTLIST  TableCell    %commonatts; >
+
+<!ELEMENT TableRow     - -  (TableCell+)>
+                       <!ATTLIST  TableRow     %commonatts; >
+
+<!--  ===============================================================
+      NAVIGATIONAL AND REFERENCE  -->
+
+<!ELEMENT ToCentry1    - -  ((%inlinechar.gp;)+, ToCentry2*)>
+               <!ATTLIST  ToCentry1    %commonatts; 
+                                       Pagenum CDATA   #IMPLIED >
+
+<!ELEMENT ToCentry2    - -  ((%inlinechar.gp;)+, ToCentry3*)>
+               <!ATTLIST  ToCentry2    %commonatts; 
+                                       Pagenum CDATA   #IMPLIED >
+
+<!ELEMENT ToCentry3    - -  ((%inlinechar.gp;)+, ToCentry4*)>
+               <!ATTLIST  ToCentry3    %commonatts; 
+                                       Pagenum CDATA   #IMPLIED >
+
+<!ELEMENT ToCentry4    - -  ((%inlinechar.gp;)+, ToCentry5*)>
+               <!ATTLIST  ToCentry4    %commonatts; 
+                                       Pagenum CDATA   #IMPLIED >
+
+<!ELEMENT ToCentry5    - -  ((%inlinechar.gp;)+)> 
+               <!ATTLIST  ToCentry5    %commonatts; 
+                                       Pagenum CDATA   #IMPLIED >
+
+<!ELEMENT GlossaryEntry        - -  (GlossaryTerm, GlossaryDef)>
+               <!ATTLIST  GlossaryEntry        %commonatts; >
+
+<!ELEMENT BiblioEntry  - -  (TitleAbbrev?, 
+                       (Author | CorpAuthor | Editor | Title)+,
+                               Subtitle?, Date?, 
+                               Publisher?, #PCDATA)>
+               <!ATTLIST  BiblioEntry          %commonatts; >
+
+<!--   IndexTerms appear in the text, not in the Index.  -->
+
+<!ELEMENT IndexTerm    - -  (Primary, 
+       (((Secondary, (Tertiary | See | SeeAlso+)?) | See | SeeAlso+))?)>
+       <!ATTLIST IndexTerm  
+               %commonatts;
+               Span   (Start|End) #IMPLIED
+               Pagenum   CDATA  #IMPLIED>
+
+<!ELEMENT (Primary | Secondary | Tertiary )      - -  ((%inlinechar.gp; 
+                               | IndexAs)+)>
+        <!ATTLIST  (Primary | Secondary | Tertiary )
+                                %commonatts;>
+
+<!ELEMENT IndexAs      - - ((%inlinechar.gp;)+)>
+       <!ATTLIST  IndexAs   %commonatts;>
+
+<!ELEMENT (See | SeeAlso)      - -  ((%inlinechar.gp;)+)>
+       <!ATTLIST  (See | SeeAlso)
+                               %commonatts;
+                               HasRefEntry     (Yes | No)      No >
+
+<!--  IndexEntries appear in the Index, not the text.  -->
+
+<!ENTITY % primsee "PrimaryIE, (SeeIE | SeeAlsoIE+)*" >
+
+<!ENTITY % secsee "(SecondaryIE, ((SeeIE | SeeAlsoIE+) | TertiaryIE)*)" >
+
+<!ELEMENT IndexEntry   - -  (%primsee, (%secsee)*)>
+<!ATTLIST IndexEntry  
+                                       %commonatts; >
+
+<!ELEMENT PrimaryIE    - - (#PCDATA)>
+       <!ATTLIST PrimaryIE  
+                               %commonatts;
+                               Linkends        IDREFS #REQUIRED>
+       
+<!ELEMENT SecondaryIE  - - (#PCDATA)>
+       <!ATTLIST SecondaryIE  
+                               %commonatts;
+                               Linkends        IDREFS #REQUIRED>
+
+<!ELEMENT TertiaryIE   - - (#PCDATA) >
+       <!ATTLIST TertiaryIE  
+                               %commonatts;
+                               Linkends        IDREFS #REQUIRED>
+
+<!ELEMENT SeeIE        - - (#PCDATA) >
+       <!ATTLIST SeeIE         %commonatts;
+                               Linkend         IDREF   #REQUIRED>
+
+<!ELEMENT SeeAlsoIE    - -  (#PCDATA) >
+       <!ATTLIST SeeAlsoIE             %commonatts;
+                               Linkends        IDREFS  #REQUIRED>
+
+<!ELEMENT LoTentry     - -  ((%inlinechar.gp;)+ )>
+       <!ATTLIST LoTentry              %commonatts;
+                               Pagenum CDATA   #IMPLIED >
+
+<!--  ==============================================================
+       DOCINFO elements; some appear in BiblioEntry, too  -->
+
+<!ELEMENT Author       - -  ((Honorific | Firstname 
+                               | Surname | OtherName)+) >
+
+<!ELEMENT Editor       - -  ((Honorific | Firstname 
+                               | Surname | OtherName)+) >
+
+<!ELEMENT (AuthorInitials | BookAcronym | CorpAuthor | CorpName 
+                               | Date | Edition 
+                               | Firstname | Holder 
+                               | Honorific | ISBN | InvPartNumber 
+                               | OrgName | OtherName
+                               | ProductName | ProductNumber 
+                               | Publisher | ReleaseInfo
+                               | RevNumber | RevRemark 
+                               | Series | Subtitle 
+                               | Surname | Year )      - -  (#PCDATA)>
+
+<!ELEMENT Copyright    - -  (Year+, Holder*)>
+
+<!ELEMENT LegalNotice  - -  ((Para | BlockQuote)+)>
+
+<!ELEMENT PrintHistory - -  (Para+)>
+
+<!ELEMENT RevHistory   - -  (Revision*)>
+
+<!ELEMENT Revision     - -  (RevNumber, Date, AuthorInitials+, RevRemark)>
+
+<!ELEMENT BookTitle    - -  (Title, Subtitle?, TitleAbbrev?, 
+                               ReleaseInfo?, BookAcronym?)>
+
+<!--  ==================================================================
+      OTHER IN-LINE ELEMENTS  -->
+
+<!ELEMENT (FunctionParam | VarParam)   - -  ((#PCDATA 
+                                       | Superscript | Subscript)+)>
+               <!ATTLIST  VarParam  %commonatts; >
+
+<!ELEMENT Command      - -  ((%basechar.gp; | Optional | Option)+)>
+
+<!ELEMENT (Action | Filename | Function 
+                       | Hardware | KeyCap | Interface
+                       | InterfaceDefinition
+                       | Property | ProtocolRequest
+                       | SystemItem)   - -  ((%basechar.gp; | Optional)+)>
+
+<!ELEMENT Option       - - ((%basechar.gp; | Optional)+)>
+
+<!ELEMENT (ComputerOutput | Literal)   - -  (Anchor | #PCDATA)>
+
+<!ELEMENT (CiteBook | CiteChap | CiteSect 
+                       | CiteRefEntry | GlossaryTerm
+                       | GlossaryDef | UserInput
+                       | Quote)        - -  ((%inlinechar.gp;)+)>
+
+
+<!ELEMENT Subscript    - -  (#PCDATA | Subscript)>
+
+<!ELEMENT Superscript  - -  (#PCDATA | Superscript)>
+
+<!ELEMENT (Acronym | Application | Button | Character | Charset 
+                       | Citation | Classname | Constant 
+                       | DbName | DbTable | DbField | DbRecord
+                       | Emphasis | Error
+                       | EventType | EventStructure | FirstTerm 
+                       | Font | ForeignPhrase | Glyph | HWapplic
+                       | Icon | KeySym | KeyCode | LineAnnotation
+                       | Macro | Mask | Menu | MenuItem 
+                       | OSname | Prompt
+                       | PubsNumber | Resource | ReturnValue
+                       | StructField | StructName
+                       | SWapplic | Symbol
+                       | SystemName | Token | Type
+                       | VolumeNumber | WordAsWord)    - -  (#PCDATA)>
+
+<!--  The element named Optional is for use in syntax lines, as in a 
+       RefEntry, where optional parameters are shown in square 
+       brackets.  Optional should replace those brackets.   -->
+
+<!ELEMENT (Optional | Trademark)       - - ((%basechar.gp; | %computerterms.gp;
+                       | Optional)+)>
+               <!ATTLIST  Optional     %commonatts; >
+
+<!--  ================================================================
+      REFERENCE ENTRIES  -->
+
+<!ELEMENT RefEntry     - -  (DocInfo?, RefMeta?, 
+                               (Comment | IndexTerm)*, 
+                               RefNameDiv, 
+                               RefSynopsisDiv?, 
+                               RefSect1+)>
+               <!ATTLIST  RefEntry     %commonatts; >
+
+<!ELEMENT RefMeta      - -  (RefFileName, ManVolNum?, RefMiscInfo*)>
+               <!ATTLIST  RefMeta      %commonatts; >
+
+<!ELEMENT RefFileName  - -  (#PCDATA)>
+               <!ATTLIST  RefFileName  %commonatts; >
+
+<!ELEMENT ManVolNum    - -  (#PCDATA)>
+               <!ATTLIST  ManVolNum    %commonatts; >
+
+<!ELEMENT RefMiscInfo  - -  (#PCDATA)>
+               <!ATTLIST  RefMiscInfo  %commonatts; >
+
+<!ELEMENT RefNameDiv   - -  (RefDescriptor?, RefName+, 
+                       RefPurpose, (%local.refclasses;)?, 
+                               (Comment | IndexTerm)*)>
+               <!ATTLIST  RefNameDiv   %commonatts; >  
+       
+<!ELEMENT RefDescriptor        - -  (#PCDATA)>
+               <!ATTLIST  RefDescriptor  %commonatts; >
+       
+<!ELEMENT RefName      - -  ((#PCDATA | %computerterms.gp;)+)>
+               <!ATTLIST  RefName      %commonatts; >  
+
+<!ELEMENT RefPurpose   - -  ((%inlinechar.gp;)+)>
+               <!ATTLIST  RefPurpose   %commonatts; >  
+
+<!-- RefClass includes local.refclasses, as they are meant to
+       be subelements, not alternatives, as is the case with
+       the other local.* groups  -->
+
+<!ELEMENT RefClass     - -  ((%inlinechar.gp;)+)>
+
+<!ELEMENT RefSynopsisDiv       - -  ((Synopsis, RefSect2*)
+                               | (RefSect2+))>
+        <!ATTLIST RefSynopsisDiv   %commonatts;
+                               Name  (Synopsis | Syntax)  Synopsis >
+
+<!ELEMENT Synopsis     - -  ((%inlinechar.gp;)+)>
+               <!ATTLIST  Synopsis     %commonatts; 
+               format  NOTATION (linespecific) linespecific >
+
+<!ELEMENT RefSect1     - -  (Title, 
+               (((%component.gp;)+, RefSect2*) | RefSect2+))>
+               <!ATTLIST  RefSect1     %commonatts; >
+
+<!ELEMENT RefSect2     - -  (Title, (%component.gp;)+)>
+               <!ATTLIST  RefSect2     %commonatts; >
+
+<!--  end of the DocBook DTD -->
index 81ebfb97fea7e41daa05b35820cf1e0c3833c9d3..7812c93666c4a2bf9c6c0824b6665a3f731c9995 100644 (file)
@@ -61,6 +61,6 @@ FEATURES
   OTHER
     CONCUR   NO
     SUBDOC   NO
-    FORMAL   NO
+    FORMAL   YES
   APPINFO    NONE
 >
index 0dc8f75421f0f4f91f6bc96d11ded05752bb2feb..66b77f028452dc40a0cdae1273a068b030b99336 100644 (file)
@@ -1,4 +1,3 @@
-<!DOCTYPE DOCBOOK SYSTEM "/work/dmg/dtds/oratable.dtd">
 <DOCBOOK>
 <DOCINFO><BOOKTITLE><TITLE>X Window System User's Guide</TITLE>
 </BOOKTITLE></DOCINFO>