<RefEntry ID="dbre.elem.Table">
<!-- Created by DTDParseRefentry version 0.94 -->
<!-- Consult http://www.ora.com/homepages/dtdparse/ -->
<!-- for more information. -->

<![ %dbre.ms.refmeta [
<RefMeta>
<IndexTerm><Primary>Table Element</Primary></IndexTerm>
<RefEntryTitle>Table</RefEntryTitle>
<RefMiscInfo>Element</RefMiscInfo>
</RefMeta>
]]>

<RefNameDiv>
<RefName>Table</RefName>
<RefPurpose>
Table in a document

</RefPurpose>
</RefNameDiv>

<![ %dbre.ms.refsynopsisdiv [
<RefSynopsisDiv><Title>Content Model</Title>
<Synopsis>
  (
    (<Link LinkEnd="dbre.elem.Title">Title</Link>, <Link LinkEnd="dbre.elem.TitleAbbrev">TitleAbbrev</Link>?),
    (<Link LinkEnd="dbre.elem.Graphic">Graphic</Link>+ | <Link LinkEnd="dbre.elem.TGroup">TGroup</Link>+)
  )
  -(<Link LinkEnd="dbre.elem.InformalTable">InformalTable</Link> | <Link LinkEnd="dbre.elem.Equation">Equation</Link> | <Link LinkEnd="dbre.elem.Example">Example</Link> | <Link LinkEnd="dbre.elem.Figure">Figure</Link> | <Link LinkEnd="dbre.elem.Table">Table</Link>)
</Synopsis>

<![ %dbre.ms.refsynopsisdiv.excl [
<RefSect2><Title>Exclusions</Title>
<Para>
Table excludes these elements at every level:
</Para>
<Synopsis>
  <Link LinkEnd="dbre.elem.InformalTable">InformalTable</Link> | <Link LinkEnd="dbre.elem.Equation">Equation</Link> | <Link LinkEnd="dbre.elem.Example">Example</Link> | <Link LinkEnd="dbre.elem.Figure">Figure</Link> | <Link LinkEnd="dbre.elem.Table">Table</Link>
</Synopsis>
</RefSect2>
]]>

<![ %dbre.ms.refsynopsisdiv.attr [
<RefSect2><Title>Attributes</Title>
<Para>
This element has <link linkend="dbre.x.common">common</link> and <link linkend="dbre.x.role"><sgmltag class=attribute>Role</></link> attributes.
</Para>
<INFORMALTABLE>
<TGROUP COLS=4>
<COLSPEC COLNUM=2 COLNAME=C2>
<COLSPEC COLNUM=4 COLNAME=C4>
<SPANSPEC SPANNAME=C2C4 NAMEST=C2 NAMEEND=C4>
<THEAD>
<ROW>
  <ENTRY>Name</ENTRY>
  <ENTRY>Value(s)</ENTRY>
  <ENTRY>Type</ENTRY>
  <ENTRY>Default Value</ENTRY>
</ROW>
</THEAD>
<TBODY>
<ROW>
  <ENTRY>colsep</ENTRY>
  <ENTRY>NUMBER</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>frame</ENTRY>
  <ENTRY>(top|bottom|topbot|all|sides|none)</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>Label</ENTRY>
  <ENTRY>CDATA</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>orient</ENTRY>
  <ENTRY>(port|land)</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>pgwide</ENTRY>
  <ENTRY>NUMBER</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>rowsep</ENTRY>
  <ENTRY>NUMBER</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>shortentry</ENTRY>
  <ENTRY>NUMBER</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>tabstyle</ENTRY>
  <ENTRY>NMTOKEN</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>tocentry</ENTRY>
  <ENTRY>NUMBER</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
</TBODY>

</TGROUP>

</INFORMALTABLE>

</RefSect2>
]]>

<![ %dbre.ms.refsynopsisdiv.tagmin [
<RefSect2><Title>Tag Minimization</Title>
<Para>
Both the start- and end-tags are required for this element.
</Para>
</RefSect2>
]]>

</RefSynopsisDiv>
]]>

