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

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

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

<para>
A <sgmltag>TGroup</sgmltag> surrounds a logically complete portion of a table.
Most tables consist of a single <sgmltag>TGroup</sgmltag>, but complex tables
with widely varying column specifications may be easier to code using
multiple <sgmltag>TGroup</sgmltag>s.
</para>

<para>
The <sgmltag>TGroup</sgmltag> specifies the number of columns in the table,
and contains all of the header, body, and footer
rows, along with any additional column or span specifications
necessary to express the geometry of the table.
</para>

<para>
Most of the properties of rows, columns, and cells inherit their 
default characteristics from the enclosing <sgmltag>TGroup</sgmltag>.
</para>

<refsect2><title>Processing expectations</title>
<para>
&calssemantics;
</para>
</refsect2>


&tgroup.parents.gen;
&tgroup.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 <sgmltag>Entry</sgmltag>s (or <sgmltag>EntryTbl</sgmltag>s) in cells of the
<sgmltag>TGroup</sgmltag>. 
If <literal>Char</literal> is specified, see also 
<sgmltag class="attribute">Char</sgmltag> and
<sgmltag class="attribute">CharOff</sgmltag>.
Individual columns, spans, and cells can
provide an alternate alignment.
</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>.
</para>
</listitem>
</varlistentry>
<varlistentry><term>cols</term>
<listitem>
<para>
<sgmltag class="attribute">Cols</sgmltag> specifies the number of columns 
in the table.
</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 all columns in this <sgmltag>TGroup</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 not the 
<sgmltag class="attribute">ColSep</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 all the rows in this <sgmltag>TGroup</sgmltag>
(unless other, interior elements, suppress some or all of the rules).
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>tgroupstyle</term>
<listitem>
<para>
<sgmltag class="attribute">TGroupstyle</sgmltag> holds the name of a
table group style defined in a stylesheet (e.g., a <acronym>FOSI</acronym>) that
will be used to process this document.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 condition='ref.elem.seealso'><title>See Also</title>
&tgroup.seealso.gen;
</refsect1>
<refsect1><title>Examples</title>

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

