[unix-history] / usr / src / usr.bin / groff / tbl / tbl.1

.\" -*- nroff -*-
.TH GTBL @MAN1EXT@ "21 July 1990" "Groff Version @VERSION@"
.SH NAME
gtbl \- table formatter for groff
.SH SYNOPSIS
.B gtbl
[
.B \-Cv
]
[
.IR files \|.\|.\|.
]
.SH DESCRIPTION
.B gtbl
is a preprocessor for
.B groff
for formatting tables.
Normally, it should be invoked using the
.B \-t
option of
.B groff.
It is highly compatible with
.BR tbl .
The output generated by
.B gtbl
cannot be processed with
.BR ditroff ;
it must be processed with
.BR gtroff .
If no files are given on the command line, the standard input
will be read.
A filename of
.B \-
will cause the standard input to be read.
.SH OPTIONS
.TP
.B \-C
Recognize
.B .TS
and
.B .TE
even when followed by a character other than space or newline.
.TP
.B \-v
Print the version number.
.SH USAGE
Only the differences between
.B gtbl
and
.B tbl
are described here.
.LP
The
.B f
format modifier can be followed by an arbitrary length
font name in parentheses.
.LP
There is a
.B d
format modifier which means that a vertically spanning entry
should be aligned at the bottom of its range.
.LP
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
.RB ( .T& )
lines are not restricted to the first 200 lines.
.LP
Numeric and alphabetic items may appear in the same column.
.LP
Numeric and alphabetic items may span horizontally.
.LP
.B gtbl
uses register, string, macro and diversion names beginning with
.BR 3 .
When using
.B gtbl
you should avoid using any names beginning with a
.BR 3 .
.SH BUGS
You should use
.BR .TS\ H / .TH
for
.I 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
.B .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.
.LP
A text block within a table must be able to fit on one page.
.SH "SEE ALSO"
.BR groff (@MAN1EXT@),
.BR gtroff (@MAN1EXT@)
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@)