The Elements Alphabetized Emphasized entries indicate block-oriented elements. “Dropped” elements appeared in version 1.2.2 but do not appear in the current version; many have been shifted to attribute values in cptrphrase.gp. Common Attributes Common attributes now include ID, Lang (language), Remap (to store the former GI of an element in a document filtered to Docbook), Role (to type Docbook elements when need be), and XRefLabel (text to be displayed as the label of cross references to a block-oriented element). ID is an identifier, which must be a string that is unique at least within the document and which must begin with a letter. Lang should be a language code drawn from ISO 639 (perhaps extended with a country code drawn from ISO 3166, as en_US). Use it when you need to signal your application to change hyphenation and other display characteristics. Remap is a device for preserving a previous tag name when fitting a document to the DocBook DTD. Think of CHAPTER Remap=“Fascicle” as saying, “I'm a Chapter now, but in a previous life I was a Fascicle.” Role allows you to clone DocBook elements without creating new ones: if you have lists of vegetables and lists of fruit (perhaps displayed differently), give them Role=vegetables and Role=fruit attributes. Other Attributes Certain other attributes occur regularly. PageNum is the number of the page on which a given element begins or occurs in a printed book. Label holds some text associated with its element that is to be output when the document is rendered. XRefLabel holds some text that is to be used when a cross reference (XRef) is made to its element. Type is used with links, as it is clear that different types of links may be required; it duplicates the function of Role. The Class attribute has been introduced in an attempt to control the number of computer-specific in-line elements. The elements that bear the Class attribute, such as Interface, have general meanings that can be made more specific by providing a value for Class from the delimited list for that element. For example, for the Interface element one may specify Menu, or Button; for the MediaLabel element one may specify CDRom or Tape. Each element has its own list of permissible values for Class, and no default is set, so you can ignore this attribute if you wish. Some attributes are defined with the keyword %yesorno;, which resolves to NUMBER. To supply the required number, which must be either 1 or 0, you can use the parameter entities %yes; (1); or %no; (0). An attributes that has the keyword IMPLIED bears no processing expections if it is absent or its value is null. Application designers might wish to supply plausible defaults, but none is specified here. However, it would be plausible to imply that the language of a DocBook instance is U.S. English unless specified otherwise. (This matter may be clarified when character set specification is added to the DTD; for now, the character set must be inferred from the Lang attribute value, if present.) cptrphrase.gp This parameter entity has been introduced to provide some structure for in-line elements related to computers. Its contents are: plain text, Anchor, BeginPage, all the index terms, Comment, Subscript, Superscript, all the kinds of links, Action, Application, ClassName, Command, ComputerOutput, Database, ErrorName, ErrorType, EventStructure, EventType, Filename, Function, Hardware, Interface, InterfaceDefinition, KeyCap, KeyCode, KeySym, LineAnnotation, Literal, Mask, MediaLabel, MsgText, Option, Optional, Parameter, Property, ProtocolRequest, Replaceable, ReturnValue, StructField, StructName, Symbol, SystemDialog, SystemItem, Token, Type, and UserInput. Many of these elements now have attributes with delimited value lists; some former in-line elements now appear as values for those attributes. “In-line” vs. “In flow” In this document, “in-line” means ”occuring within a line of text, like a character or character string, not causing a line break.” This term is sometimes used to refer to objects such as an illustration around which something like a paragraph is wrapped; here that circumstance will be called “in flow.” There is no provision yet for indicating that an object is in flow, but one could make creative use of the Role attribute to do so. A related point: formal objects have titles; informal objects do not. That an object is informal does not mean that it is in-line: these are two different characteristics. CALS Tables In this revision, the former Table models have been replaced by one derived from MIL-M-28001B, dated 26 July 1993 (supersedes MIL-M-28001A of 20 July 1990.) The documentation of Table and its subelements, below, has been taken from that document, with some editing and attempts at clarification. List of Elements Abstract A document summary. Abstract contains an optional Title followed by paragraphs, and has common attributes. Abbrev An abbreviation, especially one followed by a period. It contains plain text and has common attributes. Ackno Acknowledgements in an Article. It contains plain text. Acronym A pronounceable contraction of initials, usually printed in all caps or small caps. It contains plain text and has common attributes. Action A function invoked in response to a user event. It may contain members of cptrphrase.gp, and has common and MoreInfo attributes. For the MoreInfo attribute see Application. Address A real-world address. It contains any number, in any order, of: Street, POB, Postcode, City, State, Country, Phone, Fax, and Email. Affiliation Author's institutional affiliation. It contains, in order, an optional ShortAffil, any number of JobTitles, optional OrgName, any number of Orgdivs, and any number of Addresses. Anchor Marks a target for a Link. Anchor may appear almost anywhere, and has no content. Anchor has ID, Pagenum, Remap, Role, and XRefLabel attributes; the ID is required. Appendix May occur only after Chapters or References, in a Book. Appendix begins with an optional DocInfo, followed by a required Title, optional TitleAbbrev, and anything found in the body of a Chapter. It has common and Label attributes. Application The name of a software program. It may contain members of cptrphrase.gp, and has common, Class, and MoreInfo attributes. Class may be Hardware or Software (no default). MoreInfo may have the value RefEntry, indicating that a RefEntry exists containing additional information about this term. The default value for MoreInfo is None. Arg Argument in a CmdSynopsis. Arg may contain any number of Args, Groups, Options, SynopFragmentRefs, Replaceables, in any order, mixed with plain text. Arg is defined in the DTD as having common attributes and the attributes defined by the parameter entities argchcatt and repatt. argchcatt or “argument choice attribute” resolves to the attribute Choice, with allowed values Opt (the Arg is optional; the default), Req (it is required), and Plain (neither optional nor required). repatt or “repetition attribute” resolves to the attribute Rep, with allowed values Repeat (the Arg may be repeated; the default) and Norepeat (the Arg does not repeat). ArtHeader Metainformation for an Article. ArtHeader has, in order, a required Title, optional TitleAbbrev, optional Subtitle, one or more AuthorGroups, optional BookBiblio, a required ArtPageNums, any number of Abstracts, any number of ConfGroups, and finally any number ContractNums and ContractSponsors, in any order. ArtHeader has common attributes. Article An article in a journal. Book may be used to hold Articles. An Article has, in order, a required ArtHeader, main contents as for Chapter, then any number of Indexes, Glossaries, Bibliographies, Appendixes and Acknos, in any order. Article has common and ParentBook attributes, the latter pointing to the ID of the enclosing Book. ArtPageNums Page numbers of an Article as published. It contains plain text (e.g., 23-147). Author Author of a document, occuring in AuthorGroup. It consists of one or more of the following, in any order: Honorific, Firstname, Surname, Lineage, OtherName, Affiliation, and AuthorBlurb. It has common attributes. AuthorBlurb Short description of author. AuthorBlurb contains an optional Title followed by paragraphs, and has common attributes. AuthorGroup Wrapper for Author information. It contains one or more CorpAuthors, Collabs, and Authors, in any order. AuthorInitials Indicates the author of a Revision or Comment. It contains plain text and has common attributes. BeginPage Marks a page break in a print version of a work that may be displayed online. It is without content, but has ID, PageNum, Remap, Role, and XRefLabel attributes. The ID is required. The value of PageNum, which is not required, should be the folio (page number) of the page beginning at that point. Usage Note: Once you give a PageNum to a BeginPage, subsequent BeginPages should be assumed to indicate that value incremented by one per BeginPage. You can indicate a change or reset in page numbering by providing a PageNum value for a later BeginPage. BiblioDiv A section of a Bibliography. It may have, in order, an optional Title, optional TitleAbbrev, any number of block-oriented elements, followed by one or more BiblioEntries. It has common attributes. BiblioEntry An entry in a Bibliography. It may begin and end with BiblioMiscs, between which must be an ArtHeader, BookBiblio, or SeriesInfo. That is, the main content of a BiblioEntry may be identical to a section of metainformation. BiblioEntry has common attributes. Bibliography A bibliography. It may be a book component on its own, or may appear within a Preface, Chapter, or Appendix, or at the end of a Glossary. It may have a DocInfo, a Title and a TitleAbbrev, then optional block-oriented elements, and then one or more BiblioEntries or one or more BiblioDivs. It has common attributes. BiblioMisc Untyped information required in a BiblioEntry or BookInfo, in addition to the elements required there. It contains plain text and has common attributes. BlockQuote A quotation set off from the main text, rather than occurring in-line. It may have a Title, followed by block-oriented elements. It has common attributes. Book A collection of book components. The Book content model has been drawn more tightly since version 1.2.2, but is loose enough to accomodate English, French, and Japanese books. A Book may have a Title and TitleAbbrev, followed in order by an optional BookInfo, an optional ToC, any number of LoTs, any number of Prefaces, main contents, and back matter. The main contents are required, and must be one or more Parts; one or more Chapters followed by any number of References; one or more Articles; or one or more References. All back matter is optional, but must appear in order: any number of Appendices, a Glossary, a Bibliography, and any number of Indexes and SetIndexes, followed by any number of LoTs followed by an optional ToC. Book has common, FPI, and Label attributes. The FPI attribute is intended to hold an SGML Formal Public Identifier for the Book; the Label attribute can be used to supply the number of a Book, or you can use the content of the VolumeNum element in BookInfo. in constructing Formal Public Identifiers you use your ISBN publisher's prefix. In the ISBN 1–565692–043–0, for example, the publisher's prefix is 565692. BookAcronym Dropped. BookBiblio All the information about a book that may be relevant to a bibliographical citation; occurs in BookInfo and may be used in BiblioEntry. Only Title and AuthorGroup are required. BookBiblio may contain, in order: the required Title, optional TitleAbbrev, Subtitle, and Edition, followed one or more required AuthorGroups; then, optionally, either an ISBN followed by an optional VolumeNum or an ISSN followed by optional VolumeNum, optional IssueNum, and an optional PageNums. After these elements there may occur, again optionally and in order, InvPartNumber, ProductNumber, ProductName, PubsNumber, and ReleaseInfo; then there may be any number of Pubdates followed by any number of Publishers, followed by optional Copyright, then optional SeriesInfo; then any number of Abstracts, any number of ConfGroups, any number of ContractNums mixed with any number of ContractSponsors, and an optional PrintHistory followed by an optional RevHistory. BookBiblio has common attributes. is the numbers of the pages contained in a given issue or volume BookInfo Metainformation for a Book, in which it may appear. BookInfo must contain a BookBiblio, followed by any number of LegalNotices, followed by any number of ModeSpecs (which are pointed to by the LinkMode attribute of OLink, and are collected here for convenience). BookInfo has common attributes and a Contents attribute, the values of which are the IDs of the ToC, LoTs, Prefaces, Parts, Chapters, Appendixes, References, Glossary, Bibliography, and indexes comprising the Book, in the order of their appearance. BookTitle Dropped. BridgeHead A free-floating heading not tied to the Sect hierarchy. It may contain in-line elements and has common and Renderas attributes. Use the Renderas attribute to indicate the format in which the BridgeHead should appear (Sect1, Sect2, Sect3, Sect4, Sect5, or Other, the default). Button Dropped. See Interface. Caution An admonition set off from the text; Tip, Warning, Important, and Note all share its model. Its contents may include paragraphs, lists, and so forth, but not another admonition. Caution and its sisters have common attributes. Chapter A part of a Book. Chapter contain anything except higher-level elements such as Part, Book, and Set, or peers such as Appendix and Preface. A Chapter may begin with a DocInfo, followed by a required Title, optional TitleAbbrev, and body. The body may be either paragraphs and block-oriented elements or Sects containing them. At the beginning and end of the body of a Chapter, or the beginning and end of any Sect, there may be any number of ToCs, LoTs, Indexes, Glossaries, and Bibliographies, not that such an organization is recommended for ordinary use. Chapter has common and Label attributes. Character An element of a writing system. Characters may belong to Charsets, and in some contexts fonts represent characters. (See Glyph, Font.) It contains plain text and has common attributes. Charset A conventionally defined set of characters, (not a font). It contains plain text and has common attributes. Citation Any in-line bibliographic reference to another published work that uses a reference string, such as an abbreviation in a Bibliography. Compare CiteTitle. Citation contains plain text and has common attributes. CiteTitle A citation for some published work. Compare Citation. It may contain members of cptrphrase.gp, and has common and Pubwork attributes. The value of Pubwork should indicate the type of work cited; it may be Article, Book, Chapter, RefEntry, or Section (no default). CiteBook Dropped. See CiteTitle. CiteChap Dropped. See CiteTitle. CiteRefEntry A citation of a reference entry. It must have a RefEntryTitle, followed by an optional ManVolNum. It has common attributes. CiteSect Dropped. See CiteTitle. City Part of Address. It contains plain text. Classname The name of the class to which a program component belongs. It contains plain text and has common attributes. CmdSynopsis Synopsis for a Command. A CmdSynopsis contains any number of Args and Groups, in any order, followed by a single required Command, another set of any number of Args and Groups, in any order, and ending with any number of optional SynopFragments. CmdSynopsis has common, Label, and Sepchar attributes. Label has no default; Sepchar has the default “ ”. The following is courtesy Eve Maler (see also the entries for the subelements elsewhere in this list: An argument at the command level (Arg) is a parameter passed to a command to specify or modify the command's behavior; it often consists of a variable value (Replaceable) such as a filename field, or an option (Option) and its own nested argument (Arg). If the contents of an argument are not marked up further, they are assumed to be something the user must type as shown (probably an option, but this is implicit). The Choice attribute on the two argument elements indicates whether the argument must be present (“Req”, the default), whether it is optional (“Opt”), or whether no indication of presence is given (“Plain”, the default). A group (Group) as a peer or child of an argument is a collection of arguments, options, or other constructs that must appear in some relation to each other. For example, three options that are exclusive of each other and are optional would be in a group with a choice of “Opt” (the default). The “Optmult” choice allows zero or more of the children of the group to be supplied, and the “Reqmult” choice requires one or more of the children of the group to be supplied. An option (Option) is a literal string or name of a parameter-keyword controlling the behavior of the command; a variable value (Replaceable) is a mnemonic name for a value that the user must supply, such as an input file name. The Option and Replaceable elements are available in text as well as in synopses. Stacks of options (for example, “-aefstuv”) should be put into a single Option element for simplicity. Depressingly complex constructs may appear anywhere within a synopsis. A SynopFragment reference (SynopFragmentRef) is a special kind of variable value assigned in place of this construct, which is then broken out into its own synopsis subset (SynopFragment) for clarity. A SynopFragment must have an ID, and any SynopFragmentRefs supplied must point to some SynopFragment. Plain text within a CmdSynopsis is allowed only inside Cmd, Arg, Option, Replaceable, and SynopFragmentRef. The top-level separator character attribute value (“ ” by default) should be used to separate arguments and groups from their repeat indicators (“. . .”) and to separate Commands and their arguments and groups at the top level. The CmdSynopsis structure does not meet the needs of DCL and other VMS-related command languages that have command parameters such as /[NO]WRITE, positional versus nonpositional parameters, and so on. Probably additional low-level elements would have to be added to the mix and the top-level structure enhanced slightly to account for these. However, CmdSynopsis appears to meet most UNIX-related needs. Processing expectations: The “Opt” settings on arguments and groups (and probably “Optmult” as well for now) should produce square brackets. The “Req” settings (and probably “Reqmult” as well for now) should produce curly braces. The children of Group (if there is more than one child) should be either separated by vertical bars or formatted as a stacked list. Spacing at the Command and Group levels is controlled by formatter defaults and/or the sepchar setting. Example command synopsis in typical UNIX(tm) format: rm [-f] [-r] [-i] [-] {filename|dirname} . . . | | | | | | | | | | optional args | | | repeat indicator | (contain options)| | | | | | second child of group command name | | | first child of group | required repeatable group SGML source for this example: CMDSYNOPSIS COMMANDrm/COMMAND ARG Choice=“opt”-f/ARG (OPTION not required for arg contents ARG Choice=“opt”-r/ARG unless doing extra-special processing) ARG Choice=“opt”-i/ARG ARG Choice=“opt”-/ARG (various synopsis formats GROUP Choice=“req” Rep=“repeat” can be generated) REPLACEABLEfilename/REPLACEABLE REPLACEABLEdirname/REPLACEABLE /GROUP /CMDSYNOPSIS Collab A collaborative group of authors. It contains a required CollabName followed by any number of Affiliations. CollabName Name of a collaborative group of authors. It contains plain text. ColSpec Column specifier, that is, formatting information for a column in a Table, part of TGroup, THead, or TGroup. ColSpec is an empty element, bearing common and Align, Char, Charoff, Colname, Colnum, Colsep, Colwidth, and Rowsep attributes. The default values come from the TGroup, THead, or TFoot that starts the current enclosing group. Each ColSpec is for a single column, so it properly has a column number, Colnum, implicitly in order starting from 1, and an optional Colname by which it is known when used in any SpanSpec or in Entry. A ColSpec set on THead or TFoot should be complete for all columns. It overrides those on the containing TGroup and applies to just the THead or TFoot. If there is no ColSpec used within THead or TFoot, then the ColSpec of the containing TGroup (or the prior TGroup) is used. ColSpecs from the containing TGroup apply to TBody. For TGroupStyle, see TGroup. Align controls the horizontal position of text within the column. The value of Align may be Left (quad flush left), Center (centered), Right (quad flush right), Justify (both quad left and right), or Char (align to the left of Char, positioned by Charoff). There is no default. Char contributes to Align. If the value of Align is “char”, the value of Char should be a character on the first occurrance of which the entry is to be aligned. If that character does not occur in the entry, the entry is aligned to the left of the position determined by Charoff. (Think of using the decimal point to align decimal numbers: Char=“. ”and Charoff says how far over in the column the decimals should be; if no decimal occurs, the number is an integer and is aligned to the left of the decimals.) No value implies there is no character to align on. The default is implied, from the enclosing TGroup. (That is, you normally declare that an entire TGroup shall be decimal-aligned, but if you need to align a specific column differently, you can do it by specifying another Char at the ColSpec level.) Charoff contributes with Char to Align. Charoff is the proportion of the current column width, expressed in percentage, to be allowed before the left edge of the first occurrence of the character given as the value of Char. The default is inherited from the enclosing TGroup. That is, if columns in a TGroup are to be decimal-aligned, and the decimal point is to fall three-quarters of the way across each cell (most of your numbers are of the form 123.4), you could set Charoff to 75 in TGroup; that value would be inherited by ColSpec, where you could modify it for a specific column (for example, by setting it to 50 for a column of numbers of the form 12.34). Colname gives the name of the column, which is used to specify the position in a row, or the start or end of a horizontal span of columns (SpanSpec). There is no default. Colnum gives the number of the column, counting from 1 at left of the table. There is no default. Colsep determines column separators. If its value is Yes, display the internal column rulings to the right of each item; if No, do not display it. It is ignored for the last column, where the Frame setting applies. There is no default. The value is inherited from TGroupStyle if used. Colwidth is either a proportional measure of the form number*, such as “5*” for 5 times the proportion, or “*” (=“1*”); or a fixed measure, such as 2pt for 2 points, 3pc for 3 picas; or a mixed measure, such as 2*+3pt. Coefficients are positive numbers with up to two decimal places. There is no default. If no value is given, the value should be obtained from the FOSI, or, if there is no FOSI value, the value 1 should be used. (Perhaps this means that you can vary the width of columns by stating their relative proportions, or you can give fixed widths. If you use a decimal number less than zero, express it in the form 0.2, not .2.) Rowsep determines row separators. If its content is Yes, display the internal vertical row ruling below each item; if No, do not display it. It is ignored for the last row of the table, where the value of Frame applies to the entire Table. There is no default. The value is inherited from TGroupStyle, if used. Command An executable program, or the entry a user makes to execute a command. It may contain members of cptrphrase.gp, and has common and MoreInfo attributes. For the MoreInfo attribute see Application. Comment A remark made within the document file that is intended for use during interim stages of production. A Comment should not be displayed to the reader of the finished, published work. It may appear almost anywhere, and may contain almost anything below the Section level. Note that, unlike an SGML comment, unless you take steps to suppress it, the Comment element will be output by an SGML parser or application. You may wish to do this to display Comments along with text during the editorial process. ComputerOutput Data presented to the user by a computer. It may contain elements from cptrphrase.gp, and has common and MoreInfo attributes For the MoreInfo attribute see Application. ConfGroup A wrapper for information about a conference. It contains any number of ConfDates, ConfTitles, ConfNums, Addresses, and ConfSponsors, in any order. ConfNum The number of a conference. It contains plain text. ConfSponsor Sponsor of a conference in connection with which a document was written. It contains plain text. ConfDates Dates of a conference in connection with which a document was written. It contains plain text (e.g., 21-24 May 1927). ConfTitle Title of a conference in connection with which a document was written. It contains plain text. Constant Dropped. See SystemItem. ContractNum Number of a contract under which a document was written. It contains plain text. ContractSponsor Sponsor of a contract under which a document was written. It contains plain text. Copyright Copyright information about a document. It consists of one or more Years followed by any number of Holders. CorpAuthor Corporate author of a book, for use in BookInfo or BiblioEntry. It contains plain text and has common attributes. CorpName Name of a corporation. It contains plain text. Country Part of Address. It contains plain text. Data Optional component of FuncParam and ParamDef. It wraps plain text, Replaceable, more Data, Emphasis, and may contain links and indexing information. It has common attributes. Date Date of publication or revision. It contains plain text. (No provision has been made for representing eras; you could include this information along with the date data.) Database An organized set of data. It may contain members of cptrphrase.gp, and has common, Class, and MoreInfo attributes. Class may have the value Name, Table, Field, Key1, Key2, or Record (no default). For the MoreInfo attribute see Application. DbField Dropped. See Database. DbName Dropped. See Database. DbRecord Dropped. See Database. DbTable Dropped. See Database. DocBook Dropped. Use the book component's name (e.g., Chapter) as the Doctype, or construct a shell Book in which you can insert individual book components as entities. DocInfo Metainformation for a book component, in which it may appear. Only Title and AuthorGroup are required. DocInfo may contain, in order: the required Title, optional TitleAbbrev and Subtitle, followed by one or more AuthorGroups, any number of Abstracts, an optional RevHistory, and any number of LegalNotices. DocInfo has common attributes. Edition The edition of a document. It contains plain text. Editor The editor of a document. Contents are the same as for Author. Email Part of Address. It contains plain text. Emphasis Provided for use where you would traditionally use italics or bold type to emphasize a word or phrase. It contains plain text and has common attributes. Entry A euphemism for a cell in a table—you'd rather be in an Entry than in a Cell, wouldn't you? An Entry occurs in a Row, and must have either some assortment of paragraphs, admonitions, lists, and Graphics, or in-line elements. Entry has common and Align, Char, Charoff, Colname, Colsep, Morerows, Nameend, Namest, Rotate, Rowsep, Spanname, and VAlign attributes. Attribute values may be inherited from enclosing elements that share the same attribute. “An Entry not specified by a SpanSpec gets its defaults from its starting column.” Align controls the horizontal position of text within the column. The value of Align may be Left (quad flush left), Center (centered), Right (quad flush right), Justify (both quad left and right), or Char (align on leftmost of Char, positioned by Charoff). There is no default; the value may be inherited from ColSpec or SpanSpec. Char contributes to Align. If the value of Align is “char”, the value of Char should be a character on the first occurrance of which the entry is to be aligned. If that character does not occur in the entry, the entry is aligned to the left (the original doc incorrectly specifies “right”) of the position determined by Charoff. The default is inherited; no value implies there is no character to align on. Charoff contributes with Char to Align. Charoff is the proportion of the current column width, expressed in percentage, to be allowed before the left edge of the first occurrence of the character given as the value of Char, if any. The default is inherited from ColSpec or SpanSpec. Colname gives the name of the column, which is used to specify the position in a row, or the start or end of a horizontal span of columns (SpanSpec). There is no default; omit if SpanName is present. The implied value is either the first column of the Row, or, if already in a Row, the next column after the end of the prior Entry or EntryTbl. Colsep determines column separators. If its value is Yes, display the internal column rulings to the right of each Entry; if No, do not display it. It is ignored for the last column, where the Frame setting applies. (In CALS, Yes is expressed as 1 and No as 0.) There is no default; if no value is given the value is inherited from ColSpec or SpanSpec. Morerows is the number of additional rows in a vertical straddle. The default is 0. Nameend is the name of the rightmost column of a span. Names are identified in the ColSpec of the current TGroup. There is no default. Namest or Name Start, is the name of the leftmost column of a span. Names are identified in the ColSpec of the current TGroup. Rotate governs rotations, which are not additive to those specified in the FOSI. Values may be Yes or No (1 or 0). No specifies no rotation; Yes specifies 90 degrees rotation counterclockwise to table orientation. No other values are supported! Rowsep determines row separators. If its content is Yes, display the internal vertical row ruling below each item; if No, do not display it. It is ignored for the last row of the table, where the frame value applies. There is no default. The value is inherited from Row, if used there. Spanname is the name of a horizontal span. No default. VAlign governs the vertical positioning of text within an Entry. Allowed values are Top, Middle, and Bottom (no default). EntryTbl A form of subtable. It may occur in Row, along with Entry. Several EntryTbls of differing formats may occur in the same Row of a TBody, but EntryTbl may not contain itself. Aside from that restriction, EntryTbl contains one or more sets of these elements, in order: any number of ColSpecs, any number of SpanSpecs, an optional THead, and a required TBody. There is no implication of alignment of subrows in different EntryTbls. Default attribute values come instead from those of like-named attributes on enclosing elements: Table, TGroup, ColSpec, SpanSpec, THead, TFoot, TBody, or Row. EntryTbl has common, Align, Char, Charoff, ColName, Cols, Colsep, Nameend, Namest, Rowsep, Spanname, and TGroupStyle attributes. Align controls the horizontal position of text within the column. The value of Align may be Left (quad flush left), Center (centered), Right (quad flush right), Justify (both quad left and right), or Char (align to the left of Char, positioned by Charoff). There is no default; the value may be inherited from ColSpec or SpanSpec. Char contributes to Align. If the value of Align is “char”, the value of Char should be a character on the first occurrance of which the entry is to be aligned. If that character does not occur in the entry, the entry is aligned to the left (the original doc incorrectly specifies “right”) of the position determined by Charoff. There is no default. Charoff contributes with Char to Align. Charoff is the proportion of the current column width, expressed in percentage, to be allowed before the left edge of the first occurrence of the character given as the value of Char, if any. The default is inherited from the enclosing TGroup. Colname gives the name of the leftmost column of EntryTbl. There is no default. Cols is the number of columns in the EntryTbl. There is no default. Colsep determines column separators. If its value is Yes, display the internal column rulings to the right of the EntryTbl, except if the EntryTbl falls in the the last column, where the siderule (sic) setting applies; if No, do not display it. There is no default. The value is inherited from the enclosing TGroup. Nameend is the name of the rightmost column of a span. Names are identified in the ColSpec of the current TGroup. There is no default. Namest or Name Start, is the name of the leftmost column of a span. Names are identified in the ColSpec of the current TGroup. There is no default. Rowsep determines row separators. If its content is Yes, display the internal vertical row ruling below the EntryTbl; if No, do not display it. It is ignored for the last row of the table, where the frame value applies. There is no default. The value is inherited from the enclosing TGroup. Spanname is the name of a horizontal span. TGroupStyle is the name of a table group style defined in the FOSI. There is no default. Epigraph A brief section of poetry or prose at the start of a chapter. It contains paragraphs and has common attributes. Equation A titled mathematical equation displayed on a line by itself, rather than in-line. It has an optional Title and TitleAbbrev, followed by either an InformalEquation or a Graphic (see Graphic). Equation has common and Label attributes. ErrorName An error message reported by a computer. It contains plain text and has common attributes. ErrorType A classification of an error message reported by a computer. It contains plain text and has common attributes. EventStructure The code that defines an Event. It contains plain text and has common attributes. EventType A classification of an event. It contains plain text and has common attributes. Example Intended for sections of program source code that are provided as examples in the text. It contains a required Title and an optional TitleAbbrev, followed by one or more block-oriented elements in any combination. It has common and Label attributes. A simple Example might contain a Title and a ProgramListing. ExternalLink Dropped. Fax Part of Address. It contains plain text. Figure An illustration. It must have a Title, and may have a TitleAbbrev, followed by one or more of BlockQuote, InformalEquation, Graphic, InformalTable, Link, LiteralLayout, OLink, ProgramListing, Screen, Synopsis, and ULink, in any order. Figure has common, Label, and Float attributes; Float indicates whether the Figure is supposed to be rendered where convenient (yes) or at the place it occurs in the text (no, the default). To reference an external file containing graphical content use the Graphic element within Figure. Filename The name of a file, including pathname if this information is present. It may contain members of cptrphrase.gp, and has common and MoreInfo attributes. For the MoreInfo attribute see Application. FirstName (Western-style) given name of Author, Editor, or OtherCredit. It contains plain text. FirstTerm First occurrence of a word in a given context. It contains plain text and has common attributes. Font A collection of Glyphs (see Glyph). It contains plain text and has common attributes. Footnote The contents of a footnote, when the note occurs outside the block-oriented element in which the FootnoteRef occurs. (Compare InlineNote.) The point in the text where the mark for a specific footnote goes is indicated by FootnoteRef. Footnote may contain Para, SimPara, BlockQuote, InformalEquation, InformalTable, Graphic, Synopsis, LiteralLayout, ProgramListing, Screen, and any kind of list. It has ID, Label, Lang, Remap, Role, and XRefLabel attributes; the ID attribute is required, as a FootnoteRef must point to it. FootnoteRef Identifies the location for a footnote mark. It may contain plain text, which is the mark to be displayed, or it may be empty, in which case the Mark attribute provides another way of indicating the contents of the mark (such as an asterisk,~*, a number, 84, or a dingbat specified by a name that is to be interpreted by the application). FootnoteRef has ID, Linkend, and Mark attributes. The Linkend attribute, which is required, has as its value the ID of the associated Footnote, and the Mark. ForeignPhrase Any word or words from a language other than that of the document which you want to mark off in some way. In English, inter alia and c'est la vie are ForeignPhrases. It contains plain text and has common attributes. FormalPara A paragraph with a Title. FormalPara contains a required Title followed by a required Para, and has common attributes. FuncDef Part of a FuncSynopsis. Like Paramdef, it provides data type information and the name of the Function (or Parameter, in the case of ParamDef) this information applies to. A FuncDef may contain any combination of plain text, Replaceable, Data, or Function, in any order. It has common attributes. Separating this information from the rest of the synopsis avoids messing with data type information that appears before or after the item it applies to, such as array information (“[]”). It also avoids the issue of placing the pointer (“*”) indicator (next to the rest of the left-hand data type or next to the Parameter or Function name?). Any spaces that surround the Parameter or Function must be inserted by the writer. FuncParams Optional component of ParamDef. It supplies “inner parameters” for Paramters that are pointers to Functions. FuncParams contains elements from ctprphrase.gp and has common attributes. FuncSynopsis (contributed Eve Maler, along with remarks on its subelements.) A C synopsis that shows a prototype or definition indicating a function's name. A FuncSynopsis also indicates the data type of its return value, and the positions, purposes, and data types of its parameters. A FuncSynopsis begins with an optional FuncSynopsisInfo, which contains additional information about the synopsis that follows; line breaks and leading white space are significant within a FuncSynopsisInfo. This is followed by one or more blocks defining a function (you might use more than one for connecting related sets of functions). Each of these blocks consists of a required FuncDef, followed by a Void, a VarArgs, or one or more ParamDefs. Void, Varargs, and and ParamDef are mutually exclusive. Usage Note: You should supply no specific information on the arguments before the ellipsis that VarArgs should output when rendered, but if it is necessary to represent the ellipsis in the source it may ben enclosed within a final ParamDef. FuncSynopsis has common and Label attributes. The processing application is expected to provide all parentheses, semicolons, and the like. The exceptions are any spaces surrounding function and parameter names, any parentheses or commas or spacing inside lists of data types of parameters that are pointers to functions, and the parentheses around those parameter names themselves. These exceptions are a bit confusing in the unusual case (pointers to functions), but they greatly simplify tagging and still allow either K&R style or ANSI C style to be produced (assuming writers have cooperated in supplying enough information for ANSI). FuncSynopsisInfo Information supplementing the FuncDefs of a FuncSynopsis. It contains elements of ctprphrase.gp, and within it line breaks and leading white space are significant. See FuncSynopsis. It has common attributes. Function A subroutine in a program or external library. It may contain members of cptrphrase.gp, and has common and MoreInfo attributes. For the MoreInfo attribute see Application. FunctionParam Dropped. See Parameter. Glossary A glossary of terms. Glossary may occur within a Chapter, Appendix, or Preface, or may be a book component in its own right. It contains in order an optional DocInfo, optional Title, and optional TitleAbbrev, followed by any number of block-oriented elements, followed by one or more GlossEntries or one or more GlossDivs. It has common attributes. GlossDef The definition attached to a GlossTerm in a GlossEntry. It may contain Comments, GlossSeeAlsos, paragraphs, and other block-oriented elements, in any order; it has common and Subject attributes. The Subject attribute may hold a list of subject areas (e.g., DCE RPC General) as keywords. GlossDiv A division of a Glossary. It may have a Title and TitleAbbrev, followed by block-oriented elements, followed by one or more GlossEntries. It has common attributes. GlossEntry An entry in a Glossary. It contains, in order, a required GlossTerm, an optional Acronym, an optional Abbrev, and any number of GlossSees and GlossDefs, in any order. It has common attributes. GlossSee A cross-reference from one GlossEntry to another. It may contain plain text or no content, and has common and OtherTerm attributes. OtherTerm is a reference to the GlossTerm within the cross-referenced GlossEntry; that GlossTerm should be displayed at the point of the GlossSee. GlossSeeAlso A cross-reference from one GlossDef to another GlossEntry. It may contain plain text or no content, and has common and OtherTerm attributes. OtherTerm is a reference to the GlossTerm within the cross-referenced GlossEntry; that GlossTerm should be displayed at the point of the GlossSee. GlossTerm A term in the text of a Chapter (for example) that is glossed in a Glossary; also used for those terms in GlossEntries, in the Glossary itself. As you may not want to tag all occurrences of these words outside of Glossaries, you might consider GlossTerm, when used outside of Glossaries, to be similar to FirstTerm, except that GlossTerm may contain other in-line elements. GlossTerm contains in-line elements and has common attributes. Glyph A mark, a component of a font. A character or ligature might be made up of one, two, or more Glyphs. Cf. Character. It contains plain text and has common attributes. Graphic Encloses graphical data or points via an attribute to an external file containing such data, and is to be rendered as an object, not in-line. It has Format, Fileref, Entityref, and ID attributes. The format attribute may have the value of any of the formats defined at the head of the DTD, including CGM-CHAR, CGM-CLEAR, DITROFF, DVI, EPS, EQN, FAX, FAXTILE, GIF, IGES, PIC, PS, TBL, TEX, TIFF. The value of Fileref should be a filename, qualified by a pathname if desired; the value of Entityref should be that of an external data entity. If data is given as the content of Graphic, both Entityref and Fileref, if present at all, should be ignored, but a Format value should be supplied. if no data is given as the content of Graphic and a value for Entityref is given, Fileref, if present, should be ignored but no Format value should be supplied. Finally, if there is no content for Graphic and Entityref is absent or null, Fileref must be given the appropriate value, and again no Format value should be supplied. Group A group of constituent parts of a CmdSynopsis. A Group consists of one or more Args, Groups, SynopFragmentrefs, and Replaceables, in any order. See CmdSynopsis. Group has common, grpchcatt, and repatt attributes. argchcatt or “argument choice attribute” resolves to the attribute Choice, with allowed values Opt (the Arg is optional; the default), Req (it is required), and Plain (neither optional nor required). repatt or “repetition attribute” resolves to the attribute Rep, with allowed values Norepeat (the Arg may be repeated; the default) and Repeat (the Arg does not repeat). grpchcatt or “group choice attribute” is a parameter entity that resolves to the the Choice attribute for the element Group. The allowed values are Opt (the Arg is optional; the default), Req (it is required), Plain (neither optional nor required), OptMult (optional and repeatable), and ReqMult (required multiple times). Hardware A physical part of a computer system. It may contain members of cptrphrase.gp, and has common and MoreInfo attributes. For the MoreInfo attribute see Application. Highlights A list of main points discussed in a book component such as a Chapter. It may contain paragraphs, lists, and admonitions, and has common attributes. Holder Part of Copyright; the holder of the copyright of the document. It contains plain text. Honorific A person's title, to be used as part of Author, Editor, or OtherCredit. It contains plain text. HWapplic Dropped. See Application. Icon Dropped. See Interface. Important An admonition set off from the text. See Caution. Index An index to a Chapter, Appendix, Preface, or Book. It contains an optional DocInfo, Title, and TitleAbbrev, followed by any number of block-oriented elements, and then one or more IndexEntries or one or more IndexDivs. It has common attributes. IndexAs Dropped. IndexDiv A division of an Index. It may have a Title and TitleAbbrev, some optional introductory matter (block-oriented elements, Anchors, Comments), and must then contain one or more IndexEntries or a SegmentedList (use a SegmentedList for a permuted index). It has common attributes. IndexEntry Part of Index. It contains a PrimaryIE, which may be accompanied by SecondaryIE, TertiaryIE, SeeIE, and SeeAlsoIE. It has common attributes. IndexTerm A character string to be indexed, occurring in the text flow but not in the text itself. (And remember, IndexTerm appears in the text, not in the Index!) Primary, Secondary, and Tertiary index items are nested within this tag, as are See and SeeAlso items. It has common, SpanEnd, PageNum, and Significance attributes. The SpanEnd attribute may not be used if IndexTerm has content; it should be used only to mark the end of a span of text that begins earlier at an IndexTerm that does have content. The value of SpanEnd must be the ID of that earlier IndexTerm. The PageNum attribute may be used to indicate the page on which the indexed term is found in print. Significance may have the value Preferred, indicating that the entry is the most pertinent of the series, or Normal (the default). InformalEquation An untitled mathematical equation displayed on a line by itself, rather than in-line. It contains a Graphic, and has common attributes. InformalTable An array of text that has no Title. Otherwise, it is just like Table except that it lacks the ShortEntry and ToCEntry attributes. See Table. InlineEquation An untitled mathematical equation occurring in-line or as the content of an Equation. It contains a Graphic, and has common attributes. InlineFootnote The contents of a footnote, when the note occurs within the block-oriented element in which the FootnoteRef occurs. (Compare Footnote.) The point in the text where the mark for a specific footnote goes is indicated by FootnoteRef. InlineFootnote, like Footnote, may contain paragraphs, BlockQuote, InformalEquation, InformalTable, Graphic, Synopsis, LiteralLayout, ProgramListing, Screen, and any kind of list. It has ID, Label, Lang, Remap, Role, and XRefLabel attributes; the ID attribute is required, as a FootnoteRef must point to it. InlineGraphic Encloses graphical data or points via an attribute to an external file containing such data, and is to be rendered in-line. InlineGraphic has Format, Fileref, Entityref, and ID attributes. The format attribute may have the value of any of the formats defined at the head of the DTD, under “Notations.” 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 name may be supplied as the value of the Entityref attribute. InlineNote The contents of a footnote, when the note occurs within the block-oriented element in which the FootnoteRef occurs. For usage and attributes see Footnote. Interface Any part of a graphical user interface. It may contain members of cptrphrase.gp, and has common, Class, and MoreInfo attributes. Class may have the value Button, Icon, Menu, or MenuItem (no default). For the MoreInfo attribute see Application. InterfaceDefinition A specification for a graphical user interface. It may contain members of cptrphrase.gp, and has common and MoreInfo attributes. For the MoreInfo attribute see Application. InvPartNumber An inventory part number. It contains plain text. ISBN International Standard Book Number of a document. It contains plain text. ISSN International Standard Serial Number of a journal. It contains plain text. IssueNum The number of an issue of a journal. It contains plain text. ItemizedList 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 paragraphs and other block-oriented elements, which may in turn contain other lists; an ItemizedList may be nested within other lists, too. It 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; there is no fixed list of these. Usage Note: You might want to use one of the ISO text entities that designates an appropriate dingbat. JobTitle Part of Affiliation. It contains plain text. JournalInfo Information about the journal in which an Article appears, in that Article's ArtHeader. It contains, in order, a required Title, optional TitleAbbrev, Subtitle, ISSN, VolumeNum, IssueNum, PageNums, PubDate, Publisher, and Copyright. KeyCap The text printed on a physical key on a computer keyboard, not necessarily the same thing as a KeyCode. It may contain members of cptrphrase.gp, and has common and MoreInfo attributes. For the MoreInfo attribute see Application. Keycode The computer's numeric designation of a key on a computer keyboard. Keycode contains plain text and has common attributes. Keysym A key symbol name, which is not necessarily the same thing as a Keycap. For example, the Keysym for the H key (Keycap H) might be h. It contains plain text, and has common attributes. LegalNotice An acknowledgement of trademarks, etc. It may have a Title, followed by paragraphs, and BlockQuotes in any order. Lineage Part of an author's name, such as “Jr.” It contains plain text. LineAnnotation A writer's or editor's comment on a line of program code within an Example, ProgramListing, or Screen. LineAnnotations are a document author's comments on the code, not the comments written into the code itself by the code's author. Link A hypertext link. At present, all the link types represented in the DTD are provisional. Link is less provisional than the others, however. In HyTime parlance, Link is a clink. 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, in which case the Endterm attribute is to be ignored (new and tentative rule for this version, comments invited). ListItem A wrapper for the elements of items in an ItemizedList or OrderedList; it also occurs within VarListEntry in VariableList. It may contain just about anything except Sects and book components. It has common attributes and an Override attribute, which may have any of the values of ItemizedList's Mark attribute; use Override to override the mark set at the ItemizedList level, when you desire to create ItemizedLists with varying marks. Literal 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. It may contain members of cptrphrase.gp, and has common and MoreInfo attributes. For the MoreInfo attribute see Application. LiteralLayout 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. It contains in-line elements, and has common and Width attributes, for specifying a number representing the maximum width of the contents. LoT 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, in order, an optional DocInfo, Title, and TitleAbbrev, followed by one or more LoTentries. It has common and Label attributes; in this case the values of Label may be Equation, Examples, Figures, or Tables, with no default. LoTentry An element of LoT. It contains the text of the thing to be listed, including, if desired, in-line elements. It has common and PageNum attributes. Macro Dropped. See SystemItem. ManVolNum Specific to UNIX man pages, it 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. Markup A string of formatting markup in text, which it is desired to represent literally. See also SGMLTag. It contains plain text and has common attributes. Mask Values in a specified structure that should be read when updating resource values. Mask contains plain text and has common attributes. MediaLabel The physical medium on or in which some information is contained. MediaLabel may contain plain text, and has common, Class, and MoreInfo attributes. Class may have the value Cartridge, CDRom, Disk, or Tape (no default). For the MoreInfo attribute see Application. Member Part of a SimpleList. It contains in-line elements and has common attributes. Menu Dropped. See Interface. MenuItem Dropped. See Interface. ModeSpec Contains application-specific information necessary for the completion of an OLink; see OLink. Msg The part of a MsgEntry that contains the error message and its subparts, along with explanatory text. A Msg has a required MsgMain, followed by any number of MsgSubs and MsgRels, in any order. It has common and Label attributes. MsgAud Describes the audience to which a Msg is relevant. It contains plain text only, and has common attributes. MsgEntry A wrapper for an entry in a MsgSet. A MsgEntry must contain one or more Msgs, followed by an optional MsgInfo, then any number of MsgExplans. MsgEntry has common attributes. MsgExplan Holder for any kind of explanatory material relating to the Msg. MsgExplan begins with an optional Title (typically something such as “Explanation:” or “Action:”) and may contain block-oriented elements. It has common attributes. MsgInfo Information about the Msg containing it. It may have any number of MsgLevels, MsgOrigs, and MsgAuds, in any order, and has common attributes. MsgLevel The level of importance or severity of a Msg. It contains only plain text, and has common attributes. MsgMain The main error message of a Msg. MsgMain begins with an optional Title and contains MsgText, which is the text of the message. It has common attributes. MsgOrig The origin of a Msg. It contains only plain text and has common attributes. MsgRel An optional subpart of a Msg, containing a message that is related to the main message (MsgMain) but which appears in a different place. For example, MsgMain might be a message that appears on a network client, and MsgRel a related message that appears at the server console in response to the same condition or event. MsgRel begins with an optional Title and contains MsgText. It has common attributes. MsgSet A list of error messages produced by a system, with various additional information. MsgSet contains one or more MsgEntries, and has common attributes. Usage Note: The entire Msg* construction is new and complicated; it may be simplified in the future. MsgSub An optional subpart of a Msg, which might contain messages that appear in various contexts. It contains a an optional Title followed by MsgText. MsgSub has common attributes. MsgText Contents of the parts of Msg. It may contain block-oriented elements, and has common attributes. Note A message to the user, set off from the text. See Caution. OLink A link that may perform some operation to find its target. In contrast to Link, OLink has no Linkend attribute, but rather a TargetDocEnt, the value of which is the name of a text or data entity already defined by the user. The LinkMode attribute points by ID to a ModeSpec; for convenience, ModeSpecs located in the BookInfo. ModeSpec contains instructions (probably application-specific) for operating on the entity named by TargetDocEnt, e.g., the TargetDocEnt is another Book, and the ModeSpec specifies that all the second-level headings should be searched for a phrase. The LocalInfo attribute may be used to hold such a phrase, which may be thought of as a replacement for some variable in ModeSpec. Finally, OLink has a Type attribute, also. Option An option for a computer program command. It may have members of cptrphrase.gp, and has common attributes. Optional 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 elements from cptrphrase.gp, and has common attributes. OrderedList A numbered or lettered list, consisting of ListItems. A ListItem in an OrderedList contains paragraphs and other block-oriented elements, 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. If no value is supplied, the processing expectation should be that Arabic numbering (1, 2, 3, . . .) is to be used. It has an InheritNum attribute, for which the value Inherit specifies for a nested list that the numbering of ListItems should include the number of the item within which they are nested (2a, 2b, etc., rather than a, b, etc.); the default value is Ignore. It has a Continuation attribute, with values Continues or Restarts (the default), which may be used to indicate whether the numbering of a list begins afresh (default) or continues that of the immediately preceding list (Continues). You need supply the Continuation attribute only if your list continues the numbering of the preceding list. OrgName An organization that is not a corporation (cf. CorpName) It contains plain text. OrgDiv Part of an organization. It contains plain text. OSname Dropped. See SystemItem. OtherCredit Supplements Author and Editor; you could use it to credit a contributor, a contributing editor, or some deserving production person. Contents are as for Author. It has common attributes. OtherName An alternative to Firstname and Surname, for use in Author, Editor, or OtherCredit. It contains plain text. PageNums The numbers of the pages contained in a Book, for use in its BookBiblio. It contains plain text (e.g., ix, 292). Para A paragraph. A Para may not have a Title: to attach a Title to a Para use FormalPara. Para may contain any in-line element and almost any block-oriented element. Abstract, AuthorBlurb, Caution, Important, Note, and Warning are excluded, as are Sects and higher-level elements. Para has common attributes. Paragraphs See Para. ParamDef Part of a FuncSynopsis, providing data type information and the name of the Parameter this information applies to. A ParamDef may contain any combination of plain text, Replaceable, Data, or Parameter, in any order. It has common attributes. See FuncDef, FuncSynopsis. It has common attributes. Parameter Part of an instruction to a computer. It may contain members of cptrphrase.gp, and has common, Class, and MoreInfo attributes. Class may have the value Command, Function, or Option (no default). For the MoreInfo attribute see Application. Part A section of a Book containing book components. Part contains an optional DocInfo, a required Title, an optional TitleAbbrev, an optional PartIntro, followed by one or more book components. It has common and Label attributes. PartIntro Introduction to the contents of a Part; may also appear in Reference. It has optional Title and TitleAbbrev, and then may contain anything that can appear in a Chapter. PartIntro has common and Label attributes. Phone Part of Address. It contains plain text. POB Part of Address. It contains plain text. Postcode Part of Address. It contains plain text. Preface Any introductory matter in a Book. Preface may occur more than once in Book, before any Chapter, Part, or Reference: for example, you might have two Prefaces, one titled “Preface” and the other “Introduction.” Preface may begin with a DocInfo, followed by a required Title, optional TitleAbbrev, and anything found in the body of a Chapter. Preface has common attributes. Primary 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. It has SortAs and common attributes. SortAs can be used to provide an alternate string for alphabetizing the index: if Primary has the content “14” one might give Primary the attribute Sortas=“fourteen”. PrimaryIE A primary entry in an Index, not in the text. It may contain only plain text. It has common attributes and a Linkends attribute, which has the value of some list of element IDs. PrintHistory The printing history of a Book. It contains paragraphs. Procedure A list of operations to be performed. Procedure may have a Title and TitleAbbrev, followed by block-oriented elements, such as paragraphs, followed by one or more Steps. A Step may have a SubSteps wrapper for Steps nested within it, and this nesting may continue indefinitely (contrast the methods of nesting lists and Sects). This construction is intended to maximize the reusability of subsections of Procedures. Procedure has common attributes. ProductName Formal name for any product. It contains in-line elements, and has common and Class attributes. The Class attribute may have the values Service, Trade (the default), Registered, Copyright, or Logo. Thus a trademark is a Productname with the default Class attribute value. ProductNumber A number assigned to a product. It contains plain text. ProgramListing A listing of a program. Line breaks and leading white space are significant in a ProgramListing, which may contain in-line elements, including LineAnnotations. (LineAnnotations are a document author's comments on the code, not the comments written into the code itself by the code's author.) ProgramListing has common and Width attributes, the latter for specifying a number representing the maximum width of the contents. Prompt Dropped. See SystemItem. Property A defined set of data associated with a window. It may contain members of cptrphrase.gp, and has common and MoreInfo attributes. For the MoreInfo attribute see Application. ProtocolRequest Message sent from a program to a server. It may contain members of cptrphrase.gp, and has common and MoreInfo attributes. For the MoreInfo attribute see Application. PubDate The date of publication of a document. It contains plain text. Publisher The publisher of a document. It contains a PublisherName and any number of Addresses. PublisherName The name of a publisher of a document. It contains plain text. PubsNumber A number assigned to a publication, other than an ISBN or ISSN or InvPartNumber. It contains plain text and has common attributes. Quote An in-line quotation. For block quotes use BlockQuote. Quote may contain members of cptrphrase.gp, and has common attributes. RefClass An element of RefNameDiv, in which the applicability or scope of the topic of a RefEntry may be indicated. It may contain plain text or Application. RefDescriptor A substitute for RefName to be used when a RefEntry covers more than one topic and none of the topic names is to be used as the sort name. It contains plain text and has common attributes. RefEntry A reference page. It contains, in order, an optional DocInfo and optional RefMeta; any number of Comments and members of links.gp, in any order; a required RefNameDiv, an optional RefSynopsisDiv, and one or more RefSect1s. It has common attributes. Reference A collection of RefEntries, formin a book component. Reference has an optional DocInfo, a required Title, an optional TitleAbbrev, an optional PartIntro, and one or more RefEntries. It has common and Label attributes. RefEntryTitle Primary name given to a 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. It may contain in-line elements, and has common attributes. RefFileName Dropped. It is now called RefEntryTitle. RefMeta The first major division of a reference page, in which metainformation about the reference page is supplied. RefMeta contains, in order, a required RefEntryTitle, an optional ManVolNum, and any number of RefMiscInfos. It has common attributes. 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 contains plain text, and has common and Class attributes. The Class attribute can be used to distinguish categories of RefMiscInfos. RefName The subject or subjects of a reference page. It appears within RefNameDiv. It may contain plain text and in-line elements, and has common attributes. RefNameDiv The second major division of a reference page. It contains, in order, an optional RefDescriptor, one or more RefNames, a required RefPurpose, and an optional RefClass, followed by any number of Comments and links, in any order. It has common attributes. RefPurpose A short phrase describing the subject of the reference page. It may contain in-line elements and has common attributes. RefSect1 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 two levels of subsection are allowed, RefSect2 and RefSect3. It has common attributes. RefSect2 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 only RefSect3 is allowed as a further subsections. It has common attributes. RefSect3 Subdivision of RefSect2. No further subdivisions allowed; contents otherwise as for RefSect2. It has common attributes. RefSynopsisDiv The third major division of a reference page, in which the syntax of the subject of the reference page is indicated. It contains, in order, an optional Title and TitleAbbrev, followed by either one or more synopses (Synopsis, CmdSynopsis, or FuncSynopsis) succeeded by any number of RefSect2s, or simply one or more RefSect2s. It has common attributes. ReleaseInfo Information about a particular version of a document. It contains plain text. Replaceable Part of a synopsis or command line, indicating that its contents may be replaced. It may contain basic in-line elements (not cptrphrase.gp) and has common and Class attributes. Class may have the value Command, Function, Option, or Parameter (no default). Resource Dropped. See SystemItem. ReturnValue A value returned by a function. It contains plain text and has common attributes. RevHistory A section of BookInfo or DocInfo recording revisions to the document. It consists of any number of Revisions, and has common attributes. Revision An entry in RevHistory, describing some revision made to the text. It contains, in order, a required RevNumber, required Date, one or more sets of AuthorInitials, and a required RevRemark. RevNumber The number of a Revision. It contains plain text. RevRemark An element of Revision, describing the Revision. It contains plain text. Row A row in a TBody, THead, or TFoot. It contains one or more Entries or EntryTbls, in any order. It has common, Rowsep, and VAlign attributes. Rowsep determines Row separators. If its content is Yes, display the internal vertical row ruling below each Row; if No, do not display it. It is ignored for the last Row of the TGroup, THead, or TFoot, where the frame value applies. There is no default. The value is inherited from TGroupStyle, if used. Valign governs the vertical positioning of text within a Row. Allowed values are Top, Middle, and Bottom (no default). Screen Intended to represent what the user sees or might see on a computer screen. It consists of in-line elements, in which line breaks and leading white space are considered significant. It has common attributes and a Width attribute for specifying a number representing the maximum width of the contents. ScreenInfo Part of ScreenShot (see ScreenShot). 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. ScreenShot Like Screen, intended to represent what the user sees or might see on a computer screen. It consists of an optional ScreenInfo and a required Graphic. It has common attributes and a Width attribute for specifying a number representing the maximum width of the contents. Secondary 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. It may contain in-line elements, and has SortAs and common attributes. See Primary. SecondaryIE Part of IndexEntry, like PrimaryIE (see PrimaryIE). Sect1 A top-level section of a book component, including the Title of that section. Sect2–5 nest in order within Sect1. Anything may occur within a Sect1 except a DocInfo, Preface, Chapter, Appendix, or another Sect1, including a Glossary, Bibliography, RefEntry, ToC, Index, or LoT. A Sect must have a Title, which is the text of the heading itself, and may have a TitleAbbrev; it must include some content, whether paragraphs or other block-oriented elements, including a Sect2. Sect1–5 have common, Label, and Renderas attributes. The Renderas attribute may have the value Sect1 through Sect5, and may be used to specify that the Sect (particularly its heading) is to be presented in the format defined for a Sect of some other level. Sect2 A section beginning with a second-level heading; must be nested within a Sect1. Allowable and required contents for Sect2, and its attributes, are like those for Sect1. Sect3 See Sect1, Sect2. Sect4 See Sect1, Sect2. Sect5 See Sect1, Sect2. Sect5 may not contain Sects of any level, and no further subdivisions are supplied in the DocBook DTD. See 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. It may contain in-line elements, and has common attributes. SeeAlso Like See, but indicates the index entries to which the reader is also 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. It may contain in-line elements, and has common attributes. SeeAlsoIE 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. It has common attributes and a Linkends attribute, which has the value of some list of IndexEntry IDs. SeeIE 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. It has common attributes and a Linkend attribute, which has the value of some IndexEntry ID. Seg A component of a SegmentedList. Segs are the only content of a SegmentedList's SegListItems. Seg may contain in-line elements. It has common attributes. SegListItem A list item in a SegmentedList. It consists of two or more Segs, and has common attributes. SegmentedList A list of sets of units. It may be used to represent sets of information often presented as simple tables. SegmentedList may have a Title and TitleAbbrev, followed by any number of SegTitles, and one or more SegListItems. It has common attributes. SegTitle 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. It may contain in-line elements. SegTitles are grouped at the beginning of a SegmentedList, before the SegListItems. It has common attributes. Series Dropped. SeriesInfo Part of BookInfo or BiblioEntry, containing information about the publication series of which the book is a part. SeriesInfo contains, in order, a required Title, optional TitleAbbrev and Subtitle; any number of AuthorGroups, optional ISBN, VolumeNum, and IssueNum; a required SeriesVolNums, any number of PubDates and Publishers, and finally an optional Copyright. It has common attributes. SeriesVolNums The numbers of all the volumes in a Series, for use in SeriesInfo. It contains plain text (e.g., 1-5). Set Two or more Books. Set may have, in order, a Title, TitleAbbrev, SetInfo, and ToC, followed by the Books, followed by an optional SetIndex. Note that a SetIndex may appear in a Book, too. Set has common attributes. SetIndex Index to a Set. It may occur within a Set or one of the Books in a Set. It contains an optional DocInfo, Title, and TitleAbbrev, followed by any number of block-oriented elements and then one or more IndexEntries or one or more IndexDivs. It has common attributes. SetInfo Metainformation for a Set, in which it may appear. It may contain, in any order, any number of: Author, AuthorInitials, Copyright, CorpAuthor, CorpName, Date, Editor, Edition, InvPartNumber, ISBN, LegalNotice, OrgName, OtherCredit, PrintHistory, ProductName, ProductNumber, Publisher, PubsNumber, ReleaseInfo, RevHistory, Title, Subtitle, and VolumeNum. SetInfo has common attributes and a Contents attribute. Contents is partly a stub for future development; at the moment its values should be the IDs of the ToC, Books, and SetIndex that comprise the Set, in the order of their appearance. SGMLTag An element tag in SGML. This element contains plain text, and should not include delimiting angle brackets, ampersands, percent signs, or semicolons: those should be supplied by the renderer if appropriate. It has common and Class attributes. Class may be Attribute, Element, GenEntity, or ParamEntity; there is no default. ShortAffil Brief version of of Affiliation, in which it may appear. It contains plain text. Sidebar Segment of a book component that is isolated from the narrative flow of the main text, typically boxed and floating. Sidebar may have a Title and a TitleAbbrev, followed by paragraphs, lists, and other block-oriented elements. No Sects allowed. Sidebar has common attributes. SimPara A paragraph that is only a text block, without included block-oriented elements. It may contain InlineGraphic, InlineEquation, and synopses. SimPara has common attributes. SimpleList Intended for long lists of single words or short phrases. It consists of one or more Members, and has common, Columns, and Type attributes. The value of the Type attribute may be Inline, Horiz, or Vert (the default), indicating that the list should be formatted as part of a regular paragraph, as an array reading L to R then top to bottom, or as an array reading top to bottom then L to R. The Columns attribute value must be a number, the number of columns the array should contain. Further details on rendering may be found in the comment in the DTD, but these details may required some revision in the future. SpanSpec Formatting information for a spanned column in a TGroup (part of Table). SpanSpec is an empty element, bearing common, Align, Char, Charoff, Colsep, Nameend (required), Namest (required), Rowsep, and Spanname, (required) attributes. SpanSpec identifies a horizontal span of columns and associated attributes that can subsequently be referenced by its SpanName to provide attributes repeatedly used in the Entries or EntryTbls in the Rows of the TGroup that is nested within the THead, TFoot, or TBody in which the SpanSpec occurs. The reason Colname is used rather than Colnum in identifying SpanSpec is that the names are independent of revisions that may change the number of inserted/deleted columns, as long as Namest remains to the left of (has a smaller colnum than) Nameend. SpanSpecs set on THead or TFoot override those on the containing TGroup and apply to just the THead or TFoot. SpanSpecs from the containing TGroup apply to TBody. Align controls the horizontal position of text within the column. The value of Align may be Left (quad flush left), Center (centered), Right (quad flush right), Justify (both quad left and right), or Char (align to the left of Char, positioned by Charoff). The default is Center. Char contributes to Align. If the value of Align is “char”, the value of Char should be a character on the first occurrance of which the entry is to be aligned. If that character does not occur in the entry, the entry is aligned to the left of the position determined by Charoff. The default is inherited from the ColSpec of the column named by Namest. Charoff contributes with Char to Align. Charoff is the proportion of the current column width, expressed in percentage, to be allowed before the left edge of the first occurrence of the character given as the value of Char, if any. The default is inherited from the ColSpec of the column named by Namest. Colsep determines column separators. If its value is Yes, display the internal column rulings to the right of each item; if No, do not display it. It is ignored for the last column, where the Frame setting applies. (In CALS, Yes is expressed as 1 and No as 0.) The default is inherited from the ColSpec of the column named by Namest. Nameend is the name of the rightmost column of the span. Names are identified in the Colspec of the current TGroup. Namest or Name Start, is the name of the leftmost column of the span. Names are identified in the Colspec of the current TGroup. Rowsep determines Row separators. If its content is Yes, display the internal vertical Row ruling below each item; if No, do not display it. It is ignored for the last Row of the table, where the frame value applies. There is no default. The value is inherited from the ColSpec of the column named by Namest. Spanname is the name of the horizontal span. State Part of Address. It contains plain text. Step Part of a Procedure. After its optional Title, Step must consist either of block-oriented elements such as paragraphs followed optionally by a SubSteps element, or simply a SubSteps element. SubSteps then contains one or more Steps—it is a wrapper. Step has common attributes and a Performance attribute, which indicates whether the step must be performed: the values are Optional and Required (the default). Street Part of Address. It contains plain text. StructField A field in a Structure. It contains plain text and has common attributes. StructName The name of a Structure. It contains plain text and has common attributes. SubSteps A wrapper for Steps within Steps. See Procedure, Step. Note that SubSteps, like Step, has a Performance attribute, the values of which may be Optional or Required (the default). Subscript A subscript. It may contain basic in-line elements and Replaceable, and has common attributes. Subtitle Subtitle of a document. It contains plain text. Superscript A superscript. It may contain basic in-line elements and Replaceable, and has common attributes. Surname (Western-style) family name of an author. It contains plain text. SWapplic Dropped. See Application. Symbol A name that is replaced by a value before processing. It contains plain text and has common attributes. Synopsis The syntax of a command or function. It appears within RefSynopsisDiv, and may occur elsewhere in a document, too. Synopsis has an optional title, followed by one or more in-line elements and Graphics; within it, line breaks and white space are significant. It has common attributes. CmdSynopsis and FuncSynopsis are alternates to Synopsis, but they may not contain Graphics and within them line breaks and white space are not significant. Synopsis should be displayed as a block-oriented element, not in-line. SynopFragment Part of CmdSynopsis. It contains one or more Args or Groups, in any order, and has the attributes ID (the only required attribute), Lang, Remap, Role, and XRefLabel. SynopFragmentRef Part of a CmdSynopsis. It contains RCDATA (characters, in which entity references and character references are recognized in parsing) rather than elements. It has common and Linkend (required) attributes. Linkend should point to SynopFragment. SystemItem Any system-related item. It may contain members of cptrphrase.gp, and has common, Class, and MoreInfo attributes. Class may have the value Constant, EnvironVar, Macro, OSname, Prompt, Resource, or SystemName (no default). For the MoreInfo attribute see Application. SystemName Dropped. See SystemItem. Table An array of text. The Table models available in version 1.2.2 have been dropped in favor of a CALS-compliant Table model. The present Table element has a required Title, an optional TitleAbbrev, and either one or more Graphics or one or more TGroups. Tables may not contain either Tables or InformalTables. Table has common, Colsep, Frame, Label, Orient, Pgwide, Rowsep, Shortentry, Tabstyle, and Tocentry attributes. elements that may be contained within TGroup are specified as having omissible end tags, except for EntryTbl. Who said the military isn't thoughtful? Colsep determines column separators. If its value is Yes, display the internal column rulings to the right of each item; if No, do not display it. It is ignored for the last column, where the value of Frame applies. There is no default; the value may be inherited from Tabstyle in the FOSI. Frame describes the positioning of framing rules around the Table. The allowed values are Sides (left and right), Top (below title), Bottom (after last Row, possibly the last Row of TFoot), Topbot (both top and bottom), All (all of the aforementioned), and None. There is no default. The value may be inherited from Tabstyle in the FOSI. Label is just the same as DocBook's Label attribute: a reference string, such as a number, to be prefixed to the Title. Orient determines the orientation of the Table. The allowed values are Port (the orientation of the rest of the text of the Book, that is, upright) and Land (90 degrees counterclockwise from the orientation of the rest of the text of the Book). If you assume that the page is taller than it is wide, tables that take up a whole page and are wider than they are tall should be given the Land value. There is no default, the value may be inherited from the FOSI. Pgwide constrains the table to or liberates it from the boundaries of its column. If the value is Yes, the table runs across the entire page; if No, the table “runs across just the (galley) width of the current column of the page, regardless of the value of Orient. If the value is No, it has no meaning for the case when Orient is set to Land. The value may be inherited from Tabstyle in the FOSI, if available. Rowsep determines row separators. If its content is Yes, display the internal vertical row ruling below each item; if No, do not display it. It is ignored for the last row of the table, where the value of Frame applies. There is no default. The value may be inherited from TabStyle. Shortentry determines whether value of ShortEntry is be used in the an Index or ToC or LoT. If the value is No, the TitleAbbrev is not used; if Yes, the ShortEntry is used. Usage Note: Be aware that this mechanism duplicates the DocBook element TitleAbbrev. It would be better, for any given work, to choose one mechanism or the other, rather than mix them. Tabstyle is the name of a table style defined in the FOSI. There is no default. Tocentry determines whether the Table's Title should be included in an LoT. The value may be Yes (include) or No (exclude). The default is Yes (include). should be ignored if the optional Title is omitted; that would be the case if you were using Table, instead of InformalTable, for a Table that has no Title; presumably only a reference string could then appear in an LoT. Term 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 synopses. It has common attributes. Tertiary 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. It may contain in-line elements, and has SortAs and common attributes. See Primary. TertiaryIE Part of IndexEntry, like PrimaryIE see PrimaryIE). TBody Wrapper for the Rows of a Table or InformalTable. It contains simply one or more Rows, and has common and VAlign attributes. VAlign governs the vertical positioning of text within a Row. Allowed values are Top (the default), Middle, and Bottom. TFoot TFoot is a optional part of TGroup (part of Table), identifying the footer information in a Table, which is displayed after the TBody and also at the bottom of any TBody Rows before a page break. TFoot must have one or more Rows. It has common and VAlign attributes, the latter with the allowed values of Top (the default), Middle (approximately centered vertically), and Bottom. TGroup The part of a Table that is contains an array along with its formatting information. In order, a TGroup has any number of ColSpecs, any number of SpanSpecs, an optional THead, and optional TFoot, and a required TBody. Each TGroup effectively identifies a new portion of a Table. If a new ColSpec is provided, it replaces a previous one. If both ColSpec and SpanSpec are new, that SpanSpec should refer to columns in the most recent ColSpec. If only a new SpanSpec is provided, it should refer to columns defined by the most immediately prior ColSpecs in a TGroup of the Table. On the other hand, a new ColSpec to either a THead or TFoot replaces all prior column definitions. TGroup has common, Align, Char, Charoff, Cols, Colsep, Rowsep, and TGroupStyle attributes. Align controls the horizontal position of text within the column. The value of Align may be Left (quad flush left), Center (centered), Right (quad flush right), Justify (both quad left and right), or Char (align to the left of Char, positioned by Charoff). The default is Left, unless overridden by TGroupStyle. Char contributes to Align. If the value of Align is “char”, the value of Char should be a character on the first occurrance of which the entry is to be aligned. If that character does not occur in the entry, the entry is is aligned to the left (the original doc incorrectly specifies “right”) of that character. The default is “”, unless inherited from TGroupStyle. Charoff contributes with Char to Align. Charoff is the proportion of the current column width, expressed in percentage, to be allowed before the left edge of the first occurrence of the character given as the value of Char, if any. The default is 50 unless overridden by TGroupStyle. Cols is the number of columns in the table (required). Colsep determines column separators. If its value is Yes, display the internal column rulings to the right of each item; if No, do not display it. It is ignored for the last column, where the value of Frame applies. There is no default. The value is inherited from TGroupStyle, if used. Rowsep determines row separators. If its content is Yes, display the internal vertical row ruling below each item; if No, do not display it. It is ignored for the last row of the table, where the value of Frame applies. There is no default. The value is inherited from TGroupStyle, if used. TGroupStyle is a unique table group style defined in a FOSI (no default). THead THead is a optional part of TGroup (part of Table). THead may have any number of ColSpecs, followed by one or more required Rows. It has common and VAlign attributes, the latter with the allowed values of Top, Middle, and Bottom (the default). THead identifies the heading information in a Table, which is displayed at the top of the Table and again at the top of any continuation after a page break between Rows in TBody. Tip A suggestion to the user, set off from the text. See Caution. Title The text of a heading or the title of a block-oriented element. Title may contain in-line elements, and has common and PageNum attributes. TitleAbbrev An optional, abbreviated version of any Title. You may want to use this element when a title is so long that it might be truncated in some part of an online display, such as a title bar. TitleAbbrev may contain in-line elements and has common attributes. ToC 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. Formerly, ToC contained only ToCentry1s, but in this revision it has been subdivided to follow the divisions of a book: following the optional Title and TitleAbbrev, a ToC may have any number of ToCFronts, which are the entries for the front matter. Following the ToCFronts, if any, ToC must have either one or more ToCParts (entries for Parts) or ToCChaps (entries for Chapters and Appendices), and may have any number of ToCBacks (entries for back matter). A ToCPart may begin with in-line elements (in all cases, this is the actual entry, which was formerly ToCEntry), then contains any number of ToCChaps. A ToCChap may begin with in-line elements, then may have any number of ToCLevel1s, which are entries for Sect1s. ToCLevel1s may begin with in-line elements, then may have any number of ToCLevel2s, and so on down to ToCLevel5, which may have only in-line elements. Thus if you have a Table of Contents that shows section headings, the second-level entries are nested within the first-level entries, and so on. ToC has common attributes. ToCBack Entry for back matter in a ToC. See ToC. It has common, Linkend, Pagenum, and Label attributes. The Label attribute may take the value of Bib, Gloss, or Index, depending on the identity of the piece of front matter concerned. ToCChap See ToC. ToCFront Entry for introductory matter in a ToC. See ToC. It has common, Linkend, Pagenum, and Label attributes. The Label attribute may take the value of Equations, Examples, Figures, Preface, or Tables, depending on the identity of the piece of front matter concerned. ToCLevel1 The top-level tag for entries in a ToC. See ToC. ToCLevel2–5 may be nested within it, in order. All have common attributes and Linkend and PageNum attributes. PageNum is for indicating the page numbers on which the Table of Contents entries appear in a printed book. Linkend, should you choose to use it, should have the value of the ID of the relevant book part. ToCLevel1–5 may contain in-line elements. ToCPart See ToC. Token A unit of information in the context of lexical analysis. It contains plain text and has common attributes. Trademark A trademark. It may contain members of cptrphrase.gp, and has common and Class attributes. Class may have the values Service, Trade, Registered, or Copyright; the default is Trade. Type Indicates the classification of a value. It contains plain text and has common attributes. ULink A link containing a URL. A URL is a Uniform Resource Locator, as used with the World Wide Web. Very generally, a URL is a string specifying, according to a defined protocol, a method, a path to a target, and possibly some additional information. The URL should be given as the value of the URL attribute; there is also a Type attribute. While ULink is powerful, it is experimental and may be dropped in future revisions. Users should not expect it to be supported by SGML browsers. UserInput Data entered by the user. It may contain elements from cptrphrase.gp, and has common and MoreInfo attributes. For the MoreInfo attribute see Application. VarArgs An empty element, part of FuncSynopsis, indicating that the Function in question has a variable number of arguments. The string “(...)” should be output. VariableList An optionally titled list of VarListEntries, which are composed of sets of one or more Terms with associated ListItems; ListItems contain paragraphs and other block-oriented elements in any order. Inclusions are as for OrderedList (see OrderedList). VariableList has common attributes. VarListEntry A component of VariableList (see VariableList). It has common attributes. VarParam Dropped. Void An empty element, part of FuncSynopsis, that indicates that the Function in question takes no arguments. The string “(void)” should be output. See VarArgs. It has common attributes. VolumeNum The number of a Book in relation to Set, or of a journal, when Book is used to represent a journal by containing Articles. It contains plain text and has common attributes. Warning An admonition set off from the text. See Caution. WordAsWord A word (or letter or number) used not to represent the thing or idea it usually represents, but merely as the word itself. For example, “The term WORDASWORDGothic/WORDASWORD means different things to art historians and typographers,” or for a single character, “the letter WORDASWORDX/WORDASWORD”. It contains plain text and has common attributes. XRef Cross reference link to another part of the document. It has Linkend and Endterm attributes, just like Link, but like Anchor, it may have no content. XRef must have a Linkend, but the Endterm is optional. If it is used, the content of the element it points to is displayed as the text of the cross reference; if it is absent, the XRefLabel of the cross-referenced object is displayed. See Link. Year Year of publication, for use in Copyright. It contains plain text.