![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to tbl.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / man / adm / man1|
Return to tbl.1 CVS log | Up to [Research Unix] / researchv10dc / man / adm / man1 |
1.1 root 1: .TH TBL 1
2: .CT 1 writing_troff
3: .SH NAME
4: tbl \- format tables for nroff or troff
5: .SH SYNOPSIS
6: .B tbl
7: [
8: .I file ...
9: ]
10: .SH DESCRIPTION
11: .I Tbl
12: is a preprocessor for formatting tables for
13: .I nroff
14: or
15: .IR troff (1).
16: The input files are copied to the standard output,
17: except for segments of the form
18: .IP
19: .nf
20: .B .TS
21: .IB options " ;
22: .IB format " .
23: .I data
24: .B .T&
25: .IB format " .
26: .I data
27: \&. . .
28: .B .TE
29: .fi
30: .LP
31: which describe tables
32: and are replaced by
33: .I troff
34: requests to lay out the tables.
35: If no arguments are given,
36: .I tbl
37: reads the standard input.
38: .PP
39: The (optional)
40: .I options
41: line is terminated by a semicolon and contains one or more
42: of
43: .RS
44: .TF linesize(n)
45: .TP
46: .B center
47: center the table; default is left-adjust
48: .TP
49: .B expand
50: make table as wide as current line length
51: .TP
52: .B box
53: .TP
54: .B doublebox
55: enclose the table in a box or double box
56: .TP
57: .B allbox
58: enclose every item in a box
59: .TP
60: .BI tab( x )
61: use
62: .I x
63: to separate input items; default is tab
64: .TP
65: .BI linesize( n )
66: set rules in
67: .IR n -point
68: type
69: .TP
70: .BI delim( xy )
71: recognize
72: .I x
73: and
74: .I y
75: as
76: .IR eqn (1)
77: delimiters
78: .PD
79: .RE
80: .PP
81: Each line, except the last, of the obligatory
82: .I format
83: describes one row of the table.
84: The last line describes all rows until the next
85: .BR .T& ,
86: where the format changes,
87: or the end of the table at
88: .BR .TE .
89: A format is specified by key letters, one per column, upper or
90: 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
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: .I 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: .I 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
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: .I 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: .if t \{.sp3
272: .1C\}
273: .PP
274: .SH SEE ALSO
275: .IR troff (1),
276: .IR eqn (1),
277: .IR doctype (1)
278: .br
279: M. E. Lesk and L. L. Cherry,
280: `TBL\(ema Program to Format Tables',
281: this manual, Volume\ 2
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.