<![ %dbre.ms.description [
<RefSect1><Title>Description</Title>
<para>Table in a document.  Table is derived from
the SGML Open full CALS table model (cal-tbl.dtd);
changes are documented in the
tables.txt file in the distribution.
The present Table element has a required Title,
an optional TitleAbbrev, and either one or more Graphics
or one or more TGroups.  Tables may not contain
either Tables or InformalTables.
Table has common, Colsep, Frame, Label, Orient, Pgwide, Rowsep, ShortEntry,
Tabstyle, and Tocentry attributes.
Elements that may be contained within
TGroup are specified as having omissible
end tags, except for EntryTbl.  
</para>
<refsect2 id="dbreuse.table"><title>Usage</title>
<para>
Be aware that the ShortEntry
mechanism duplicates the DocBook element
TitleAbbrev.  It would be better, for any given
work, to choose one mechanism
or the other, rather than mix them.
</para>
</refsect2>
<refsect2 id="dbrecalsinfo.table"><title>CALS Customization Summary</title>
<para>Summary of entity redeclarations made to CALS full table model
(attributes are listed only by name, not by full declaration):
<screen>
============================================================================
Entity Name		Original CALS			DocBook Override
============================================================================

bodyatt			"" (Nothing)			Label

secur			"" (Nothing)			common attributes

yesorno			"NUMBER"			(Same)

titles			"title?"			(Same; unused)

paracon			"#PCDATA"			(Same; unused)

tbl.table.name		"(table|chart)"			"Table"

tbl.table-titles.mdl	"%titles,"			(Same; unused)

tbl.table-main.mdl	"(tgroup+|graphic+)"		(Same; unused)

tbl.table.mdl		"%tbl.table-titles.mdl;		"((%formalobject.title.
			%tbl.table-main.mdl;"		content);, (Graphic+
							|TGroup+))"

tbl.table.excep		"-(table|chart|figure)"		"-(InformalTable
							|%formal.class;)"

tbl.table.att		tabstyle, tocentry, shortentry,	(Same)
			orient, and pgwide

tbl.tgroup.mdl		"colspec*,spanspec*,thead?,	(Same)
			tfoot?,tbody"

tbl.tgroup.att		tgroupstyle			(Same)

tbl.hdft.name		"(thead|tfoot)"			(Same)

tbl.hdft.mdl		"colspec*,row+"			(Same)

tbl.row.mdl		"(entry|entrytbl)+)		(Same)

tbl.row.excep		"-(pgbrk)"			"" (Nothing)

tbl.entrytbl.mdl	"colspec*,spanspec*,thead?,	(Same)
			tbody"

tbl.entrytbl.excep	"-(entrytbl|pgbrk)"		"-(EntryTbl)"

tbl.entry.mdl		"(para|warning|caution|note	"((%tabentry.mix;)
			|legend|%paracon;)*"		| (%para.char.mix;)+)"

tbl.entry.excep		"-(pgbrk)"			"" (Nothing)
</screen>
</para>
</refsect2>



<![ %dbre.ms.description.parents [
<RefSect2><Title>Parents</Title>
<Para>
These elements contain Table:
<SimpleList Type=Inline>
<Member><Link LinkEnd="dbre.elem.Appendix">Appendix</Link></Member>
<Member><Link LinkEnd="dbre.elem.Article">Article</Link></Member>
<Member><Link LinkEnd="dbre.elem.BiblioDiv">BiblioDiv</Link></Member>
<Member><Link LinkEnd="dbre.elem.Bibliography">Bibliography</Link></Member>
<Member><Link LinkEnd="dbre.elem.BlockQuote">BlockQuote</Link></Member>
<Member><Link LinkEnd="dbre.elem.Callout">Callout</Link></Member>
<Member><Link LinkEnd="dbre.elem.Caution">Caution</Link></Member>
<Member><Link LinkEnd="dbre.elem.Chapter">Chapter</Link></Member>
<Member><Link LinkEnd="dbre.elem.GlossDef">GlossDef</Link></Member>
<Member><Link LinkEnd="dbre.elem.GlossDiv">GlossDiv</Link></Member>
<Member><Link LinkEnd="dbre.elem.Glossary">Glossary</Link></Member>
<Member><Link LinkEnd="dbre.elem.Important">Important</Link></Member>
<Member><Link LinkEnd="dbre.elem.Index">Index</Link></Member>
<Member><Link LinkEnd="dbre.elem.ListItem">ListItem</Link></Member>
<Member><Link LinkEnd="dbre.elem.MsgExplan">MsgExplan</Link></Member>
<Member><Link LinkEnd="dbre.elem.MsgText">MsgText</Link></Member>
<Member><Link LinkEnd="dbre.elem.Note">Note</Link></Member>
<Member><Link LinkEnd="dbre.elem.Para">Para</Link></Member>
<Member><Link LinkEnd="dbre.elem.PartIntro">PartIntro</Link></Member>
<Member><Link LinkEnd="dbre.elem.Preface">Preface</Link></Member>
<Member><Link LinkEnd="dbre.elem.Procedure">Procedure</Link></Member>
<Member><Link LinkEnd="dbre.elem.RefSect1">RefSect1</Link></Member>
<Member><Link LinkEnd="dbre.elem.RefSect2">RefSect2</Link></Member>
<Member><Link LinkEnd="dbre.elem.RefSect3">RefSect3</Link></Member>
<Member><Link LinkEnd="dbre.elem.RefSynopsisDiv">RefSynopsisDiv</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect1">Sect1</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect2">Sect2</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect3">Sect3</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect4">Sect4</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect5">Sect5</Link></Member>
<Member><Link LinkEnd="dbre.elem.SetIndex">SetIndex</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sidebar">Sidebar</Link></Member>
<Member><Link LinkEnd="dbre.elem.SimpleSect">SimpleSect</Link></Member>
<Member><Link LinkEnd="dbre.elem.Step">Step</Link></Member>
<Member><Link LinkEnd="dbre.elem.Tip">Tip</Link></Member>
<Member><Link LinkEnd="dbre.elem.Warning">Warning</Link></Member>
</SimpleList>.
</Para>

</RefSect2>
]]>

<![ %dbre.ms.description.children [
<RefSect2><Title>Children</Title>
<Para>
Table contains these elements:
<SimpleList Type=Inline>
<Member><Link LinkEnd="dbre.elem.Graphic">Graphic</Link></Member>
<Member><Link LinkEnd="dbre.elem.TGroup">TGroup</Link></Member>
<Member><Link LinkEnd="dbre.elem.Title">Title</Link></Member>
<Member><Link LinkEnd="dbre.elem.TitleAbbrev">TitleAbbrev</Link></Member>
</SimpleList>.
</Para>

<Para>
In some contexts, additional elements may be allowed
by inclusions in parent elements.
Similarly, in some contexts, some of these elements
may be invalid due to exclusions in parent elements.
</Para>
</RefSect2>
]]>


</RefSect1>
]]>

