1 <?xml version='1.0' encoding='UTF-8'?>
\r
2 <chapter xmlns="http://docbook.org/ns/docbook"
\r
3 xmlns:xi="http://www.w3.org/2001/XInclude"
\r
4 xmlns:xl="http://www.w3.org/1999/xlink"
\r
7 <title>Tables</title>
\r
9 <title>Types of Tables</title>
\r
10 <para>There are two types of tables in DocBook:</para>
\r
13 <para>Informal tables</para>
\r
19 <para>An informal table is simply a table that does not have a title. Tables
\r
20 must have a title element and are listed in a list of tables if it is
\r
24 <title>Specifying a Table</title>
\r
25 <para>Both informal tables and tables use the same markup elements to define
\r
26 their structure. The differences are as follows:</para>
\r
29 <para>Informal tables are specified using the <tag class="element">informaltable</tag> element and tables are specified using
\r
30 the <tag class="element">table</tag> element.</para>
\r
33 <para>Informal tables cannot contain a <tag class="element">title</tag> element and tables require a <tag class="element">title</tag> element.</para>
\r
36 <para>Creating a table involves the following steps:</para>
\r
39 <para>Specify the proper root element.</para>
\r
42 <para>If you are creating a table, add a <tag class="element">title</tag> element.</para>
\r
45 <para>Add a <tag class="element">tgroup</tag> element to wrap the
\r
46 contents of the table.</para>
\r
49 <para>If needed, add <tag class="element">colspec</tag> elements to
\r
50 specify properties for specific columns.</para>
\r
53 <para>If needed, add <tag class="element">spanspec</tag> elements to
\r
54 define reusable column spans.</para>
\r
57 <para>If desired, add a <tag>thead</tag> element to specify a header
\r
61 <para>Add a <tag class="element">row</tag> element.</para>
\r
64 <para>Add an <tag class="element">entry</tag> element for each column
\r
70 <para>Add a <tag class="element">tbody</tag> element to contain the
\r
71 body of the table.</para>
\r
74 <para>Add one <tag class="element">row</tag> element for each row in
\r
78 <para>In the <tag class="element">row</tag> elements, add an <tag class="element">entry</tag> element for each value that appear in the
\r
85 <title>Table Root Elements</title>
\r
86 <para>Depending on the type of table you are using you will use either the
\r
87 <tag class="element">informaltable</tag> element or the <tag class="element">table</tag> element as the root element of your table.
\r
88 Both elements use the attributes listed in <xref linkend="rootattrs"/>.</para>
\r
89 <table frame="all" xml:id="rootattrs" pgwide="1">
\r
90 <title>Attributes for <tag class="element">table</tag> Element and <tag class="element">informaltable</tag> Element</title>
\r
91 <tgroup cols="3" colsep="1" rowsep="1">
\r
92 <colspec colwidth="1.5in"/>
\r
95 <entry align="center">Attribute</entry>
\r
96 <entry align="center">Description</entry>
\r
97 <entry align="center">Values</entry>
\r
103 <indexterm><primary>table</primary><secondary>pgwide</secondary></indexterm>
\r
104 <tag class="attribute">pgwide</tag>
\r
106 <entry>Specifies whether the table will be span the whole page in PDF output.</entry>
\r
107 <entry><tag class="attvalue">0</tag> (default), <tag class="attvalue">1</tag></entry>
\r
111 <tag class="attribute">colsep</tag>
\r
113 <entry>Specifies whether a rule will be drawn between the columns in the table.</entry>
\r
114 <entry><tag class="attvalue">0</tag>, <tag class="attvalue">1</tag> (default)</entry>
\r
118 <tag class="attribute">frame</tag>
\r
120 <entry>Specifies how the table will be framed.</entry>
\r
121 <entry><tag class="attvalue">all</tag>, <tag class="attvalue">bottom</tag>, <tag class="attvalue">none</tag>, <tag class="attvalue">sides</tag>, <tag class="attvalue">top</tag>, <tag class="attvalue">topbot</tag></entry>
\r
125 <tag class="attribute">orient</tag>
\r
127 <entry>Specifies how the table will be oriented in relationship to the rest of the text.</entry>
\r
128 <entry><tag class="attvalue">land</tag>, <tag class="attvalue">port</tag> (default)</entry>
\r
132 <tag class="attribute">rowsep</tag>
\r
134 <entry>Specifies whether a rule will be drawn between the rows in the table.</entry>
\r
135 <entry><tag class="attvalue">0</tag>, <tag class="attvalue">1</tag> (default)</entry>
\r
139 <tag class="attribute">xml:id</tag>
\r
141 <entry>Specifies a unique identifier used to reference the table.</entry>
\r
142 <entry>a unique string</entry>
\r
146 <tag class="attribute">xreflabel</tag>
\r
149 <para>Specifies a label to be used when cross referencing the table.</para>
\r
151 <entry>a string</entry>
\r
157 <para>Attributes not listed in <xref linkend="rootattrs"/> are not used in Evergreen' documentation.</para>
\r
161 <title>The tgroup Element</title>
\r
162 <indexterm><primary>tgroup</primary></indexterm>
\r
163 <para>The <tag class="element">tgroup</tag> element groups together the logical components of a table. It specifies the number of columns in a table and contains the column and span specifications used by the table. All of the rows, including the header, are defined inside of the <tag class="element">tgroup</tag> element.</para>
\r
164 <para>While most tables contain a single <tag class="element">tgroup</tag> element, it is possible for a complex table to have multiple tgroup elements. In such a case, each <tag class="element">tgroup</tag> element would define a unique portion of table where the columns and spans had different specifications.</para>
\r
166 <title>Attributes</title>
\r
167 <para><xref linkend="tgroupattrs"/> shows the attributes for the <tag class="element">tgroup</tag> element. Attributes in the <tag class="element">tgroup</tag> element override the corresponding attributes
\r
168 from the table's root element.</para>
\r
169 <table xml:id="tgroupattrs" pgwide="1">
\r
170 <title>Attributes for the <tag class="element">tgroup</tag> Element</title>
\r
172 <colspec colwidth="1.5in"/>
\r
175 <entry align="center">Attribute</entry>
\r
176 <entry align="center">Description</entry>
\r
177 <entry align="center">Values</entry>
\r
183 <tag class="attribute">colsep</tag>
\r
185 <entry>Specifies whether a rule will be drawn between the columns of the group.</entry>
\r
186 <entry><tag class="attvalue">0</tag>, <tag class="attvalue">1</tag> (default)</entry>
\r
190 <tag class="attribute">rowsep</tag>
\r
192 <entry>Specifies whether a rule will be drawn between the rows of the group.</entry>
\r
193 <entry><tag class="attvalue">0</tag>, <tag class="attvalue">1</tag> (default)</entry>
\r
199 <entry>Specifies the horizontal alignment of the entries in the group.</entry>
\r
200 <entry><tag class="attvalue">center</tag>, <tag class="attvalue">justify</tag>, <tag class="attvalue">right</tag>, <tag class="attvalue">left</tag> (default)</entry>
\r
206 <entry>A required attribute that specifies the number of columns in the group.</entry>
\r
207 <entry>>=1</entry>
\r
213 <para>Attributes not listed in <xref linkend="tgroupattrs"/> are not used in Evergreen' documentation.</para>
\r
217 <title>Example</title>
\r
218 <para><xref linkend="groupexample"/> shows the markup for a <tag class="element">tgroup</tag> element that defines a 3 column table.</para>
\r
219 <informalexample xml:id="groupexample" xreflabel="The following">
\r
220 <programlisting><informaltable ...>
\r
221 <tgroup cols="3" colsep="1" rowsep="1" >
\r
224 </table></programlisting>
\r
228 <section xml:id="ColProps">
\r
229 <title>Specifying Column Properties</title>
\r
230 <para>If you desire, you can specify a number of the display properties for
\r
231 the column in a table by adding <tag class="element">colspec</tag>
\r
232 elements to a <tag class="element">tgroup</tag> element. A <tag class="element">colspec</tag> element defines properties for all of the
\r
233 entries in one column in a group. You can set different properties for each
\r
234 column in a group.</para>
\r
236 <title>Attributes</title>
\r
237 <para><xref linkend="colattrs"/> shows the attributes for the <tag class="element">colspec</tag> element. Attributes in the <tag class="element">colspec</tag> element override corresponding attributes in
\r
238 the parent <tag class="element">tgroup</tag> element and the table's
\r
239 root element.</para>
\r
240 <table xml:id="colattrs" pgwide="1">
\r
241 <title>Attributes for the <tag class="element">colspec</tag> Element</title>
\r
243 <colspec colwidth="1.5in"/>
\r
246 <entry align="center">Attribute</entry>
\r
247 <entry align="center">Description</entry>
\r
248 <entry align="center">Values</entry>
\r
254 <tag class="attribute">colsep</tag>
\r
256 <entry>Specifies whether a rule will be drawn to the right of entries in the column.</entry>
\r
257 <entry><tag class="attvalue">0</tag>, <tag class="attvalue">1</tag> (default)</entry>
\r
261 <tag class="attribute">rowsep</tag>
\r
263 <entry>Specifies whether a rule will be drawn between the rows in the column.</entry>
\r
264 <entry><tag class="attvalue">0</tag>, <tag class="attvalue">1</tag> (default)</entry>
\r
270 <entry>Specifies the horizontal alignment of the entries in the column.</entry>
\r
271 <entry><tag class="attvalue">center</tag>, <tag class="attvalue">justify</tag>, <tag class="attvalue">right</tag>, <tag class="attvalue">left</tag> (default)</entry>
\r
277 <entry>Specifies the number of the column being specified.</entry>
\r
278 <entry>1<=<replaceable>X</replaceable><=number of columns</entry>
\r
282 <tag class="attribute">colname</tag>
\r
284 <entry>Specifies a unique identifier by which the column can be referenced by other elements in the group.</entry>
\r
285 <entry>a unique string</entry>
\r
289 <tag class="attribute">colwidth</tag>
\r
291 <entry>Specifies the width of the column.</entry>
\r
292 <entry>Can be either a fixed measure using either points (pts), inches (in), or centimeters (cm).</entry>
\r
298 <para>Attributes not listed in <xref linkend="colattrs"/> are not used in Evergreen' documentation.</para>
\r
302 <title>Example</title>
\r
303 <para><xref linkend="colspecexample"/> shows the markup for specifying a
\r
304 column that is two inches wide and whose content is justified.</para>
\r
305 <example xml:id="colspecexample">
\r
306 <?dbfo pgwide="1"?>
\r
307 <title>Setting Column Properties</title>
\r
308 <programlisting><table ...>
\r
309 <title>...</title>
\r
310 <tgroup ... >
\r
311 <colspec align="justify" colwidth="2in" colname="2incol" />
\r
314 </table></programlisting>
\r
318 <section xml:id="SpanProps">
\r
319 <title>Defining Spans</title>
\r
320 <para>DocBook allows you to define properties for cells that span columns and
\r
321 name them for use by the cells in the group. To define a span you use the
\r
322 <tag class="element">spanspec</tag> element.</para>
\r
324 <title>Required Attributes</title>
\r
325 <para>The <tag class="element">spanspec</tag> element has three
\r
326 required attributes as described in <xref linkend="spanreqattrs"/>.</para>
\r
327 <table xml:id="spanreqattrs" pgwide="1">
\r
328 <title>Required Attributes for the <tag class="element">spanspec</tag> Element</title>
\r
330 <colspec colwidth="1.5in"/>
\r
333 <entry align="center">Attribute</entry>
\r
334 <entry align="center">Description</entry>
\r
340 <tag class="attribute">spanname</tag>
\r
342 <entry>Specifies the name by which cells will refer to the span.</entry>
\r
346 <tag class="attribute">namest</tag>
\r
348 <entry>Specifies the name, as declared in a <tag class="element">colspec</tag> element's <tag class="attribute">colname</tag> attribute, of the starting column for the span.</entry>
\r
354 <entry>Specifies the name, as declared in a <tag class="element">colspec</tag> element's <tag class="attribute">colname</tag> attribute, of the ending column for the span.</entry>
\r
361 <title>Optional Attributes</title>
\r
362 <para>In addition to the required attributes, the <tag class="element">spanspec</tag> element can also have the attributes
\r
363 described in <xref linkend="spanoptattrs"/>. Attributes in the <tag class="element">spanspec</tag> element override corresponding attributes
\r
364 in the parent <tag class="element">tgroup</tag> element and the
\r
365 table's root element.</para>
\r
366 <table xml:id="spanoptattrs" pgwide="1">
\r
367 <title>Optional Attributes for the <tag class="element">spanspec</tag> Element</title>
\r
369 <colspec colwidth="1.5in"/>
\r
372 <entry align="center">Attribute</entry>
\r
373 <entry align="center">Description</entry>
\r
374 <entry align="center">Values</entry>
\r
380 <tag class="attribute">colsep</tag>
\r
382 <entry>Specifies whether a rule will be drawn to the right of entries in the span.</entry>
\r
383 <entry><tag class="attvalue">0</tag>, <tag class="attvalue">1</tag> (default)</entry>
\r
387 <tag class="attribute">rowsep</tag>
\r
389 <entry>Specifies whether a rule will be drawn below the rows in the span.</entry>
\r
390 <entry><tag class="attvalue">0</tag>, <tag class="attvalue">1</tag> (default)</entry>
\r
396 <entry>Specifies the horizontal alignment of the entry in the span.</entry>
\r
397 <entry><tag class="attvalue">center</tag>, <tag class="attvalue">justify</tag>, <tag class="attvalue">right</tag>, <tag class="attvalue">left</tag> (default)</entry>
\r
403 <para>Attributes not listed in <xref linkend="spanoptattrs"/> are not used in Evergreen' documentation.</para>
\r
407 <title>Example</title>
\r
408 <para><xref linkend="spanexample"/> shows the markup for a span that crosses
\r
409 the second and third column of a five column table. The contents of the span
\r
410 are centered.</para>
\r
411 <example xml:id="spanexample">
\r
412 <?dbfo pgwide="1"?>
\r
413 <title>Defining a Span</title>
\r
414 <programlisting><informaltable ...>
\r
415 <tgroup cols="5" >
\r
416 <colspec colnum="2" colname="c2" />
\r
417 <colspec colnum="3" colname="c3" />
\r
418 <spanspec spanname="midspan" namest="c2" nameend="c3"
\r
419 align="center" />
\r
421 </informaltable></programlisting>
\r
425 <section xml:id="TableHead">
\r
426 <title>Adding a Heading Row to a Table</title>
\r
427 <para>Tables in Evergreen documentation generally have one heading row. They are specified
\r
428 using a <tag class="element">thead</tag> element. The <tag class="element">thead</tag> element is a child of a
\r
429 <tag>tgroup</tag> element. It must be placed after any <tag class="element">colspec</tag> elements and <tag class="element">spanspec</tag> elements. It should also be placed before
\r
430 any <tag class="element">tbody</tag> elements.</para>
\r
432 <title>Attributes</title>
\r
433 <para><xref linkend="theadattrs"/> lists the attributes of the <tag class="element">thead</tag> element.</para>
\r
434 <table xml:id="theadattrs" pgwide="1">
\r
435 <title>Attributes for the <tag class="element">thead</tag> Element</title>
\r
437 <colspec colwidth="1.5in"/>
\r
440 <entry align="center">Attribute</entry>
\r
441 <entry align="center">Description</entry>
\r
442 <entry align="center">Values</entry>
\r
450 <entry>Specifies the vertical alignment of the entry in the heading.</entry>
\r
451 <entry><tag class="attvalue">top</tag>, <tag class="attvalue">bottom</tag>, <tag class="attvalue">middle</tag> (default)</entry>
\r
458 <title>Adding content</title>
\r
459 <para>The content of the heading row is specified using a single <tag class="element">row</tag> element and one entry <tag class="element">child</tag> element for each column in the table. For more
\r
460 information on the row element and the entry element see <xref linkend="rowsect"/> and <xref linkend="entrysect"/>.</para>
\r
463 <title>Example</title>
\r
464 <para><xref linkend="theadexample"/> shows the markup for tables used in this
\r
466 <example xml:id="theadexample">
\r
467 <title>Adding a Table Header</title>
\r
468 <programlisting><table ...>
\r
469 <tgroup cols="3" >
\r
470 <colspec ... />
\r
473 <entry align="center">
\r
476 <entry align="center">
\r
479 <entry align="center">
\r
486 </informaltable></programlisting>
\r
490 <section xml:id="TableRows">
\r
491 <title>Adding Rows to a Table</title>
\r
492 <para>The rows that make up the body of a table are defined inside of a
\r
493 <tag class="element">tbody</tag> element. Each row in the table is
\r
494 defined using a <tag class="element">row</tag> element. The contents
\r
495 of each column in the row is defined using an <tag class="element">entry</tag> element.</para>
\r
497 <title>The <tag class="element">tbody</tag> Element</title>
\r
498 <para>The <tag class="element">tbody</tag> element is a wrapper for
\r
499 all of the rows in the body of a group. It is placed after all of the <tag class="element">colspec</tag> elements, all of the <tag class="element">spanspec</tag> elements, and the <tag class="element">thead</tag> element. It has a single attribute, <tag class="attribute">valign</tag>, that is described in <xref linkend="theadattrs"/>.</para>
\r
501 <simplesect xml:id="rowsect">
\r
502 <title>The <tag class="element">row</tag> Element</title>
\r
503 <para>Rows in a table are defined using the <tag>row</tag> element.
\r
504 Each <tag>row</tag> element wraps a number of <tag>entry</tag>
\r
505 children elements that cannot exceed the number columns specified in the
\r
506 <tag>tgroup</tag> element's <tag>cols</tag> attribute. It is
\r
507 possible to have less <tag>entry</tag> child elements. This can happen
\r
508 when you wish to have empty columns, when one entry spans multiple columns, or
\r
509 if there is an entry from a previous row that vertically spans the row being
\r
512 <para>When spans are being used the number of <tag>entry</tag>
\r
513 elements plus the number of columns being spanned cannot add up to more than
\r
514 the number of columns defined for the group.</para>
\r
516 <para>The <tag class="element">row</tag> element has two attributes as
\r
517 described in <xref linkend="rowattrs"/>. Attributes in the <tag class="element">row</tag> element override corresponding attributes in the
\r
518 parent <tag class="element">tbody</tag> element, the enclosing
\r
519 <tag class="element">tgroup</tag> element, the <tag class="element">colspec</tag> elements in the group, and the table's root
\r
521 <table xml:id="rowattrs" pgwide="1">
\r
522 <title>Attributes for the <tag class="element">row</tag> Element</title>
\r
524 <colspec colwidth="1.5in"/>
\r
527 <entry align="center">Attribute</entry>
\r
528 <entry align="center">Description</entry>
\r
529 <entry align="center">Values</entry>
\r
535 <tag class="attribute">rowsep</tag>
\r
537 <entry>Specifies whether a rule will be drawn below all of the entries in the row.</entry>
\r
538 <entry><tag class="attvalue">0</tag>, <tag class="attvalue">1</tag> (default)</entry>
\r
544 <entry>Specifies the vertical alignment of the entry in the heading.</entry>
\r
545 <entry><tag class="attvalue">top</tag>, <tag class="attvalue">bottom</tag>, <tag class="attvalue">middle</tag> (default)</entry>
\r
551 <simplesect xml:id="entrysect">
\r
552 <title>The <tag class="element">entry</tag> Element</title>
\r
553 <para>The contents of of a table are specified using <tag>entry</tag>
\r
554 elements. <tag>entry</tag> elements are children of the
\r
555 <tag>row</tag> element and hold the contents for a column in the
\r
557 <para>The contents of a table entry can be specified using either text with
\r
558 in-line markup elements or using block-level markup elements such as the
\r
559 <tag class="element">para</tag> element, the <tag class="element">procedure</tag> element, or one of the list types.
\r
560 However, if you intend to use one of the block-level markup elements you must
\r
561 place all of the content inside a block-level element. For example, if you
\r
562 want to use a list in a table entry, along with some text outside the list,
\r
563 you must place all of the content, including the list, inside a <tag class="element">para</tag> element.</para>
\r
564 <para>The <tag class="element">entry</tag> element's attributes are
\r
565 described in <xref linkend="entryattrs"/>. Attributes in the <tag class="element">entry</tag> element override corresponding attributes in
\r
566 the parent <tag class="element">row</tag> element, the enclosing
\r
567 <tag class="element">tbody</tag> element, the enclosing <tag class="element">tgroup</tag> element, the <tag class="element">colspec</tag> elements in the group, the <tag class="element">spansec</tag> elements in the group, and the table's root
\r
569 <table xml:id="entryattrs" pgwide="1">
\r
570 <title>Attributes for the <tag class="element">entry</tag> Element</title>
\r
572 <colspec colwidth="1.5in"/>
\r
575 <entry align="center">Attribute</entry>
\r
576 <entry align="center">Description</entry>
\r
577 <entry align="center">Values</entry>
\r
583 <tag class="attribute">rowsep</tag>
\r
585 <entry>Specifies whether a rule will be drawn below the entry.</entry>
\r
586 <entry><tag class="attvalue">0</tag>, <tag class="attvalue">1</tag> (default)</entry>
\r
592 <entry>Specifies the vertical alignment of the entry.</entry>
\r
593 <entry><tag class="attvalue">top</tag>, <tag class="attvalue">bottom</tag>, <tag class="attvalue">middle</tag> (default)</entry>
\r
597 <tag class="attribute">colsep</tag>
\r
599 <entry>Specifies whether a rule will be drawn to the right of the entry.</entry>
\r
600 <entry><tag class="attvalue">0</tag>, <tag class="attvalue">1</tag> (default)</entry>
\r
604 <tag class="attribute">namest</tag>
\r
606 <entry>Specifies the name of the left-most column the entry will span.</entry>
\r
607 <entry>The value of the <tag class="attribute">name</tag> attribute of the <tag class="element">colspec</tag> element defining the left-most column of the span.</entry>
\r
611 <tag class="attribute">nameend</tag>
\r
613 <entry>Specifies the right-most column the entry will span.</entry>
\r
614 <entry>The value of the <tag class="attribute">name</tag> attribute of the <tag class="element">colspec</tag> element defining the right-most column of the span.</entry>
\r
618 <tag class="attribute">spanname</tag>
\r
620 <entry>Specifies a defined span to use for the entry. This attribute should not be used with <tag class="attribute">namest</tag> and <tag class="attribute">nameend</tag>.</entry>
\r
621 <entry>The value of the <tag class="attribute">name</tag> attribute of the <tag class="element">spanspec</tag> element defining the span to use for the entry.</entry>
\r
625 <tag class="attribute">align</tag>
\r
627 <entry>Specifies the horizontal alignment of the contents in the entry.</entry>
\r
628 <entry><tag class="attvalue">center</tag>, <tag class="attvalue">justify</tag>, <tag class="attvalue">right</tag>, <tag class="attvalue">left</tag> (default)</entry>
\r
632 <tag class="attribute">morerows</tag>
\r
634 <entry>Specifies the number of additional rows the entry will span.</entry>
\r
635 <entry>>1</entry>
\r
639 <tag class="attribute">colname</tag>
\r
642 <para>Specifies the column, defined by a <tag class="element">colspec</tag> element, in which the entry belongs.</para>
\r
643 <para><emphasis role="bold">Note: </emphasis>You must specify entries rom left to right.</para>
\r
645 <entry>The value of the <tag class="attribute">name</tag> attribute of the <tag class="element">colspec</tag> element defining the column of the span.</entry>
\r
651 <para>Attributes not listed in <xref linkend="entryattrs"/> are not used in Evergreen' documentation.</para>
\r
655 <title>Example</title>
\r
656 <para><xref linkend="tbodyexample"/> shows the markup for tables used in this
\r
658 <example xml:id="tbodyexample">
\r
659 <?dbfo pgwide="1"?>
\r
660 <title>Add Rows to a Table</title>
\r
661 <programlisting><table ...>
\r
662 <tgroup cols="3" >
\r
663 <colspec ... />
\r
668 <tag class="attribute">colsep</tag>
\r
670 <entry>Specifies whether a rule will be drawn to
\r
671 the right of entries in the span.</entry>
\r
673 <tag class="attvalue">0</tag>,
\r
674 <tag class="attvalue">1</tag>
\r
675 (default)</entry>
\r
679 <tag class="attribute">rowsep</tag>
\r
681 <entry>Specifies whether a rule will be drawn below
\r
682 the rows in the span.</entry>
\r
684 <tag class="attvalue">0</tag>,
\r
685 <tag class="attvalue">1</tag>
\r
686 (default)</entry>
\r
689 <entry><tag>align</tag></entry>
\r
690 <entry>Specifies the horizontal alignment of
\r
691 the entry in the span.</entry>
\r
693 <tag class="attvalue">center</tag>,
\r
694 <tag class="attvalue">justify</tag>,
\r
695 <tag class="attvalue">right</tag>,
\r
696 <tag class="attvalue">left</tag>
\r
697 (default)</entry>
\r
701 </informaltable></programlisting>
\r
706 <title>Example</title>
\r
707 <para><xref linkend="tableexample"/> shows a table that uses most of the
\r
708 features of a table.</para>
\r
709 <table xml:id="tableexample" pgwide="1">
\r
710 <title>Complicated Table</title>
\r
712 <colspec colnum="1" colname="c1" align="center"/>
\r
713 <colspec colnum="2" colname="c2" align="justify"/>
\r
714 <colspec colname="c3"/>
\r
715 <colspec colnum="4" colname="c4"/>
\r
716 <colspec colnum="5" colname="c5" align="right"/>
\r
717 <colspec colname="c6" align="left"/>
\r
718 <spanspec namest="c2" nameend="c5" spanname="25" align="center"/>
\r
719 <spanspec namest="c1" nameend="c4" spanname="14" align="left"/>
\r
732 <entry>Pomegranate</entry>
\r
733 <entry>Pineapple</entry>
\r
734 <entry>Mango</entry>
\r
735 <entry>Carambola</entry>
\r
736 <entry>Banana</entry>
\r
737 <entry>Papaya</entry>
\r
740 <entry>Apples</entry>
\r
741 <entry align="right">Kiwis</entry>
\r
742 <entry namest="c3" nameend="c5" align="center">Passion Fruits</entry>
\r
743 <entry>Watermelon</entry>
\r
746 <entry spanname="14">Strawberries</entry>
\r
747 <entry>Cantaloupe</entry>
\r
748 <entry>Tamarind</entry>
\r
751 <entry>Lichee</entry>
\r
752 <entry spanname="25">Boysenberry</entry>
\r
753 <entry>Guava</entry>
\r
758 <para><xref linkend="tablemarkup"/> shows the markup for <xref linkend="tableexample"/>.</para>
\r
759 <example xml:id="tablemarkup">
\r
760 <?dbfo pgwide="1"?>
\r
761 <title>Markup for a Table</title>
\r
762 <programlisting><table xml:id="tableexample" pgwide="1">
\r
763 <title>Complicated Table</title>
\r
764 <tgroup cols="6">
\r
765 <colspec align="center" colname="c1" colnum="1" />
\r
766 <colspec align="justify" colname="c2" colnum="2" />
\r
767 <colspec colname="c3" />
\r
768 <colspec colname="c4" colnum="4" />
\r
769 <colspec align="right" colname="c5" colnum="5" />
\r
770 <colspec align="left" colname="c6" />
\r
771 <spanspec align="center" nameend="c5" namest="c2"
\r
772 spanname="25" />
\r
773 <spanspec align="left" nameend="c4" namest="c1"
\r
774 spanname="14" />
\r
777 <entry>c1</entry>
\r
778 <entry>c2</entry>
\r
779 <entry>c3</entry>
\r
780 <entry>c4</entry>
\r
781 <entry>c5</entry>
\r
782 <entry>c6</entry>
\r
787 <entry>Pomegranate</entry>
\r
788 <entry>Pineapple</entry>
\r
789 <entry>Mango</entry>
\r
790 <entry>Carambola</entry>
\r
791 <entry>Banana</entry>
\r
792 <entry>Papaya</entry>
\r
795 <entry>Apples</entry>
\r
796 <entry align="right">Kiwis</entry>
\r
797 <entry align="center" nameend="c5"
\r
798 namest="c3">Passion
\r
799 Fruits</entry>
\r
800 <entry>Watermelon</entry>
\r
803 <entry spanname="14">Strawberries</entry>
\r
804 <entry>Cantaloupe</entry>
\r
805 <entry>Tamarind</entry>
\r
808 <entry>Lichee</entry>
\r
809 <entry spanname="25">Boysenberry</entry>
\r
810 <entry>Guava</entry>
\r
814 </table></programlisting>
\r