GTBL(1) GTBL(1) NNAAMMEE gtbl - format tables for troff SSYYNNOOPPSSIISS ggttbbll [ --CCvv ] [ _f_i_l_e_s... ] DDEESSCCRRIIPPTTIIOONN This manual page describes the GNU version of ttbbll, which is part of the groff document formatting system. ttbbll com- piles descriptions of tables embedded within ttrrooffff input files into commands that are understood by ttrrooffff. Nor- mally, it should be invoked using the --tt option of ggrrooffff.. It is highly compatible with Unix ttbbll. The output gener- ated by GNU ttbbll cannot be processed with Unix ttrrooffff; it must be processed with GNU ttrrooffff. 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. OOPPTTIIOONNSS --CC Recognize ..TTSS and ..TTEE even when followed by a char- acter other than space or newline. --vv Print the version number. UUSSAAGGEE Only the differences between GNU ttbbll and Unix ttbbll are described here. Normally ttbbll attempts to prevent undesirable breaks in the table by using diversions. This can sometimes interact badly with macro packages' own use of diversions, when footnotes, for example, are used. The nnookkeeeepp option tells ttbbll not to try and prevent breaks in this way. The ddeecciimmaallppooiinntt option specifies the character to be rec- ognized as the decimal point character in place of the default period. It takes an argument in parentheses, which must be a single character, as for the ttaabb option. The ff format modifier can be followed by an arbitrary length font name in parentheses. There is a dd 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 (..TT&&) lines are not restricted to the first 200 lines. Numeric and alphabetic items may appear in the same col- umn. Groff Version 1.08 1 April 1993 1 GTBL(1) GTBL(1) Numeric and alphabetic items may span horizontally. ttbbll uses register, string, macro and diversion names beginning with 33. When using ttbbll you should avoid using any names beginning with a 33. BBUUGGSS You should use ..TTSS HH/..TTHH in conjunction with a supporting macro package for _a_l_l 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 ..TTHH 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. The bbpp request cannot be used to force a page-break in a multi-page table. Instead, define BBPP as follows ..ddee BBPP ..iiee ''\\\\nn((..zz'''' ..bbpp \\\\$$11 ..eell \\!!..BBPP \\\\$$11 .... and use BBPP instead of bbpp. SSEEEE AALLSSOO ggrrooffff(1), ggttrrooffff(1) Groff Version 1.08 1 April 1993 2 .