Commit | Line | Data |
---|---|---|
930cce85 C |
1 | .\" -*- nroff -*- |
2 | .TH GTBL @MAN1EXT@ "21 July 1990" "Groff Version @VERSION@" | |
3 | .SH NAME | |
4 | gtbl \- table formatter for groff | |
5 | .SH SYNOPSIS | |
6 | .B gtbl | |
7 | [ | |
8 | .B \-Cv | |
9 | ] | |
10 | [ | |
11 | .IR files \|.\|.\|. | |
12 | ] | |
13 | .SH DESCRIPTION | |
14 | .B gtbl | |
15 | is a preprocessor for | |
16 | .B groff | |
17 | for formatting tables. | |
18 | Normally, it should be invoked using the | |
19 | .B \-t | |
20 | option of | |
21 | .B groff. | |
22 | It is highly compatible with | |
23 | .BR tbl . | |
24 | The output generated by | |
25 | .B gtbl | |
26 | cannot be processed with | |
27 | .BR ditroff ; | |
28 | it must be processed with | |
29 | .BR gtroff . | |
30 | If no files are given on the command line, the standard input | |
31 | will be read. | |
32 | A filename of | |
33 | .B \- | |
34 | will cause the standard input to be read. | |
35 | .SH OPTIONS | |
36 | .TP | |
37 | .B \-C | |
38 | Recognize | |
39 | .B .TS | |
40 | and | |
41 | .B .TE | |
42 | even when followed by a character other than space or newline. | |
43 | .TP | |
44 | .B \-v | |
45 | Print the version number. | |
46 | .SH USAGE | |
47 | Only the differences between | |
48 | .B gtbl | |
49 | and | |
50 | .B tbl | |
51 | are described here. | |
52 | .LP | |
53 | The | |
54 | .B f | |
55 | format modifier can be followed by an arbitrary length | |
56 | font name in parentheses. | |
57 | .LP | |
58 | There is a | |
59 | .B d | |
60 | format modifier which means that a vertically spanning entry | |
61 | should be aligned at the bottom of its range. | |
62 | .LP | |
63 | There is no limit on the number of columns in a table, nor any limit | |
64 | on the number of text blocks. | |
65 | All the lines of a table are considered in deciding column | |
66 | widths, not just the first 200. | |
67 | Table continuation | |
68 | .RB ( .T& ) | |
69 | lines are not restricted to the first 200 lines. | |
70 | .LP | |
71 | Numeric and alphabetic items may appear in the same column. | |
72 | .LP | |
73 | Numeric and alphabetic items may span horizontally. | |
74 | .LP | |
75 | .B gtbl | |
76 | uses register, string, macro and diversion names beginning with | |
77 | .BR 3 . | |
78 | When using | |
79 | .B gtbl | |
80 | you should avoid using any names beginning with a | |
81 | .BR 3 . | |
82 | .SH BUGS | |
83 | You should use | |
84 | .BR .TS\ H / .TH | |
85 | for | |
86 | .I all | |
87 | multi-page boxed tables. | |
88 | If there is no header that you wish to appear at the top of each page | |
89 | of the table, place the | |
90 | .B .TH | |
91 | line immediately after the format section. | |
92 | Do not enclose a multi-page table within keep/release macros, | |
93 | or divert it in any other way. | |
94 | .LP | |
95 | A text block within a table must be able to fit on one page. | |
96 | .SH "SEE ALSO" | |
97 | .BR groff (@MAN1EXT@), | |
98 | .BR gtroff (@MAN1EXT@) |