GTBL(@MAN1EXT@) 1990 GTBL(@MAN1EXT@)
NAME
gtbl - table formatter for groff
SYNOPSIS
gtbl [ -Cv ] [ files... ]
DESCRIPTION
gtbl is a preprocessor for groff for formatting tables.
Normally, it should be invoked using the -t option of
groff. It is highly compatible with tbl. The output gen-
erated by gtbl cannot be processed with ditroff; it must
be processed with gtroff. If no files are given on the
command line, the standard input will be read. A filename
of - will cause the standard input to be read.
OPTIONS
-C Recognize .TS and .TE even when followed by a char-
acter other than space or newline.
-v Print the version number.
USAGE
Only the differences between gtbl and tbl are described
here.
The f format modifier can be followed by an arbitrary
length font name in parentheses.
There is a d format modifier which means that a vertically
spanning entry should be aligned at the bottom of its
range.
There is no limit on the number of columns in a table, nor
any limit on the number of text blocks. All the lines of
a table are considered in deciding column widths, not just
the first 200. Table continuation (.T&) lines are not
restricted to the first 200 lines.
Numeric and alphabetic items may appear in the same col-
umn.
Numeric and alphabetic items may span horizontally.
gtbl uses register, string, macro and diversion names
beginning with 3. When using gtbl you should avoid using
any names beginning with a 3.
BUGS
You should use .TS H/.TH for all multi-page boxed tables.
If there is no header that you wish to appear at the top
of each page of the table, place the .TH line immediately
after the format section. Do not enclose a multi-page
table within keep/release macros, or divert it in any
other way.
July 21 1
GTBL(@MAN1EXT@) 1990 GTBL(@MAN1EXT@)
A text block within a table must be able to fit on one
page.
SEE ALSO
groff(@MAN1EXT@), gtroff(@MAN1EXT@)
July 21 2