entry
Prev | DocBook Element Reference | Next

This is an alpha version of this book.

# entry

## Name

entry — A cell in a table

##

# Synopsis

### Mixed Content Model

    entry ::=
    (#PCDATA|footnoteref|xref|abbrev|acronym|citation|citerefentry|
     citetitle|emphasis|firstterm|foreignphrase|glossterm|footnote|
     phrase|quote|trademark|wordasword|link|olink|ulink|action|
     application|classname|methodname|interfacename|exceptionname|
     ooclass|oointerface|ooexception|command|computeroutput|database|
     email|envar|errorcode|errorname|errortype|filename|function|
     guibutton|guiicon|guilabel|guimenu|guimenuitem|guisubmenu|
     hardware|interface|keycap|keycode|keycombo|keysym|literal|
     constant|markup|medialabel|menuchoice|mousebutton|option|
     optional|parameter|prompt|property|replaceable|returnvalue|
     sgmltag|structfield|structname|symbol|systemitem|token|type|
     userinput|varname|nonterminal|anchor|author|authorinitials|
     corpauthor|modespec|othercredit|productname|productnumber|
     revhistory|remark|subscript|superscript|inlinegraphic|
     inlinemediaobject|inlineequation|synopsis|cmdsynopsis|
     funcsynopsis|classsynopsis|fieldsynopsis|constructorsynopsis|
     destructorsynopsis|methodsynopsis|indexterm|beginpage|
     calloutlist|glosslist|itemizedlist|orderedlist|segmentedlist|
     simplelist|variablelist|caution|important|note|tip|warning|
     literallayout|programlisting|programlistingco|screen|screenco|
     screenshot|formalpara|para|simpara|graphic|mediaobject)*

### Attributes

Common attributes

Name | Type | Default
rowsep | CDATA | None
valign | Enumeration:
bottom
middle
top
| None
colsep | CDATA | None
namest | CDATA | None
align | Enumeration:
center
char
justify
left
right
| None
rotate | CDATA | None
spanname | CDATA | None
nameend | CDATA | None
charoff | CDATA | None
char | CDATA | None
morerows | CDATA | None
colname | CDATA | None

### Parameter Entities

The following parameter entities contain entry:

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 `Entry`s with the `MoreRows` attribute from preceding rows implicitly occupy cells in the succeeding `Row`s.

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

### 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`.

### Children

The following elements occur in entry: `abbrev`, `acronym`, `action`, `anchor`, `application`, `author`, `authorinitials`, `beginpage`, `calloutlist`, `caution`, `citation`, `citerefentry`, `citetitle`, `classname`, `classsynopsis`, `cmdsynopsis`, `command`, `computeroutput`, `constant`, `constructorsynopsis`, `corpauthor`, `database`, `destructorsynopsis`, `email`, `emphasis`, `envar`, `errorcode`, `errorname`, `errortype`, `exceptionname`, `fieldsynopsis`, `filename`, `firstterm`, `footnote`, `footnoteref`, `foreignphrase`, `formalpara`, `funcsynopsis`, `function`, `glosslist`, `glossterm`, `graphic`, `guibutton`, `guiicon`, `guilabel`, `guimenu`, `guimenuitem`, `guisubmenu`, `hardware`, `important`, `indexterm`, `inlineequation`, `inlinegraphic`, `inlinemediaobject`, `interface`, `interfacename`, `itemizedlist`, `keycap`, `keycode`, `keycombo`, `keysym`, `link`, `literal`, `literallayout`, `markup`, `medialabel`, `mediaobject`, `menuchoice`, `methodname`, `methodsynopsis`, `modespec`, `mousebutton`, `nonterminal`, `note`, `olink`, `ooclass`, `ooexception`, `oointerface`, `option`, `optional`, `orderedlist`, `othercredit`, `para`, `parameter`, `phrase`, `productname`, `productnumber`, `programlisting`, `programlistingco`, `prompt`, `property`, `quote`, `remark`, `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`.

## 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`. `Entry`s 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` .

A term coined by Terry Allen.

Prev | Home | Next
emphasis | Up | entrytbl

Copyright © 1999, 2000, 2001 O'Reilly & Associates, Inc.