A.9. Tables

Preparing Cogent Documentation :
	Appendix A. Frequently Used DocBook Tags

List of elements

(arranged more or less hierarchically)

`<table>`	A table with a title, which appears in a special table of contents at the beginning of the document.
`<informaltable>`	A table with no title.
`<tgroup>`	A wrapper for table headers and rows.
`<thead>`	A table header, usually rendered in bold type. It can have more than one row.
`<colspec>`	Table column specifications.
`<tbody>`	A wrapper for table rows.
`<row>`	A table row.
`<entry>`	A table cell.

Elements shown in context

<table>
  <title>Table title</title>
  <tgroup cols="3">
    <thead>
      <row>
        <entry>Head 1</entry>
        <entry>Head 2</entry>
        <entry>Head 3</entry>
      </row>
    </thead>
    <tbody>
      <row>
        <entry>entry 1,1</entry>
        <entry>entry 1,2</entry>
        <entry>entry 1,3</entry>
      </row>
      <row>
        <entry>entry 2,1</entry>
        <entry>entry 2,2</entry>
        <entry>entry 2,3</entry>
      </row>
    </tbody>
   </tgroup>
</table>

<para> We use the following table format for
making definition lists where the terms being defined
are relatively short.  </para>
<informaltable frame="none">
  <tgroup cols="2">
  <colspec colwidth="1in>
    <tbody>
      <row>
        <entry>Term 1</entry>
        <entry>The definition of term 1.</entry>
      </row>
      <row>
        <entry>Term 2</entry>
        <entry>The definition of term 2.</entry>
      </row>
    </tbody>
  </tgroup>
</informaltable>

Example output

Table A.1. Table title

Head 1	Head 2	Head 3
entry 1,1	entry 1,2	entry 1,3
entry 2,1	entry 2,2	entry 2,3

We use the following table format for making definition lists where the terms being defined are relatively short.

Term 1	The definition of term 1.
Term 2	The definition of term 2.


A.8. Lists		A.10. Graphics