<refentry id="entrytbl.element">
<?dbhtml filename="entrytbl.html"?>
<refentryinfo>
<pubdate>$Date$</pubdate>
<releaseinfo>$Revision$</releaseinfo>
</refentryinfo>

<refmeta>
<indexterm><primary>elements</primary>
<secondary>entrytbl</secondary></indexterm>
<refentrytitle>entrytbl</refentrytitle>
<refmiscinfo>Element</refmiscinfo>
</refmeta>
<refnamediv>
<refname>entrytbl</refname>
<refpurpose>&entrytbl.purpose;</refpurpose>
</refnamediv>

&entrytbl.synopsis.gen;
<refsect1 condition='ref.description'><title>Description</title>

<para>
The <sgmltag>EntryTbl</sgmltag> element allows for a single level of nesting
within tables.
&calssemantics;
</para>

<para>
An entry table may occur in a row instead of an <sgmltag>Entry</sgmltag>.
<sgmltag>EntryTbl</sgmltag>s have most of the elements of a table but
may not include themselves, thus limiting nesting to a single
level.
</para>

<refsect2><title>Processing expectations</title>
<para>
The content of <sgmltag>EntryTbl</sgmltag> is formatted, <emphasis>as a table</emphasis>,
to fit within the table cell that it occupies.  Horizontal and vertical
spanning may allow an <sgmltag>EntryTbl</sgmltag> to occupy several physical cells
in the table that contains it.
</para>

<para>
If multiple <sgmltag>EntryTbl</sgmltag>s occur in a single row, formatters
that support <sgmltag>EntryTbl</sgmltag> are not required to ensure that subrows
within the various tables are vertically aligned.
</para>

<para>
Many formatters are incapable of supporting <sgmltag>EntryTbl</sgmltag>s.
This is an interchange issue. See <xref linkend="app-interchange"/>.
</para>
</refsect2>


