Search the Catalog
DocBook: The Definitive Guide

DocBook: The Definitive Guide

By Norman Walsh & Leonard Muellner
1st Edition October 1999
1-56592-580-7, Order Number: 5807
652 pages, $36.95 , Includes CD-ROM

entry

Name

entry -- A cell in a table

Synopsis

Content Model

entry ::=
(((CalloutList|GlossList|ItemizedList|OrderedList|SegmentedList|
   SimpleList|VariableList|Caution|Important|Note|Tip|Warning|
   LiteralLayout|ProgramListing|ProgramListingCO|Screen|ScreenCO|
   ScreenShot|FormalPara|Para|SimPara|Graphic|MediaObject)+|
  (#PCDATA|FootnoteRef|XRef|Abbrev|Acronym|Citation|CiteRefEntry|
   CiteTitle|Emphasis|FirstTerm|ForeignPhrase|GlossTerm|Footnote|
   Phrase|Quote|Trademark|WordAsWord|Link|OLink|ULink|Action|
   Application|ClassName|Command|ComputerOutput|Database|Email|
   EnVar|ErrorCode|ErrorName|ErrorType|Filename|Function|
   GUIButton|GUIIcon|GUILabel|GUIMenu|GUIMenuItem|GUISubmenu|
   Hardware|Interface|InterfaceDefinition|KeyCap|KeyCode|KeyCombo|
   KeySym|Literal|Constant|Markup|MediaLabel|MenuChoice|
   MouseButton|MsgText|Option|Optional|Parameter|Prompt|Property|
   Replaceable|ReturnValue|SGMLTag|StructField|StructName|Symbol|
   SystemItem|Token|Type|UserInput|VarName|Anchor|Author|
   AuthorInitials|CorpAuthor|ModeSpec|OtherCredit|ProductName|
   ProductNumber|RevHistory|Comment|Subscript|Superscript|
   InlineGraphic|InlineMediaObject|InlineEquation|Synopsis|
   CmdSynopsis|FuncSynopsis|IndexTerm)+))

Attributes

Common attributes

Name

Type

Default

rowsepNUMBERNone
valign

Enumeration:

bottom
middle
top

None
colsepNUMBERNone
namestNMTOKENNone
align

Enumeration:

center
char
justify
left
right

None
rotateNUMBERNone
spannameNMTOKENNone
nameendNMTOKENNone
charoffNUTOKENNone
charCDATANone
morerowsNUMBERNone
colnameNMTOKENNone

Tag Minimization

The start-tag is required for this element. The end-tag is optional, if your SGML declaration allows minimization.

Parameter Entities

%tbl.row.mdl;

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).

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.

(4.0) 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.

Parents

These elements contain entry: row.

Attributes

align

Align specifies the horizontal alignment of text (and other elements) within the Entry. If no alignment is specified, it is inherited from the ColSpec for the current column, or the SpanSpec if this entry occurs in a span. If Char is specified, see also Char and CharOff.

char

Char specifies the alignment character when the Align attribute is set to Char.

charoff

CharOff specifies the percentage of the column's total width that should appear to the left of the first occurance of the character identified in Char when the Align attribute is set to Char. This attribute is inherited from the relevant ColSpec or SpanSpec.

colname

ColName identifies the column in which this entry should appear; it must have been previously defined in a ColSpec. Entrys cannot be given out of order, the column referenced must be to the right of the last Entry or EntryTbl placed in the current row. It is an error to specify both a ColName and a SpanName.

colsep

If ColSep has the value 1 (true), then a rule will be drawn to the right of this Entry. A value of 0 (false) suppresses the rule. The rule to the right of the last column in the table is controlled by the Frame attribute of the enclosing Table or InformalTable and the ColSep of an entry in the last column in the table is ignored. If unspecified, this attribute is inherited from the the corresponding ColSpec or SpanSpec and enclosing elements.

morerows

MoreRows indicates how many more rows, in addition to the current row, this Entry is to occupy. It creates a vertical span. The default of 0 indicates that the Entry occupies only a single row.

nameend

NameEnd is the name (defined in a ColSpec) of the rightmost column of a span. On Entry, specifying both NameSt and NameEnd defines a horizontal span for the current Entry. (See also SpanName.)

namest

NameSt ("name start") is the name (defined in a ColSpec) of the leftmost column of a span. On Entry, specifying both NameSt and NameEnd defines a horizontal span for the current Entry. (See also SpanName.)

rotate

If Rotate has the value 1 (true), the Entry is to be rotated 90 degrees counterclockwise in the table cell. A value of 0 (false) indicates that no rotation is to occur. If the stylesheet also specifies rotation, the value of Rotate is ignored; they are not additive. Only the values 0 and 1 are legal.

rowsep

If RowSep has the value 1 (true), then a rule will be drawn below the Entry. A value of 0 (false) suppresses the rule. The rule below the last row in the table is controlled by the Frame attribute of the enclosing Table or InformalTable and the RowSep of the last row is ignored. If unspecified, this attribute is inherited from enclosing elements.

spanname

SpanName is the name (defined in a SpanSpec) of a span. This cell will be rendered with the specified horizontal span.

valign

VAlign specifies the vertical alignment of text (and other elements) within the Entry. If no alignment is specified, it is inherited from enclosing elements.

See Also

colspec, entrytbl, InformalTable, row, spanspec, Table, tbody, tfoot, tgroup, thead

Examples

For examples, see entrytbl, FootnoteRef, InformalTable, RefEntry, Table.

Notes

[1]

A term coined by Terry Allen.

Back to: DocBook: The Definitive Guide


oreilly.com Home | O'Reilly Bookstores | How to Order | O'Reilly Contacts
International | About O'Reilly | Affiliated Companies | Privacy Policy

© 2001, O'Reilly & Associates, Inc.