1 .TH TBL 1
2 .SH NAME
3 tbl \- format tables for nroff or troff
4 .SH SYNOPSIS
5 .B tbl
6 [
7 .I file ...
8 ]
9 .SH DESCRIPTION
10 .I Tbl
11 is a preprocessor for formatting tables for
12 .I nroff
13 or
14 .MR troff (1) .
15 The input
16 .I files
17 are copied to the standard output,
18 except for segments of the form
19 .IP
20 .nf
21 .B .TS
22 .IB options " ;
23 .IB format " .
24 .I data
25 .B .T&
26 .IB format " .
27 .I data
28 \&. . .
29 .B .TE
30 .fi
31 .LP
32 which describe tables
33 and are replaced by
34 .I troff 
35 requests to lay out the tables.
36 If no arguments are given,
37 .I tbl
38 reads the standard input.
39 .PP
40 The (optional)
41 .I options
42 line is terminated by a semicolon and contains one or more
43 of
44 .RS
45 .TF linesize(n)
46 .TP
47 .B center
48 center the table; default is left-adjust
49 .TP
50 .B expand
51 make table as wide as current line length
52 .TP
53 .B box
54 .TP
55 .B doublebox
56 enclose the table in a box or double box
57 .TP
58 .B allbox
59 enclose every item in a box
60 .TP
61 .BI tab( x )
62 use 
63 .I x
64 to separate input items; default is tab
65 .TP
66 .BI linesize( n )
67 set rules in
68 .IR n -point
69 type
70 .TP
71 .BI delim( xy )
72 recognize
73 .I x
74 and
75 .I y
76 as
77 .MR eqn (1)
78 delimiters
79 .PD
80 .RE
81 .PP
82 Each line, except the last, of the obligatory
83 .I format
84 describes one row of the table.
85 The last line describes all rows until the next
86 .BR .T& ,
87 where the format changes,
88 or the end of the table at
89 .BR .TE .
90 A format is specified by key letters, one per column, either upper or lower case:
91 .RS
92 .TP 0
93 .B L
94 Left justify: the default for
95 columns without format keys.
96 .PD0
97 .TP
98 .B R
99 Right justify.
100 .TP
101 .B C
102 Center.
103 .TP
104 .B N
105 Numeric: align at decimal point (inferred for integers) or at
106 .LR \e& .
107 .TP
108 .B S
109 Span: extend previous column across this one.
110 .TP
111 .B A
112 Alphabetic: left-aligned within column, widest item centered, indented relative to 
113 .B L
114 rows.
115 .TP
116 .B ^
117 Vertical span: continue item from previous row into this row.
118 .TP
119 .B -
120 Draw a horizontal rule in this column.
121 .TP
122 .B =
123 Draw a double horizontal rule in this column.
124 .PD
125 .RE
126 .PP
127 Key letters may be followed by modifiers, also either case:
128 .RS
129 .TP \w'\fLF\fIfont\fLXX'u
130 .B |
131 Draw vertical rule between columns.
132 .PD0
133 .TP
134 .B ||
135 Draw a double vertical rule between columns.
136 .TP
137 .I n
138 Gap between column is
139 .I n
140 ens wide.
141 Default is 3.
142 .TP
143 .BI F font
144 Use specified
145 .IR font .
146 .B B
147 and
148 .B I
149 mean
150 .B FB
151 and
152 .BR FI .
153 .TP
154 .B T
155 Begin vertically-spanned item at top row of range; default is 
156 vertical centering (with
157 .LR ^ ).
158 .TP
159 .BI P n
160 Use point size
161 .IR n .
162 .TP
163 .BI V n
164 Use
165 .IR n -point
166 vertical spacing in text block; signed
167 .I n
168 means relative change.
169 .TP
170 .BI W( n )
171 Column width as a
172 .I troff
173 width specification.
174 Parens are optional if
175 .I n
176 is a simple integer.
177 .TP
178 .B E
179 Equalize the widths of all columns marked
180 .BR E .
181 .PD
182 .RE
183 .PP
184 Each line of
185 .I data
186 becomes one row of the table; tabs separate items.
187 Lines beginning with
188 .L .
189 are 
190 .I troff 
191 requests.
192 Certain special data items are recognized:
193 .RS
194 .TP 0
195 .B _
196 Draw a horizontal rule in this column.
197 .PD0
198 .TP
199 .B =
200 Draw a double horizontal rule in this column.
201 A data line consisting of a single
202 .L _
203 or
204 .L =
205 draws the rule across the whole table.
206 .TP
207 .B \e_
208 Draw a rule only as wide as the contents of the column.
209 .TP
210 .BI \eR x
211 Repeat character
212 .I x
213 across the column.
214 .TP
215 .B \e^
216 Span the previous item in this column down into this row.
217 .TP
218 .B T{
219 The item is a text block to be separately formatted
220 by
221 .I troff 
222 and placed in the table.
223 The block continues to the next line beginning with
224 .BR T} .
225 The remainder of the data line follows at that point.
226 .PD
227 .RE
228 .PP
229 When it is used in a pipeline with
230 .IR eqn ,
231 the
232 .I tbl
233 command should be first, to minimize the volume
234 of data passed through
235 pipes.
236 .SH EXAMPLES
237 .ds tb \fR<tab>\fP
238 Let \*(tb
239 represent a tab (which should
240 be typed as a genuine tab).
241 .if t .2C
242 .EX
243 \&.TS
244 c s s
245 c c s
246 c c c
247 l n n.
248 Household Population
249 Town\*(tbHouseholds
250 \*(tbNumber\*(tbSize
251 Bedminster\*(tb789\*(tb3.26
252 Bernards Twp.\*(tb3087\*(tb3.74
253 Bernardsville\*(tb2018\*(tb3.30
254 \&.TE
255 .if t \{\0 
256 \0 
257 \0\}
258 .if n .PP
259 .TS
260 c s s
261 c c s
262 c c c
263 l n n.
264 Household Population
265 Town	Households
266 	Number	Size
267 Bedminster	789	3.26
268 Bernards Twp.	3087	3.74
269 Bernardsville	2018	3.30
270 .TE
271 .EE
272 .if t \{.sp3
273 .1C\}
274 .SH SOURCE
275 .B \*9/src/cmd/tbl
276 .SH SEE ALSO
277 .IR troff (1), 
278 .MR eqn (1) ,
279 .MR doctype (1)
280 .br
281 M. E. Lesk and L. L. Cherry,
282 ``TBL\(ema Program to Format Tables'',
283 .I
284 Unix Research System Programmer's Manual,
285 Tenth Edition, Volume 2.