GTBL

Section: Misc. Reference Manual Pages (@MAN1EXT@)
Updated: 21 July 1990
Index Return to Main Contents

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 generated 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 character 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 column.

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.

A text block within a table must be able to fit on one page.

This document was created by man2html, using the manual pages.
Time: 06:27:36 GMT, May 19, 2025