[unix-history] / usr / src / old / tbl / tbl.1

.\" Copyright (c) 1990, 1991 Regents of the University of California.
.\" All rights reserved.
.\"
.\" %sccs.include.proprietary.roff%
.\"
.\"     @(#)tbl.1	6.4 (Berkeley) %G%
.\"
.Dd 
.Dt TBL 1
.Os ATT 7th
.Sh NAME
.Nm tbl
.Nd format tables for nroff or troff
.Sh SYNOPSIS
.Nm tbl
.Op Ar files
.Ar ...
.Sh DESCRIPTION
.Nm Tbl
is a preprocessor for formatting tables for
.Xr nroff
or
.Xr troff 1 .
The input files are copied to the standard output, except for lines between
\&.TS and
\&.TE command lines, which are assumed to describe tables
and are reformatted.
Details are given in the 
.%T TBL
reference manual.
.Sh EXAMPLE
.Pp
As an example, letting \et represent a tab (which should be typed as a genuine
tab) the input
.Bd -literal -offset indent
\&.TS
c s s
c c s
c c c
l n n.
Household Population
Town\\tHouseholds
\\tNumber\\tSize
Bedminster\\t789\\t3.26
Bernards Twp.\\t3087\\t3.74
Bernardsville\\t2018\\t3.30
Bound Brook\\t3425\\t3.04
Branchburg\\t1644\\t3.49
Bridgewater\\t7897\\t3.81
Far Hills\\t240\\t3.19
\&.TE
.Ed
.Pp
yields
.Bd -unfilled -offset indent
.ne 10
.TS
.nr 35 \n(.u
.nr 79 0n
.nr 80 \n(79
.nr 40 \n(79
.nr 38 \n(79+\w!Town!
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \n(79+\w!!
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \n(79+\w!Bedminster!
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \n(79+\w!Bernards Twp.!
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \n(79+\w!Bernardsville!
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \n(79+\w!Bound Brook!
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \n(79+\w!Branchburg!
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \n(79+\w!Bridgewater!
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \n(79+\w!Far Hills!
.if \n(80<\n(38 .nr 80 \n(38
.nr 81 \n(80
.nr 41 \n(80
.nr 38 \n(80+\w!Number!
.if \n(81<\n(38 .nr 81 \n(38
.nr 31 0
.nr 32 0
.nr 38 \w!789!
.if \n(31<\n(38 .nr 31 \n(38
.nr 38 \w!!
.if \n(32<\n(38 .nr 32 \n(38
.nr 38 \w!3087!
.if \n(31<\n(38 .nr 31 \n(38
.nr 38 \w!!
.if \n(32<\n(38 .nr 32 \n(38
.nr 38 \w!2018!
.if \n(31<\n(38 .nr 31 \n(38
.nr 38 \w!!
.if \n(32<\n(38 .nr 32 \n(38
.nr 38 \w!3425!
.if \n(31<\n(38 .nr 31 \n(38
.nr 38 \w!!
.if \n(32<\n(38 .nr 32 \n(38
.nr 38 \w!1644!
.if \n(31<\n(38 .nr 31 \n(38
.nr 38 \w!!
.if \n(32<\n(38 .nr 32 \n(38
.nr 38 \w!7897!
.if \n(31<\n(38 .nr 31 \n(38
.nr 38 \w!!
.if \n(32<\n(38 .nr 32 \n(38
.nr 38 \w!240!
.if \n(31<\n(38 .nr 31 \n(38
.nr 38 \w!!
.if \n(32<\n(38 .nr 32 \n(38
.nr 61 \n(80+\n(31
.nr 38 \n(61+\n(32
.if \n(38>\n(81 .nr 81 \n(38
.if \n(38<\n(81 .nr 61 +(\n(81-\n(38)/2
.nr 82 \n(81
.nr 42 \n(81
.nr 38 \n(81+\w!Size!
.if \n(82<\n(38 .nr 82 \n(38
.nr 31 0
.nr 32 0
.nr 38 \w!3!
.if \n(31<\n(38 .nr 31 \n(38
.nr 38 \w!.26!
.if \n(32<\n(38 .nr 32 \n(38
.nr 38 \w!3!
.if \n(31<\n(38 .nr 31 \n(38
.nr 38 \w!.74!
.if \n(32<\n(38 .nr 32 \n(38
.nr 38 \w!3!
.if \n(31<\n(38 .nr 31 \n(38
.nr 38 \w!.30!
.if \n(32<\n(38 .nr 32 \n(38
.nr 38 \w!3!
.if \n(31<\n(38 .nr 31 \n(38
.nr 38 \w!.04!
.if \n(32<\n(38 .nr 32 \n(38
.nr 38 \w!3!
.if \n(31<\n(38 .nr 31 \n(38
.nr 38 \w!.49!
.if \n(32<\n(38 .nr 32 \n(38
.nr 38 \w!3!
.if \n(31<\n(38 .nr 31 \n(38
.nr 38 \w!.81!
.if \n(32<\n(38 .nr 32 \n(38
.nr 38 \w!3!
.if \n(31<\n(38 .nr 31 \n(38
.nr 38 \w!.19!
.if \n(32<\n(38 .nr 32 \n(38
.nr 62 \n(81+\n(31
.nr 38 \n(62+\n(32
.if \n(38>\n(82 .nr 82 \n(38
.if \n(38<\n(82 .nr 62 +(\n(82-\n(38)/2
.nr 38 \n(79+\w!Household Population!-\n(82
.if \n(38>0 .nr 38 \n(38/2
.if \n(38<0 .nr 38 0
.nr 61 +1*\n(38
.nr 81 +1*\n(38
.nr 41 +1*\n(38
.nr 62 +2*\n(38
.nr 82 +2*\n(38
.nr 42 +2*\n(38
.nr 38 \n(80+\w!Households!-\n(82
.if \n(38>0 .nr 38 \n(38/1
.if \n(38<0 .nr 38 0
.nr 62 +1*\n(38
.nr 82 +1*\n(38
.nr 42 +1*\n(38
.nr 38 1n
.nr 41 +3*\n(38
.nr 81 +3*\n(38
.nr 61 +3*\n(38
.if n .if \n(61%24>0 .nr 61 +12u
.nr 42 +6*\n(38
.nr 82 +6*\n(38
.nr 62 +6*\n(38
.if n .if \n(62%24>0 .nr 62 +12u
.nr TW \n(82
.fc ! :
.ta \n(82u 
\&!:Household Population:!
.ta \n(80u \n(82u 
\&\h'|\n(40u'!:Town:!\h'|\n(41u'!:Households:!
.ta \n(80u \n(81u \n(82u 
\&\h'|\n(40u'!::!\h'|\n(41u'!:Number:!\h'|\n(42u'!:Size:!
.ta \n(80u \n(61u \n(62u \n(82u 
\&\h'|\n(40u'!Bedminster:!\h'|\n(41u'!:789!\h'|\n(42u'!:3!!.26:!
.ta \n(80u \n(61u \n(62u \n(82u 
\&\h'|\n(40u'!Bernards Twp.:!\h'|\n(41u'!:3087!\h'|\n(42u'!:3!!.74:!
.ta \n(80u \n(61u \n(62u \n(82u 
\&\h'|\n(40u'!Bernardsville:!\h'|\n(41u'!:2018!\h'|\n(42u'!:3!!.30:!
.ta \n(80u \n(61u \n(62u \n(82u 
\&\h'|\n(40u'!Bound Brook:!\h'|\n(41u'!:3425!\h'|\n(42u'!:3!!.04:!
.ta \n(80u \n(61u \n(62u \n(82u 
\&\h'|\n(40u'!Branchburg:!\h'|\n(41u'!:1644!\h'|\n(42u'!:3!!.49:!
.ta \n(80u \n(61u \n(62u \n(82u 
\&\h'|\n(40u'!Bridgewater:!\h'|\n(41u'!:7897!\h'|\n(42u'!:3!!.81:!
.ta \n(80u \n(61u \n(62u \n(82u 
\&\h'|\n(40u'!Far Hills:!\h'|\n(41u'!:240!\h'|\n(42u'!:3!!.19:!
.fc
.mk ##
.nr ## -1v
.if \n(35>0 .fi
.TE
.Ed
.Pp
If no arguments are given,
.Nm tbl
reads the standard input, so it may be used as a filter.  When 
.Nm tbl
is used with
.Xr eqn
or
.Xr neqn
the
.Nm tbl
command should be first, to minimize the volume of data passed through pipes.
.Sh SEE ALSO
.Xr troff 1 ,
.Xr eqn 1
.Rs
.%T TBL ,
.%A M. E. Lesk .
.Re
.Sh HISTORY
The
.Nm
command appeared in Version 7 AT&T UNIX.
Commit	Line	Data
3f4f3ab0 CL	1	.\" Copyright (c) 1990, 1991 Regents of the University of California.
	2	.\" All rights reserved.
	3	.\"
94bed826	4	.\" %sccs.include.proprietary.roff%
09251a32	5	.\"
3f4f3ab0	6	.\" @(#)tbl.1 6.4 (Berkeley) %G%
daacd5f0	7	.\"
3f4f3ab0 CL	8	.Dd
	9	.Dt TBL 1
	10	.Os ATT 7th
	11	.Sh NAME
	12	.Nm tbl
	13	.Nd format tables for nroff or troff
	14	.Sh SYNOPSIS
	15	.Nm tbl
	16	.Op Ar files
	17	.Ar ...
	18	.Sh DESCRIPTION
	19	.Nm Tbl
09251a32	20	is a preprocessor for formatting tables for
3f4f3ab0	21	.Xr nroff
09251a32	22	or
3f4f3ab0	23	.Xr troff 1 .
01a500b1	24	The input files are copied to the standard output, except for lines between
3f4f3ab0 CL	25	\&.TS and
3f4f3ab0 CL	26	\&.TE command lines, which are assumed to describe tables
01a500b1 KM	27	and are reformatted.
01a500b1 KM	28	Details are given in the
3f4f3ab0	29	.%T TBL
01a500b1	30	reference manual.
3f4f3ab0 CL	31	.Sh EXAMPLE
	32	.Pp
	33	As an example, letting \et represent a tab (which should be typed as a genuine
01a500b1	34	tab) the input
3f4f3ab0	35	.Bd -literal -offset indent
09251a32	36	\&.TS
09251a32 KM	37	c s s
	38	c c s
	39	c c c
	40	l n n.
	41	Household Population
	42	Town\\tHouseholds
	43	\\tNumber\\tSize
	44	Bedminster\\t789\\t3.26
	45	Bernards Twp.\\t3087\\t3.74
	46	Bernardsville\\t2018\\t3.30
	47	Bound Brook\\t3425\\t3.04
	48	Branchburg\\t1644\\t3.49
	49	Bridgewater\\t7897\\t3.81
	50	Far Hills\\t240\\t3.19
	51	\&.TE
3f4f3ab0 CL	52	.Ed
3f4f3ab0 CL	53	.Pp
09251a32	54	yields
3f4f3ab0	55	.Bd -unfilled -offset indent
09251a32	56	.ne 10
09251a32 KM	57	.TS
09251a32 KM	58	.nr 35 \n(.u
09251a32 KM	59	.nr 79 0n
	60	.nr 80 \n(79
	61	.nr 40 \n(79
	62	.nr 38 \n(79+\w!Town!
	63	.if \n(80<\n(38 .nr 80 \n(38
	64	.nr 38 \n(79+\w!!
	65	.if \n(80<\n(38 .nr 80 \n(38
	66	.nr 38 \n(79+\w!Bedminster!
	67	.if \n(80<\n(38 .nr 80 \n(38
	68	.nr 38 \n(79+\w!Bernards Twp.!
	69	.if \n(80<\n(38 .nr 80 \n(38
	70	.nr 38 \n(79+\w!Bernardsville!
	71	.if \n(80<\n(38 .nr 80 \n(38
	72	.nr 38 \n(79+\w!Bound Brook!
	73	.if \n(80<\n(38 .nr 80 \n(38
	74	.nr 38 \n(79+\w!Branchburg!
	75	.if \n(80<\n(38 .nr 80 \n(38
	76	.nr 38 \n(79+\w!Bridgewater!
	77	.if \n(80<\n(38 .nr 80 \n(38
	78	.nr 38 \n(79+\w!Far Hills!
	79	.if \n(80<\n(38 .nr 80 \n(38
	80	.nr 81 \n(80
	81	.nr 41 \n(80
	82	.nr 38 \n(80+\w!Number!
	83	.if \n(81<\n(38 .nr 81 \n(38
	84	.nr 31 0
	85	.nr 32 0
	86	.nr 38 \w!789!
	87	.if \n(31<\n(38 .nr 31 \n(38
	88	.nr 38 \w!!
	89	.if \n(32<\n(38 .nr 32 \n(38
	90	.nr 38 \w!3087!
	91	.if \n(31<\n(38 .nr 31 \n(38
	92	.nr 38 \w!!
	93	.if \n(32<\n(38 .nr 32 \n(38
	94	.nr 38 \w!2018!
	95	.if \n(31<\n(38 .nr 31 \n(38
	96	.nr 38 \w!!
	97	.if \n(32<\n(38 .nr 32 \n(38
	98	.nr 38 \w!3425!
	99	.if \n(31<\n(38 .nr 31 \n(38
	100	.nr 38 \w!!
	101	.if \n(32<\n(38 .nr 32 \n(38
	102	.nr 38 \w!1644!
	103	.if \n(31<\n(38 .nr 31 \n(38
	104	.nr 38 \w!!
	105	.if \n(32<\n(38 .nr 32 \n(38
	106	.nr 38 \w!7897!
	107	.if \n(31<\n(38 .nr 31 \n(38
	108	.nr 38 \w!!
	109	.if \n(32<\n(38 .nr 32 \n(38
	110	.nr 38 \w!240!
	111	.if \n(31<\n(38 .nr 31 \n(38
	112	.nr 38 \w!!
	113	.if \n(32<\n(38 .nr 32 \n(38
	114	.nr 61 \n(80+\n(31
	115	.nr 38 \n(61+\n(32
	116	.if \n(38>\n(81 .nr 81 \n(38
	117	.if \n(38<\n(81 .nr 61 +(\n(81-\n(38)/2
	118	.nr 82 \n(81
	119	.nr 42 \n(81
	120	.nr 38 \n(81+\w!Size!
	121	.if \n(82<\n(38 .nr 82 \n(38
	122	.nr 31 0
123	.nr 32 0
124	.nr 38 \w!3!
125	.if \n(31<\n(38 .nr 31 \n(38
126	.nr 38 \w!.26!
127	.if \n(32<\n(38 .nr 32 \n(38
128	.nr 38 \w!3!
129	.if \n(31<\n(38 .nr 31 \n(38
130	.nr 38 \w!.74!
131	.if \n(32<\n(38 .nr 32 \n(38
132	.nr 38 \w!3!
133	.if \n(31<\n(38 .nr 31 \n(38
134	.nr 38 \w!.30!
135	.if \n(32<\n(38 .nr 32 \n(38
136	.nr 38 \w!3!
137	.if \n(31<\n(38 .nr 31 \n(38
138	.nr 38 \w!.04!
139	.if \n(32<\n(38 .nr 32 \n(38
140	.nr 38 \w!3!
141	.if \n(31<\n(38 .nr 31 \n(38
142	.nr 38 \w!.49!
143	.if \n(32<\n(38 .nr 32 \n(38
144	.nr 38 \w!3!
145	.if \n(31<\n(38 .nr 31 \n(38
146	.nr 38 \w!.81!
147	.if \n(32<\n(38 .nr 32 \n(38
148	.nr 38 \w!3!
149	.if \n(31<\n(38 .nr 31 \n(38
150	.nr 38 \w!.19!
151	.if \n(32<\n(38 .nr 32 \n(38
152	.nr 62 \n(81+\n(31
153	.nr 38 \n(62+\n(32
154	.if \n(38>\n(82 .nr 82 \n(38
155	.if \n(38<\n(82 .nr 62 +(\n(82-\n(38)/2
156	.nr 38 \n(79+\w!Household Population!-\n(82
157	.if \n(38>0 .nr 38 \n(38/2
158	.if \n(38<0 .nr 38 0
159	.nr 61 +1*\n(38
160	.nr 81 +1*\n(38
161	.nr 41 +1*\n(38
162	.nr 62 +2*\n(38
163	.nr 82 +2*\n(38
164	.nr 42 +2*\n(38
165	.nr 38 \n(80+\w!Households!-\n(82
166	.if \n(38>0 .nr 38 \n(38/1
167	.if \n(38<0 .nr 38 0
168	.nr 62 +1*\n(38
169	.nr 82 +1*\n(38
170	.nr 42 +1*\n(38
171	.nr 38 1n
172	.nr 41 +3*\n(38
173	.nr 81 +3*\n(38
174	.nr 61 +3*\n(38
175	.if n .if \n(61%24>0 .nr 61 +12u
176	.nr 42 +6*\n(38
177	.nr 82 +6*\n(38
178	.nr 62 +6*\n(38
179	.if n .if \n(62%24>0 .nr 62 +12u
180	.nr TW \n(82
181	.fc ! :
182	.ta \n(82u
183	\&!:Household Population:!
184	.ta \n(80u \n(82u
185	\&\h'\|\n(40u'!:Town:!\h'\|\n(41u'!:Households:!
186	.ta \n(80u \n(81u \n(82u
187	\&\h'\|\n(40u'!::!\h'\|\n(41u'!:Number:!\h'\|\n(42u'!:Size:!
188	.ta \n(80u \n(61u \n(62u \n(82u
189	\&\h'\|\n(40u'!Bedminster:!\h'\|\n(41u'!:789!\h'\|\n(42u'!:3!!.26:!
190	.ta \n(80u \n(61u \n(62u \n(82u
191	\&\h'\|\n(40u'!Bernards Twp.:!\h'\|\n(41u'!:3087!\h'\|\n(42u'!:3!!.74:!
192	.ta \n(80u \n(61u \n(62u \n(82u
193	\&\h'\|\n(40u'!Bernardsville:!\h'\|\n(41u'!:2018!\h'\|\n(42u'!:3!!.30:!
194	.ta \n(80u \n(61u \n(62u \n(82u
195	\&\h'\|\n(40u'!Bound Brook:!\h'\|\n(41u'!:3425!\h'\|\n(42u'!:3!!.04:!
196	.ta \n(80u \n(61u \n(62u \n(82u
197	\&\h'\|\n(40u'!Branchburg:!\h'\|\n(41u'!:1644!\h'\|\n(42u'!:3!!.49:!
198	.ta \n(80u \n(61u \n(62u \n(82u
199	\&\h'\|\n(40u'!Bridgewater:!\h'\|\n(41u'!:7897!\h'\|\n(42u'!:3!!.81:!
200	.ta \n(80u \n(61u \n(62u \n(82u
201	\&\h'\|\n(40u'!Far Hills:!\h'\|\n(41u'!:240!\h'\|\n(42u'!:3!!.19:!
202	.fc
203	.mk ##
204	.nr ## -1v
205	.if \n(35>0 .fi
206	.TE
3f4f3ab0 CL	207	.Ed
3f4f3ab0 CL	208	.Pp
09251a32	209	If no arguments are given,
3f4f3ab0	210	.Nm tbl
01a500b1	211	reads the standard input, so it may be used as a filter. When
3f4f3ab0	212	.Nm tbl
01a500b1	213	is used with
3f4f3ab0	214	.Xr eqn
09251a32	215	or
3f4f3ab0	216	.Xr neqn
09251a32	217	the
3f4f3ab0	218	.Nm tbl
01a500b1	219	command should be first, to minimize the volume of data passed through pipes.
3f4f3ab0 CL	220	.Sh SEE ALSO
	221	.Xr troff 1 ,
	222	.Xr eqn 1
	223	.Rs
	224	.%T TBL ,
	225	.%A M. E. Lesk .
	226	.Re
	227	.Sh HISTORY
	228	The
	229	.Nm
	230	command appeared in Version 7 AT&T UNIX.