Help on using the <table> tag

Example

This CNXML:

<table frame="all" id="budgettable1">
  <name>Budget - Comparison by year</name>
  <tgroup cols="4" align="left" colsep="1" 
	  rowsep="1">
    <colspec colnum="2" colname="c2"/>
    <colspec colnum="4" colname="c4"/>
    <thead valign="top">
      <row>
	<entry morerows="1" 
	       align="center">Item</entry>
	<entry namest="c2" nameend="c4" 
	       align="center">Year</entry>
      </row>
      <row>
	<entry align="center">1998</entry>
	<entry align="center">1999</entry>
	<entry align="center">2000</entry>
      </row>
    </thead>
    <tbody valign="top">
      <row>
	<entry>Income</entry>
	<entry>12,293</entry>
	<entry>12,398</entry>
	<entry>14,298</entry>
      </row>
      <row>
	<entry>Expenditure</entry>
	<entry>293</entry>
	<entry>398</entry>
	<entry>298</entry>
      </row>
      <row>
	<entry>Surplus</entry>
	<entry>12000</entry>
	<entry>12000</entry>
	<entry>14000</entry>
      </row>
    </tbody>
  </tgroup>
</table>

Results in this display:

Budget - Comparison by year

Item	Year
Item	1998	1999	2000
Income	12,293	12,398	14,298
Expenditure	293	398	298
Surplus	12000	12000	14000

Attributes (what's this?)

frame (optional): Position of lines drawn around table.
- sides - Left and right.
- top - Below title.
- bottom - After last row.
- topbot - Top and bottom.
- all - All of the above.
- none - None of the above.
Default comes from the tabstyle attribute if used, otherwise it is "all".
colsep (optional): Sets whether the internal column rulings are displayed or not.
- 0 - Do not display column rulings.
- any other number - Display column rulings.
Default comes from the tabstyle attribute if used, otherwise it is 1.
rowsep (optional): Sets whether the internal row rulings are displayed or not.
- 0 - Do not display column rulings.
- any other number - Display column rulings.
Default comes from the tabstyle attribute if used, otherwise it is 1.
tabstyle (optional): An identifier for a table style (text).
tocentry (optional): Says whether the table's title, if it exists, is listed in the table of contents.
- 0 - Do not include in table of contents.
- any other number - Display in table of contents.
Default comes from style specification if it exists, otherwise it is 1.
shortentry (optional): Says whether to use the shorttitle, or title if no shorttitle exists, in listings in other parts of the document (text). Default comes from style specification if it exists, otherwise it is 0.
orient (optional): Orientation of table.
- port - Table writing direction, along rows, is parallel to the marginal page header and footer text.
- land - Table writing direction is 90 degrees counterclockwise to header/footer text.
Default comes from style specification if it exists, otherwise it is "port".
pgwide (optional): Determines the available width of the table (only used when orient="port").
- 0 - Maximum width of the table is the galley width.
- any other number - The width of the table is the entire width of the page.
Default comes from the style specification, otherwise it depens on the medium.
id (required): A unique identifier, whose value must begin with a letter and contain only letters, numbers, hyphens, underscores, colons, and/or periods (no spaces).

Using the <table> tag