&entrytbl.parents.gen;
&entrytbl.children.gen;
</refsect1>
<refsect1 condition='ref.elem.attrdesc'><title>Attributes</title>
<variablelist>
<varlistentry><term>align</term>
<listitem>
<para>
<sgmltag class="attribute">Align</sgmltag> specifies the horizontal alignment
of the <sgmltag>EntryTbl</sgmltag> in the cell in which it occurs. If no
alignment is specified, it is inherited from the <sgmltag>ColSpec</sgmltag>
for the current column, or the <sgmltag>SpanSpec</sgmltag> if this entry
occurs in a span.
</para>
</listitem>
</varlistentry>
<varlistentry><term>char</term>
<listitem>
<para>
<sgmltag class="attribute">Char</sgmltag> specifies the alignment character when
the <sgmltag class="attribute">Align</sgmltag> attribute is set to <literal>Char</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry><term>charoff</term>
<listitem>
<para>
<sgmltag class='attribute'>CharOff</sgmltag> specifies the percentage of the
column's total width that should appear to the left of the first
occurance of the character identified in <sgmltag
class='attribute'>Char</sgmltag> when the <sgmltag class='attribute'>Align</sgmltag>
attribute is set to <literal>Char</literal>. This attribute is inherited from
the relevant <sgmltag>ColSpec</sgmltag> or <sgmltag>SpanSpec</sgmltag>.
</para>
</listitem>
</varlistentry>
<varlistentry><term>colname</term>
<listitem>
<para>
<sgmltag class="attribute">ColName</sgmltag> identifies the column in which
this entry table should appear; it must have been previously defined in
a <sgmltag>ColSpec</sgmltag>. <sgmltag>EntryTbl</sgmltag>s cannot be given out of order,
the column referenced must be to the right of the last <sgmltag>Entry</sgmltag>
or <sgmltag>EntryTbl</sgmltag> placed in the current row. It is an error
to specify both a <sgmltag class="attribute">ColName</sgmltag> and a
<sgmltag class="attribute">SpanName</sgmltag>.
</para>
</listitem>
</varlistentry>
<varlistentry><term>cols</term>
<listitem>
<para>
<sgmltag class="attribute">Cols</sgmltag> specifies the number of columns 
in the <sgmltag>EntryTbl</sgmltag>.
</para>
</listitem>
</varlistentry>
<varlistentry><term>colsep</term>
<listitem>
<para>
If <sgmltag class="attribute">ColSep</sgmltag> has the value 1 (true), then
a rule will be drawn to the right of this <sgmltag>EntryTbl</sgmltag>.
A value of 0 (false) suppresses the rule.
The rule to the right of the last column in the table is controlled by the
<sgmltag class="attribute">Frame</sgmltag> attribute of the enclosing 
<sgmltag>Table</sgmltag> or <sgmltag>InformalTable</sgmltag> and the 
<sgmltag class="attribute">ColSep</sgmltag> of an entry in the last column in the table
is ignored. If unspecified, this attribute is inherited from the
the corresponding <sgmltag>ColSpec</sgmltag> or <sgmltag>SpanSpec</sgmltag> and
enclosing elements.
</para>
</listitem>
</varlistentry>
<varlistentry><term>nameend</term>
<listitem>
<para>
<sgmltag class="attribute">NameEnd</sgmltag> is the name (defined in a 
<sgmltag>ColSpec</sgmltag>) of the rightmost column of a span. 
On <sgmltag>EntryTbl</sgmltag>, specifying both <sgmltag class="attribute">NameSt</sgmltag> 
and <sgmltag class="attribute">NameEnd</sgmltag> defines a horizontal span for the
current <sgmltag>EntryTbl</sgmltag>.
(See also <sgmltag class="attribute">SpanName</sgmltag>.)
</para>
</listitem>
</varlistentry>
<varlistentry><term>namest</term>
<listitem>
<para>
<sgmltag class='attribute'>NameSt</sgmltag> (<quote>name start</quote>) is the name
(defined in a <sgmltag>ColSpec</sgmltag>) of the leftmost column of a span.
On <sgmltag>EntryTbl</sgmltag>, specifying both <sgmltag
class='attribute'>NameSt</sgmltag> and <sgmltag class='attribute'>NameEnd</sgmltag>
defines a horizontal span for the current <sgmltag>EntryTbl</sgmltag>. (See
also <sgmltag class='attribute'>SpanName</sgmltag>.)
</para>
</listitem>
</varlistentry>
<varlistentry><term>rowsep</term>
<listitem>
<para>
If <sgmltag class="attribute">RowSep</sgmltag> has the value 1 (true), then a
rule will be drawn below the <sgmltag>EntryTbl</sgmltag>. A value of 0 (false)
suppresses the rule. The rule below the last row in the table is
controlled by the <sgmltag class="attribute">Frame</sgmltag> attribute of the
enclosing <sgmltag>Table</sgmltag> or <sgmltag>InformalTable</sgmltag> and the
<sgmltag class="attribute">RowSep</sgmltag> of the last row is ignored. If
unspecified, this attribute is inherited from enclosing elements.
</para>
</listitem>
</varlistentry>
<varlistentry><term>spanname</term>
<listitem>
<para>
<sgmltag class="attribute">SpanName</sgmltag> is the name (defined in a 
<sgmltag>SpanSpec</sgmltag>) of a span. This cell will be rendered with the
specified horizontal span.
</para>
</listitem>
</varlistentry>
<varlistentry><term>tgroupstyle</term>
<listitem>
<para>
<sgmltag class="attribute">TGroupstyle</sgmltag> holds the name of a
table group style defined in a stylesheet that
will be used to process this document.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 condition='ref.elem.seealso'><title>See Also</title>
&entrytbl.seealso.gen;
</refsect1>
<refsect1><title>Examples</title>

<informalexample role="example-source">
<programlisting>&entrytbl.example.1.txt;</programlisting>
</informalexample>

<para>
The preceding table would look something like this when formatted:
</para>
<informaltable frame="all">
<tgroup cols='5'>
<colspec colnum='2' colname="c2"/>
<colspec colnum='4' colname="c4"/>
<spanspec spanname="hspan" namest="c2" nameend="c4"/>
<tbody>
<row>
  <entry>a1</entry>
  <entry spanname="hspan">b1</entry>
  <entry>c1</entry>
</row>
<row>
  <entry morerows="2">a2</entry>
  <entry>b2a1</entry>
  <entry>b2b1</entry>
  <entry>b2c1</entry>
  <entry morerows="2">c2</entry>
</row>
<row>
  <entry>b2a2</entry>
  <entry>b2b2</entry>
  <entry>b2c2</entry>
</row>
<row>
  <entry>b2a3</entry>
  <entry>b2b3</entry>
  <entry>b2c3</entry>
</row>
<row>
  <entry>a3</entry>
  <entry spanname="hspan">b3</entry>
  <entry>c3</entry>
</row>
</tbody>
</tgroup>
</informaltable>

&entrytbl.example.seealso.gen;
</refsect1>
</refentry>

