Description
Entry is a cell in a table.
Each Entry may specify its starting column. Entries that do not explicitly specify a starting column begin implicitly in the column that is immediately adjacent to the preceding cell. Note that Entrys with the MoreRows attribute from preceding rows implicitly occupy cells in the succeeding Rows.
Rows are not required to be full. It is legal for some entries to be completely absent (at the beginning, middle, or end of a row).
Pernicious Mixed Content The content model of the Entry element exhibits a nasty peculiarity that we call "pernicious mixed content".[1] Every other element in DocBook contains either block elements or inline elements (including #PCDATA) unambiguously. In these cases, the meaning of line breaks and spaces are well understood; they are insignificant between block elements and significant (to the SGML parser, anyway) where inline markup can occur. Table entries are different; they can contain either block or inline elements, but not both at the same time. In other words, one Entry in a table might contain a paragraph or a list while another contains simply #PCDATA or another inline markup, but no single Entry can contain both. Because the content model of an Entry allows both kinds of markup, each time the SGML parser encounters an Entry, it has to decide what variety of markup it contains. SGML parsers are forbidden to use more than a single token of lookahead to reach this decision. In practical terms, what this means is that a line feed or space after an Entry start tag causes the parser to decide that the cell contains inline markup. Subsequent discovery of a paragraph or another block element causes a parsing error. All of these are legal: <entry>3.1415927</entry> <entry>General <emphasis>#PCDATA</emphasis></entry> <entry><para> A paragraph of text </para></entry> However, each of these is an error: <entry> Error, cannot have a line break before a block element <para> A paragraph of text. </para></entry> <entry><para> A paragraph of text. </para> Error, cannot have a line break between block elements <para> A paragraph of text. </para></entry> <entry><para> A paragraph of text. </para> Error, cannot have a line break after a block element </entry> When designing a DTD, it is wise to avoid pernicious mixed content. Unfortunately, the only way to correct the pernicious mixed content problem that already exists in DocBook is to require some sort of wrapper (a block element, or an inline like Phrase) around #PCDATA within table Entrys. This is annoying and inconvenient in a great many tables in which #PCDATA cells predominate and, in addition, differ from CALS. |
Processing expectations
This element is expected to obey the semantics of the CALS Table Model Document Type Definition, as specified by OASIS Technical Memorandum TM 9502:1995.
The content of Entry is formatted to fit within the table cell that it occupies. Horizontal and vertical spanning may allow the content of an Entry to occupy several physical cells.
Future Changes
The InterfaceDefinition element will be discarded in DocBook V4.0. It will no longer be available in the content model of this element.
Children
The following elements occur in entry: Abbrev, Acronym, Action, Anchor, Application, Author, AuthorInitials, CalloutList, Caution, Citation, CiteRefEntry, CiteTitle, ClassName, CmdSynopsis, Command, Comment, ComputerOutput, Constant, CorpAuthor, Database, Email, Emphasis, EnVar, ErrorCode, ErrorName, ErrorType, Filename, FirstTerm, Footnote, FootnoteRef, ForeignPhrase, FormalPara, FuncSynopsis, Function, GlossList, GlossTerm, Graphic, GUIButton, GUIIcon, GUILabel, GUIMenu, GUIMenuItem, GUISubmenu, Hardware, Important, IndexTerm, InlineEquation, InlineGraphic, InlineMediaObject, Interface, InterfaceDefinition, ItemizedList, KeyCap, KeyCode, KeyCombo, KeySym, Link, Literal, LiteralLayout, Markup, MediaLabel, MediaObject, MenuChoice, ModeSpec, MouseButton, MsgText, Note, OLink, Option, Optional, OrderedList, OtherCredit, Para, Parameter, Phrase, ProductName, ProductNumber, ProgramListing, ProgramListingCO, Prompt, Property, Quote, Replaceable, ReturnValue, RevHistory, Screen, ScreenCO, ScreenShot, SegmentedList, SGMLTag, SimPara, SimpleList, StructField, StructName, Subscript, Superscript, Symbol, Synopsis, SystemItem, Tip, Token, Trademark, Type, ULink, UserInput, VariableList, VarName, Warning, WordAsWord, XRef.
In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.
In some contexts, the following elements are excluded: Acronym, Caution, Footnote, Important, IndexTerm, Note, Tip, Warning.