<![ %dbre.ms.attrdesc [
<RefSect1><Title>Attributes</Title>

<variablelist>
<varlistentry><term>frame</term>
<listitem>
<para>
Frame specifies how the table is to be framed.

</para>
</listitem>
</varlistentry>
<varlistentry><term>colsep</term>
<listitem>
<para>
For EntryTbl, if the value of Colsep
is 1 (yes), display the internal column rulings to
the right of the EntryTbl,
except if the EntryTbl falls in the the last column, 
where the side rule 
setting applies; if 0 (no), do not display it.
There is no default.  The
value is inherited from the enclosing TGroup.

</para>
</listitem>
</varlistentry>
<varlistentry><term>rowsep</term>
<listitem>
<para>
Rowsep controls the occurance of horizontal rules
between table rows.  A value of 1 (yes) specifies
that a rule should occur.  A value of 0 (no) specifies
that it should not.  Rowsep is inherited from
enclosing table elements.
</para>
</listitem>
</varlistentry>
<varlistentry><term>tabstyle</term>
<listitem>
<para>
Name of a table style defined in the FOSI.

</para>
</listitem>
</varlistentry>
<varlistentry><term>tocentry</term>
<listitem>
<para>
ToCEntry indicates whether the table is to be included
in a generated List of Tables.  The default is 0 (no).
</para>
</listitem>
</varlistentry>
<varlistentry><term>shortentry</term>
<listitem>
<para>
Determines whether the value of
the Table's TitleAbbrev is to be used
in an Index or ToC or LoT.  If the value is 0 (no),
the TitleAbbrev is not used; if 1 (yes), the TitleAbbrev
is used.

</para>
</listitem>
</varlistentry>
<varlistentry><term>orient</term>
<listitem>
<para>
Orient determines the orientation of the
Table.  The allowed values are Port (the orientation
of the rest of the text of the Book, that is, upright)
and Land (90 degrees counterclockwise from the
orientation of the rest of the text of the Book).
If you assume that the page is taller than
it is wide, tables that take up a whole page and
are wider than they are tall should be given the Land value.
There is no default; the value may be
inherited from the FOSI.

</para>
</listitem>
</varlistentry>
<varlistentry><term>pgwide</term>
<listitem>
<para>
Pgwide indicates whether the table should be 
rendered within the current text flow (no, the value 0)
or within the full text page width (yes, the value 1).  
There is no default.

</para>
</listitem>
</varlistentry>
<varlistentry><term>Label</term>
<listitem>
<para>
Label holds an identifying number 
or string to be output in some manner
when the element it is applied to is rendered.

</para>
</listitem>
</varlistentry>
</variablelist>
</RefSect1>
]]>

