1 12/14/80  dot_tab.compin
 2 
 3 Syntax:  .ifi dot_tab "table-title"
 4 
 5 
 6 Function:
 7 This compose macro
 8 1) increments the table "dot number" counter
 9 2) outputs a centered, perhaps multiline table heading above the table
10    with appropriate spacing between table and heading
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    tab_on.compin.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 "dot number" counter is maintained on a per-section basis
23    for documents done in sections (those in which the 'section'
24    variable has been set), and on a per-document basis for all other
25    documents.
26 2) After the dot_tab macro is used, the 'table' compose variable
27    contains the table number of the current table.  'table' will be of
28    the form '<section>-<last_tab_No>.N' if the 'section' variable has
29    been set.  'table' can be used in the text to refer to the current
30    table.  (See dot_tab_get_no.compin.info and tab_get_no.compin.info
31    for references to a table other than the current table.)
32 3) The dot_tab macro cannot be used without an existing <last_tab_no>,
33    that is, it must follow some use of the tab or tab_index macros.
34    The next use of the tab, tab_index, or tab_get_no macro resets the
35    tabe "dot number" counter back to zero.
36 4) See dot_tab_index.compin.info, tab_index.compin.info,
37    dot_tab_get_no.compin.info, tab_get_no.compin.info, and
38    tab_on.compin.info for related information.
39 
40 
41 Examples:
42 To add a Figure after Figure 3-3 of a document...
43      .ifi dot_tab "Added Table"
44 resulting in...
45 
46                        Table 3-3.1.  Added Table
47 
48 (END)