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

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

<RefNameDiv>
<RefName>colspec</RefName>
<RefPurpose>
Formatting specification for a
column in a Table

</RefPurpose>
</RefNameDiv>

<![ %dbre.ms.refsynopsisdiv [
<RefSynopsisDiv><Title>Content Model</Title>
<Synopsis>
  EMPTY
</Synopsis>

<![ %dbre.ms.refsynopsisdiv.attr [
<RefSect2><Title>Attributes</Title>
<Para>
This element has the <link linkend="dbre.x.role"><sgmltag class=attribute>Role</></link> attribute.
</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>align</ENTRY>
  <ENTRY>(left|right|center|justify|char)</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>char</ENTRY>
  <ENTRY>CDATA</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>charoff</ENTRY>
  <ENTRY>NUTOKEN</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>colname</ENTRY>
  <ENTRY>NMTOKEN</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>colnum</ENTRY>
  <ENTRY>NUMBER</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>colsep</ENTRY>
  <ENTRY>NUMBER</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>colwidth</ENTRY>
  <ENTRY>CDATA</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>rowsep</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>
The start-tag is required for this element.  The end-tag is optional, if your SGML declaration allows minimization.
</Para>
</RefSect2>
]]>

</RefSynopsisDiv>
]]>

<![ %dbre.ms.description [
<RefSect1><Title>Description</Title>
<para>"Column specifier,"
that is, formatting information for a
column in a Table, part of TGroup, THead, or TGroup. 
ColSpec is an empty element, bearing common
and Align, Char, Charoff,
Colname, Colnum, Colsep, Colwidth, and Rowsep
attributes.  The default values come from the TGroup,
THead, or TFoot that starts the current enclosing group. 
Each ColSpec is for a single column, so it properly has a 
column number, Colnum, implicitly in order starting 
from 1, and an optional Colname by which it is known when
used in any SpanSpec or in Entry.
A ColSpec set on THead or TFoot should be complete for
all columns.  It overrides those on the containing TGroup
and applies to just the THead or
TFoot.  If there is no ColSpec used within THead or
TFoot, then the ColSpec of the containing TGroup (or the 
prior TGroup) is used.  ColSpecs from the containing
TGroup apply to TBody.
</para>


<![ %dbre.ms.description.parents [
<RefSect2><Title>Parents</Title>
<Para>
These elements contain colspec:
<SimpleList Type=Inline>
<Member><Link LinkEnd="dbre.elem.entrytbl">entrytbl</Link></Member>
<Member><Link LinkEnd="dbre.elem.tfoot">tfoot</Link></Member>
<Member><Link LinkEnd="dbre.elem.tgroup">tgroup</Link></Member>
<Member><Link LinkEnd="dbre.elem.thead">thead</Link></Member>
</SimpleList>.
</Para>

</RefSect2>
]]>

<![ %dbre.ms.description.children [
]]>


</RefSect1>
]]>

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

<variablelist>
<varlistentry><term>colnum</term>
<listitem>
<para>
Colnum
gives the number of the column,
counting from 1 at left of the table.
There is no default.

</para>
</listitem>
</varlistentry>
<varlistentry><term>colname</term>
<listitem>
<para>
Name of the column, which is used
to specify the position in a row, or the start or end of a
horizontal span of columns (SpanSpec).
There is no default.
For Entry, 
omit if SpanName is present;  The implied value is either
the first column of the Row, or, if already in a Row,
the next column after the end of the prior Entry or
EntryTbl.

</para>
</listitem>
</varlistentry>
<varlistentry><term>colwidth</term>
<listitem>
<para>
Colwidth is either a proportional
measure of the form <emphasis>number*</emphasis>, such as "5*" for
5 times the proportion, or "*" (="1*"); or a
fixed measure, such as 2pt for 2
points, 3pc for 3 picas; or a mixed measure, such as 2*+3pt.
Coefficients are positive numbers with up to
two decimal places.  There is no default.
If no value is given, the value should
be obtained from the FOSI, or, if there is no FOSI value,
the value 1 should be (Perhaps this means that
you can vary the width of columns by stating their relative
proportions, or you can give fixed widths.  If you use
a decimal number less than one, express it in the form
0.2, not .2.)

</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>align</term>
<listitem>
<para>
Align controls the horizontal position
of text within the column.
The value of Align may be Left (quad flush left),
Center (centered), Right (quad flush right),
Justify (both quad left and right), or Char (align to
the left of Char, positioned by Charoff).  
There is no default except for SpanSpec, where the default is Center.
For Entry and EntryTbl, the value may be inherited from
ColSpec or SpanSpec.

</para>
</listitem>
</varlistentry>
<varlistentry><term>char</term>
<listitem>
<para>
Specifies the alignment character
</para>
</listitem>
</varlistentry>
<varlistentry><term>charoff</term>
<listitem>
<para>
Charoff contributes with Char to Align.
Charoff is the proportion
of the current column width, expressed in percentage,
to be allowed before the left edge of the first occurrence
of the character given as the value of Char.
For Entry, the default is inherited from ColSpec or SpanSpec.
For ColSpec and EntryTbl, the default is inherited from the enclosing TGroup.
For SpanSpec, the default is inherited from the ColSpec of
the column named by Namest.

</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>