1 02/20/80  tab.compin
 2 
 3 Syntax:  .ifi tab "table-title"
 4 
 5 
 6 Function:
 7 This compose macro
 8 1) increments the table counter
 9 2) outputs a centered, perhaps multiline table heading above the table
10    with appropriate spacing.
11 3) adds the 'table-title' to the list of Tables in the Table of
12    Contents if the creation of such a list has been enabled (see
13    tabl_on.info)
14 
15 
16 Arguments:
17 'table-title' is the title of the table, as it is to appear in the list
18    of Tables in the Table of Contents (initial caps, no underlines).
19 
20 
21 Notes:
22 1) The table counter is maintained on a per-section basis for documents
23    done in sections (those in which the 'section' variable has been
24    set), and on a per-document basis for all other documents.
25 2) After the tab macro is used, the 'table' compose variable contains
26    the table number of the current table.  'table' will be of the form
27    '<section>-N' if the 'section' variable has been set.  'table' can
28    be used in the text to refer to the current table.  (See
29    tab_get_no.info for references to a table other than the current
30    table.)
31 3) See tab_index.info, tab_on.info, and tab_get_no.info for related
32    information.
33 
34 
35 Examples:
36 The following lines generate a simple table following some text:
37 
38      These relationships are shown in the table below.
39      .ifi tab "Relationships Table"
40           NAME           PLACE
41           Paris          France
42           Rome           Italy
43             .
44             .
45             .
46 
47 (END)