<![ %dbre.ms.examples [
<RefSect1><Title>Examples</Title>
<programlisting>
<![ CDATA [
<TABLE COLSEP="1" FRAME="all" ROWSEP="0"
SHORTENTRY="0" TOCENTRY="1" TABSTYLE="decimalstyle"
ORIENT="land" PGWIDE="0">
<TITLE>Sample Decimal-Aligned Table</TITLE>
<TITLEABBREV>Decimal-Aligned Table</TITLEABBREV>
<TGROUP ALIGN="char" CHAROFF="50" CHAR="." COLS="4">
<COLSPEC ALIGN="left" COLNUM="1" COLSEP="0" COLWIDTH="7pc">
<THEAD>
<ROW>
<ENTRY>Gas Ball</ENTRY>
<ENTRY>1940</ENTRY>
<ENTRY>1960</ENTRY>
<ENTRY>1980</ENTRY>
</ROW>
</THEAD>
<TFOOT>
<ROW>
<ENTRY>Rating</ENTRY>
<ENTRY>3</ENTRY>
<ENTRY>1</ENTRY>
<ENTRY>2</ENTRY>
</ROW>
</TFOOT>
<TBODY>
<ROW>
<ENTRY>Diameter</ENTRY>
<ENTRY>345.021</ENTRY>
<ENTRY>211.02</ENTRY>
<ENTRY>221.3</ENTRY>
</ROW>
<ROW>
<ENTRY>Color</ENTRY>
<ENTRY>blue</ENTRY>
<ENTRY>red</ENTRY>
<ENTRY>yellow</ENTRY>
</ROW>
</TBODY>
</TGROUP>
</TABLE>
]]>

</programlisting>

<programlisting>
<![ CDATA [
<TABLE FRAME="all">
<TITLE>Table With SpanSpec</TITLE>
<TGROUP COLS="5" COLSEP="1" ROWSEP="1">
<COLSPEC COLWIDTH="91*">
<COLSPEC COLNAME="col2" COLWIDTH="91*">
<COLSPEC COLNAME="col3" COLWIDTH="91*">
<COLSPEC COLNAME="col4" COLWIDTH="91*">
<COLSPEC COLNAME="col5" COLWIDTH="92*">
<SPANSPEC NAMEEND="col5" NAMEST="col4" SPANNAME="4to5">
<TBODY>
<ROW>
<ENTRY ALIGN="center" COLNAME="col2" VALIGN="middle">Software 1</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">Software 2</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">Software 3</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">Software 4</ENTRY></ROW>
<ROW>
<ENTRY ALIGN="center" VALIGN="middle">Platform 1</ENTRY>
<ENTRY ALIGN="center" MOREROWS="1" VALIGN="middle">25 MB</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">10 MB</ENTRY>
<ENTRY ALIGN="center" SPANNAME="4to5" VALIGN="middle">34 MB</ENTRY></ROW>
<ROW>
<ENTRY ALIGN="center" VALIGN="middle">Platform 2</ENTRY>
<ENTRY ALIGN="center" COLNAME="col3" VALIGN="middle">12 MB</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">30 MB</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">35 MB</ENTRY></ROW></TBODY></TGROUP>
</TABLE>
]]>

</programlisting>

</RefSect1>
]]>

</RefEntry>