Research V7 development
[unix-history] / usr / doc / tbl
CommitLineData
9fd6cc84
ML
1.if \nM=0 .RP
2.TM 76-1274-5 39199 39199-11
3.if \n(tm>0 .ND June 11, 1976*
4.TL
5Tbl \(em A Program to Format Tables
6.AU "MH 2C-569" 6377
7M. E. Lesk
8.AI
9.MH
10.if \n(tm>0 .FS
11.if \n(tm>0 * This printing revised through August 5, 1977
12.if \n(tm>0 .FE
13.AB
14.I
15Tbl
16.R
17is a document formatting preprocessor for
18.I
19troff
20.R
21or
22.I
23nroff
24.R
25which makes
26even
27fairly complex tables easy to specify and enter.
28It is available on
29the
30.SM
31PDP-11 UNIX*
32.NL
33system
34.FS
35* UNIX is a Trademark/Service Mark of the Bell System
36.FE
37and on Honeywell 6000
38.SM
39GCOS.
40.NL
41Tables are made up of columns which may be independently centered, right-adjusted,
42left-adjusted, or aligned by decimal points.
43Headings may be placed over single columns or groups of columns.
44A table entry may contain equations, or may consist of several rows of text.
45Horizontal or vertical lines may be drawn as desired
46in the table,
47and any table or element may be enclosed in a box.
48For example:
49.in 0
50.ll
51.sp .5
52.TS
53center, box;
54c s s s
55c s s s
56c |c |c |c
57c |c |c |c
58l |n |n |n.
591970 Federal Budget Transfers
60\s-2(in billions of dollars)\s0
61=
62State Taxes Money Net
63\^ collected spent \^
64_
65New York 22.91 21.35 \-1.56
66New Jersey 8.33 6.96 \-1.37
67Connecticut 4.12 3.10 \-1.02
68Maine 0.74 0.67 \-0.07
69California 22.29 22.42 +0.13
70New Mexico 0.70 1.49 +0.79
71Georgia 3.30 4.28 +0.98
72Mississippi 1.15 2.32 +1.17
73Texas 9.33 11.13 +1.80
74.TE
75.AE
76.OK
77Phototypesetting
78Documentation
79.CS 16 0 16 0 12 6
80.tr #
81.de e1
82.nr \\$1 \\$2
83..
84.de e2
85.if !\\n(\\$1=\\n% .tm Error in example \\$1: referred to page \\n(\\$1, is on page \\n%
86.rr \\$1
87..
88.di qq
89.EQ
90delim $$
91.EN
92.di
93.rm qq
94.SH
95Introduction.
96.PP
97.I
98Tbl
99.R
100turns a simple description
101of a table into a
102.I
103troff
104.R
105or
106.I
107nroff
108.R
109[1]
110program (list of commands) that prints the table.
111.I
112Tbl
113.R
114may be used on the
115\s-2PDP-\s011 \s-2UNIX\s0
116.NL
117[2] system and on the Honeywell 6000
118.SM
119GCOS
120.NL
121system.
122It
123attempts to isolate a portion of a job that it can
124successfully
125handle and leave the remainder for other programs.
126Thus
127.I
128tbl
129.R
130may be used with the equation formatting
131program
132.I
133eqn
134.R
135[3]
136or various
137layout macro packages
138[4,5,6],
139but does not duplicate their functions.
140.PP
141This memorandum is divided into two parts.
142First we give the rules for preparing
143.I
144tbl
145.R
146input; then some examples are shown.
147The description of rules is precise but technical, and
148the beginning user may prefer to read the examples first,
149as they show some common table arrangements.
150A section explaining how to invoke
151.I
152tbl
153.R
154precedes the examples.
155To avoid repetition, henceforth read
156.I
157troff
158.R
159as
160.I
161``troff
162.R
163or
164.I
165nroff.''
166.R
167.ds . \^\s14.\s0
168.PP
169The input to
170.I
171tbl
172.R
173is text for a document, with tables preceded by a ``\*.TS''
174(table start)
175command and followed by a ``\*.TE''
176(table end) command.
177.I
178Tbl
179.R
180processes the tables, generating
181.I
182troff
183.R
184formatting commands,
185and leaves the remainder of the text unchanged.
186The ``\*.TS'' and ``\*.TE''
187lines are copied, too, so that
188.I
189troff
190.R
191page layout macros
192(such as the memo formatting macros [4]\|) can use these lines
193to delimit and place tables as they see fit.
194In particular, any arguments on the ``\*.TS'' or ``\*.TE''
195lines
196are copied but otherwise ignored, and may be used by document layout
197macro commands.
198.PP
199The format of the input is as follows:
200.DS
201\&text
202\&\*.TS
203\&\fItable\fR
204\&\*.TE
205\&text
206\&\*.TS
207\&\fItable\fR
208\&\*.TE
209\&text
210\&\&\*. \*. \*.
211.DE
212where the format of each table is as follows:
213.DS
214\&\*.TS
215\fIoptions \fB;\fR
216\fIformat \*.
217data
218\&\fR\*.TE
219.DE
220Each table is independent, and must contain formatting
221information
222followed by the data to be entered in the table.
223The formatting information, which describes the
224individual columns and rows of the table, may be preceded
225by a few options that affect the entire table.
226A detailed description of tables is given in the next section.
227.sp .5
228.SH
229Input commands.
230.PP
231As indicated above, a table contains, first, global options,
232then a format section describing the layout of the table
233entries, and then the data to be printed. The format and data
234are always required, but not the options.
235The various parts of the table are entered as follows:
236.sp .5v
237.IP 1)
238O\s-2PTIONS.\s0
239There may be a single line of options
240affecting the whole table.
241If present, this line must follow the \*.TS line immediately
242and must contain a list of option names
243separated by spaces, tabs, or commas, and must be terminated by a semicolon.
244The allowable options are:
245.RS
246.IP \fB##center\fR 13
247\(em center the table (default is left-adjust);
248.IP \fB##expand\fR
249\(em make the table as wide as the current line length;
250.IP \fB##box\fR
251\(em enclose the table in a box;
252.IP \fB##allbox\fR
253\(em enclose each item in the table in a box;
254.IP \fB##doublebox\fR
255\(em enclose the table in two boxes;
256.IP \fB##tab#\fR(\fIx\fR\^)
257\(em use \fIx\fR instead of tab to separate data items.
258.IP \fB##linesize#(\fIn\fR\^)
259\(em set lines or rules (e.g. from \fBbox\fR\^) in \fIn\fR point type;
260.IP \fB##delim#(\fIxy\fR\^)
261\(em recognize \fIx\fR and \fIy\fR as the \fIeqn\fR delimiters.
262.RE
263.LP
264.ns
265.IP
266The
267.I
268tbl
269.R
270program
271tries to keep boxed tables on one page by issuing
272appropriate ``need'' (\fI\*.ne\fR\|) commands.
273These requests are calculated from the number of lines in the tables,
274and if there are spacing commands embedded in the input, these requests may be inaccurate;
275use normal
276.I
277troff
278.R
279procedures, such as keep-release macros, in that case.
280The user who must have a multi-page boxed table
281should use macros designed for this purpose,
282as explained below under `Usage.'
283.sp .5v
284.IP 2) 5
285F\s-2ORMAT\s0.
286The format section of the table specifies the layout
287of the columns.
288Each line in this section corresponds to one line
289of the table (except that the last line corresponds to all following
290lines up to the next \*.T&, if any \(em see below),
291and each line contains a key-letter for each column
292of the table.
293It is good practice to separate the key letters for each
294column by spaces or tabs.
295Each key-letter is one of the following:
296.RS
297.cs B 25
298.IP "##\fBL\fR#or#\fBl\fR" 10
299to indicate a left-adjusted column entry;
300.IP "##\fBR\fR#or#\fBr\fR
301to indicate a right-adjusted column entry;
302.IP "##\fBC\fR#or#\fBc\fR
303to indicate a centered column entry;
304.IP "##\fBN\fR#or#\fBn\fR
305to indicate a numerical column entry, to be aligned with other
306numerical entries so that the units digits of numbers line up;
307.IP "##\fBA\fR#or#\fBa\fR
308to indicate an alphabetic subcolumn;
309all corresponding entries are aligned on the left, and positioned
310so that the widest is centered within the column (see
311example on page 12);
312.IP "##\fBS\fR#or#\fBs\fR
313to indicate a spanned heading, i.e. to indicate that the
314entry from the previous column continues across this
315column
316(not allowed for the first column, obviously); or
317.IP ##\fB\s+4\v'6p'^\v'-6p'\s0\fR
318to indicate a vertically spanned heading, i.e. to indicate that
319the entry from the previous row continues down through this row.
320(Not allowed for the first row of the table, obviously).
321.cs B
322.RE
323.LP
324.ns
325.IP
326When numerical alignment is specified, a location for the decimal
327point is sought. The rightmost dot (\*.)
328adjacent to a digit is used as a decimal point; if there is no
329dot adjoining a digit, the rightmost digit is used as a units digit;
330if no alignment is indicated, the item is centered in the column.
331However, the special non-printing character string \e& may be used
332to override unconditionally dots
333and digits, or to align alphabetic data;
334this string lines up where a dot normally would,
335and then disappears from the final output.
336In the example below, the items shown at the left will be
337aligned (in a numerical column) as shown on the right:
338.KS
339.TS
340center;
341l6 n.
34213 13
3434\*.2 4\&\*.2
34426\*.4\*.12 26\*.4\&\*.12
345abc abc
346abc\e& abc\&
34743\e&3\*.22 43\&3\*.22
348749\*.12 749\&\*.12
349.TE
350.KE
351.IP
352\fBNote:\fR
353If numerical data are used in the same column with wider
354.B L
355or
356.B r
357type table entries, the widest \fInumber\fR is centered relative
358to the wider
359.B L
360or
361.B r
362items (\fBL\fR is used instead of \fBl\fR for readability;
363they have the same meaning as key-letters).
364Alignment within the numerical items is preserved.
365This is similar to the behavior of
366.B a
367type data, as explained above.
368However,
369alphabetic subcolumns (requested by the
370.B
371a
372.R
373key-letter)
374are always slightly indented relative to
375.B
376L
377.R
378items;
379if necessary, the column width is increased to force this.
380This is not true for \fBn\fR type entries.
381.IP
382.bd I 3
383.ft I
384Warning:
385.ft 1
386.bd I
387the \fBn\fR and \fBa\fR items should not be used in
388the same column.
389.IP
390For readability, the key-letters describing each column should
391be separated by spaces.
392The end of the format section is indicated by a period.
393The layout of the key-letters in the format section resembles
394the layout of the actual data in the table.
395Thus a simple format might appear as:
396.br
397.ne 3
398.in +2
399.nf
400c s s
401l n n \*.
402.fi
403.in -2
404which specifies a table of three columns. The first line
405of the table contains a heading centered across all three
406columns; each remaining line contains a left-adjusted item
407in the first column followed by two columns of numerical
408data.
409A sample table in this format might be:
410.br
411.ne 6v
412.br
413.in +4
414.TS
415c s s
416l n n.
417Overall title
418Item-a 34.22 9.1
419Item-b 12.65 .02
420Items: c,d,e 23 5.8
421Total 69.87 14.92
422.TE
423.in -4
424There are some additional features of the key-letter system:
425.RS
426.IP "\fI##Horizontal lines#\fR"
427\(em A key-letter may be replaced by `\(ul'
428(underscore) to indicate
429a horizontal line in place of the corresponding column entry,
430or by `=' to indicate a double horizontal line.
431If an adjacent column contains a horizontal line, or if
432there are vertical lines adjoining this column,
433this horizontal line is extended to meet the nearby lines.
434If any data entry is provided for this column, it is ignored and
435a warning message is printed.
436.QQ do the D(x) and M(x) to draw a line of 'x' characters.
437.QQ D will draw divided lines, M merged lines. thus - is simplh M(\(ru)
438.IP "\fI##Vertical lines#\fR"
439\(em A vertical bar may be placed between column key-letters. This will
440cause a vertical line between the corresponding columns of the table.
441A vertical bar to the left of the first key-letter
442or to the right of the last one produces a line at the
443edge of the table.
444If two vertical bars appear between key-letters, a double vertical
445line is drawn.
446.IP "\fI##Space between columns#\fR"
447\(em A number may follow the key-letter. This indicates the amount of separation
448between this column and the next column.
449The number normally specifies the separation in
450.I
451ens
452.R
453(one
454en
455.ne 3
456is about the width of the letter `n').*
457.FS
458* More precisely, an en is a number of points (1 point = 1/72 inch)
459equal to half the current type size.
460.FE
461If the ``expand'' option is used, then these numbers are multiplied
462by a constant such that the table is as wide as the current line length.
463The default column separation number is 3.
464If the separation is changed the worst case (largest space requested) governs.
465.IP "\fI##Vertical spanning#\fR"
466\(em Normally, vertically spanned items extending over several
467rows of the table are centered in their vertical range.
468If a key-letter is followed by
469.B
470t
471.R
472or
473.B T ,
474any corresponding vertically spanned item
475will begin at the top line of its range.
476.IP "\fI##Font changes#\fR"
477\(em A key-letter may be followed by a string containing a font
478name or number
479preceded by the letter
480.B f
481or
482.B F .
483This indicates that the corresponding column should be in a different
484font from the default font (usually Roman).
485All font names are one or two letters; a one-letter font
486name should be separated from whatever follows by a space or tab.
487The single letters
488\f3B\f1, \f3b\f1, \f3I\f1,
489and
490\f3i\f1
491are shorter synonyms for
492.B f\^B
493and
494.B f\^I .
495Font change commands given with the table entries
496override these specifications.
497.IP "\fI##Point size changes#\fR"
498\(em A key-letter may be followed by the letter
499.B p
500or
501.B P
502and a number to indicate the point size of the corresponding table entries.
503The number may be a signed digit, in which case it is taken as
504an increment or decrement
505from the current point size.
506If both a point size and a column separation value are given,
507one or more blanks must separate them.
508.IP "\fI##Vertical spacing changes#\fR"
509\(em A key-letter may be followed by the letter
510.B v
511or
512.B V
513and a number to indicate the vertical line spacing to be used
514within a multi-line corresponding table entry.
515The number may be a signed digit, in which case it is taken as an increment
516or decrement from the current vertical spacing.
517A column separation value must be separated by blanks or some other
518specification from a vertical spacing request.
519This request has no effect unless the corresponding table entry
520is a text block (see below).
521.IP "\fI##Column width indication#\fR"
522\(em A key-letter may be followed by the letter
523.B w
524or
525.B W
526and a width value in parentheses.
527This width is used as a minimum column width.
528If the largest element in the column is not as wide as the width value
529given after the \fBw\fR, the largest element is assumed to be that wide.
530If the largest element in the column is wider than the specified value,
531its width is used.
532The width is also used as a default line
533length for included text blocks.
534Normal
535.I
536troff
537.R
538units can be used to scale the width value; if none are used,
539the default is
540ens.
541If the width specification is a unitless integer
542the parentheses may be omitted.
543If the width value is changed in a column, the \fIlast\fR one given controls.
544.IP "\fI##Equal width columns#\fR"
545\(em A key-letter may be followed by the letter
546.B e
547or
548.B E
549to indicate equal width columns.
550All columns whose
551key-letters are followed by \fBe\fR or \fBE\fR are made the same width.
552This permits the user to get a group of regularly spaced
553columns.
554.IP "##\fBNote:\fR#"
555The order of the above features is immaterial; they need not be separated
556by spaces, except as indicated above to avoid ambiguities involving
557point size and font changes. Thus
558a numerical column entry in italic font and 12 point type with a minimum
559width of 2.5 inches and separated by 6 ens from the next column could
560be specified as
561.in +5
562np12w(2\*.5i)f\|I 6
563.in -5
564.IP "\fI##Alternative notation#\fR"
565\(em Instead of listing the format of successive lines of a table
566on consecutive lines of the format section,
567successive line formats may be given on the same line, separated
568by commas, so that the format for the example
569above might have been written:
570.in +5
571c s s, l n n \*.
572.in -5
573.IP "\fI##Default#\fR"
574\(em Column descriptors missing from the end
575of a format line are assumed to be \fBL\fR.
576The longest line in the format section, however,
577defines the number of columns
578in the table;
579extra columns in the data are ignored silently.
580.QQ put in the diagnostics.
581.RE
582.sp .5v
583.IP 3)
584D\s-2ATA\s0.
585The data for the table are typed after the format.
586Normally, each table line is typed as one line of data.
587Very long input lines can be broken: any line whose last character is
588\e is combined with the following line (and the \e vanishes).
589The data for different columns (the table entries) are separated by tabs,
590or by whatever character has been specified in the option
591.I tabs
592option.
593There are a few special cases:
594.RS
595.IP "\fI##Troff commands within tables\fR#"
596\(em An input line
597beginning with a `\*.' followed by anything
598but a number is assumed to be a command to
599.I
600troff
601.R
602and is passed through unchanged, retaining its position in the table.
603So, for example, space within a table may be produced by ``\*.sp''
604commands
605in the data.
606.IP "\fI##Full width horizontal lines\fR#"
607\(em An input
608.I line
609containing only the character $fat "\(ul" $ (underscore)
610or \fB=\fR (equal sign) is taken to be a single or double
611line, respectively, extending the
612full width
613of the
614.I table.
615.IP "\fI##Single column horizontal lines\fR#"
616\(em An input table
617.I entry
618containing only the character $fat "\(ul" $ or \fB=\fR
619is taken to be a single or double line extending
620the full width of the
621.I column.
622Such lines are extended to meet horizontal or vertical
623lines adjoining this column.
624To obtain these characters explicitly in a column, either
625precede them by \e& or
626follow them by a space before the usual tab or newline.
627.IP "\fI##Short horizontal lines\fR#"
628\(em An input table
629.I entry
630containing only the string $fat "\e\(ul"$
631is taken to be a single line as wide as the contents of
632the column. It is not extended to meet
633adjoining lines.
634.IP "\fI##Repeated characters\fR#"
635\(em An input table
636.I entry
637containing only a string of the form $fat "\e"$\f3R\f2x\f1
638where
639.I x
640is any character is replaced by repetitions of the character
641.I x
642as wide as the data in the column.
643The sequence of
644.I x 's
645is not extended to meet adjoining columns.
646.IP "\fI##Vertically spanned items\fR#"
647\(em An input table entry containing only the
648character string
649.ft B
650\e\s+2\v'2p'^\v'-2p'\s0
651.ft R
652indicates that the table entry immediately
653above spans downward over this row. It is equivalent
654to a table format key-letter of `^'.
655.IP "\fI##Text blocks\fR#"
656\(em In order to include a block of text as a table entry,
657precede it by $fat roman "T{" $ and follow
658it by $fat roman "T}" $.
659Thus the sequence
660.in +2
661.nf
662 \*. \*. \*. $fat roman "T{"$
663.I
664 block of
665 text
666.R
667 $fat roman "T}"$ \*. \*. \*.
668.in -2
669.fi
670is the way to enter, as a single entry in the table, something
671that cannot conveniently be typed as a simple string between
672tabs.
673Note that the $fat roman "T}" $ end delimiter must begin a line;
674additional columns of data may follow after a tab on the same line.
675See the example on page 10 for an illustration of included text blocks
676.e1 aa 10
677in a table.
678If more than twenty or thirty text blocks are used in a table,
679various limits in the
680.I
681troff
682.R
683program are likely to be exceeded,
684producing diagnostics such as `too many string/macro names' or `too many
685number registers.'
686.IP
687Text blocks are pulled out from the table, processed separately by
688.I
689troff,
690.R
691and replaced in the table as a solid block. If no line length
692is specified in the
693.I
694block of text
695.R
696itself, or in the table format,
697the default is to use
698$ L times C / (N+1) $
699where
700.I
701L
702.R
703is the current line length,
704.I
705C
706.R
707is the number of table columns spanned by the text,
708and
709.I
710N
711.R
712is the total number of columns in the table.
713The other parameters (point size, font, etc.) used in setting the
714.I
715block of text
716.R
717are those in effect at the beginning of the table (including
718the effect of the ``\*.TS'' macro)
719and any table format specifications of size, spacing and font,
720using the \fBp\fR, \fBv\fR and \fBf\fR modifiers to the column key-letters.
721Commands within the text block itself are also recognized, of course.
722However,
723.I troff
724commands within the table data but not within the text block
725do not affect that block.
726.br
727.di RR
728. this is going down a rathole
729.EQ
730delim off
731.EN
732.di
733.rm RR
734.IP "##\fBWarnings:\fR#"
735\(em Although any number of lines may be present in a table,
736only the first 200 lines are used in calculating
737the widths of the various columns. A multi-page table,
738of course, may be arranged as several single-page tables
739if this proves to be a problem.
740Other difficulties with formatting may arise because,
741in the calculation of column widths all table entries
742are assumed to be in the font and size being used when
743the ``\*.TS'' command was encountered, except for font and size changes
744indicated (a) in the table format section and (b)
745within the table data (as in the entry
746\es+3\efIdata\efP\es0\|).
747Therefore, although arbitrary
748.I
749troff
750.R
751requests may be sprinkled in a table, care must be taken
752to avoid confusing the width calculations;
753use requests such as `\*.ps' with care.
754.tr ##
755.sp .5v
756.RE
757.IP 4)
758A\s-2DDITIONAL COMMAND LINES\s0.
759If the format of a table must be changed after
760many similar lines, as with sub-headings or summarizations, the ``\*.T&''
761(table continue)
762command can be used
763to change column parameters.
764The outline of such a table input is:
765.DS
766.ft R
767\&\*.TS
768.ft I
769\&options \fB;\fP
770\&format \*.
771\&data
772\&\*. \*. \*.
773.ft R
774\&\*.T&
775.ft I
776\&format \*.
777\&data
778.ft R
779\&\*.T&
780.ft I
781\&format \*.
782\&data
783.ft R
784\&\*.TE
785.DE
786as in the examples on pages 10 and 12.
787.e1 ab 10
788.e1 ac 12
789Using this procedure, each table line can be close to its corresponding format line.
790.bd I 3
791.br
792.sp 3p
793.ft I
794Warning:
795.ft R
796.bd I
797it is not possible to change the number of columns, the space
798between columns, the global options such as \fIbox,\fR
799or the selection of columns to be made equal width.
800.SH
801Usage.
802.PP
803On
804\s-2UNIX\s0,
805.I
806tbl
807.R
808can be run on a simple table with the command
809.DS
810tbl input-file | troff
811.DE
812but
813for more complicated use, where there are several input files,
814and they contain equations and \fIms\fR memorandum layout commands as well
815as tables, the normal command would be
816.DS
817tbl file-1 file-2 \*. \*. \*. | eqn | troff \-ms
818.DE
819and, of course, the usual options may be used on the
820.I
821troff
822.R
823and
824.I
825eqn
826.R
827commands. The usage for
828.I
829nroff
830.R
831is similar
832to that for
833.I
834troff,
835.R
836but only
837\s-2TELETYPE\s+2\(rg Model 37 and
838Diablo-mechanism (\s-2DASI\s0 or \s-2GSI\s0)
839terminals can print boxed tables directly.
840.PP
841For the convenience of users employing line printers without
842adequate driving tables or post-filters, there is a special
843.I \-TX
844command line option to
845.I tbl
846which produces output that does not have fractional line
847motions in it.
848The only other command line options recognized by
849.I tbl
850are
851.I \-ms
852and
853.I \-mm
854which are turned into
855commands to fetch the corresponding macro files;
856usually it is more convenient to place these arguments
857on the
858.I troff
859part of the command line,
860but they are accepted by
861.I tbl
862as well.
863.PP
864Note that when
865.I
866eqn
867.R
868and
869.I
870tbl
871.R
872are used together on the same file
873.I
874tbl
875.R
876should be used first.
877If there are no equations within tables,
878either order works, but it is usually faster
879to run
880.I
881tbl
882.R
883first, since
884.I
885eqn
886.R
887normally produces a larger expansion of the input
888than
889.I
890tbl.
891.R
892However, if there are equations within tables
893(using the
894.I
895delim
896.R
897mechanism in
898.I
899eqn\fR),
900.I
901tbl
902.R
903must be first or the output will be scrambled.
904Users must also beware of using equations in
905\fBn\fR-style columns; this is nearly always wrong,
906since
907.I
908tbl
909.R
910attempts to split numerical format items into two parts and this
911is not possible with equations.
912The user can defend against this by giving the
913.I delim(xx)
914table option;
915this prevents splitting of numerical columns within the delimiters.
916For example, if the
917.I eqn
918delimiters
919are
920.I $$ ,
921giving
922.I delim($$)
923a numerical column such as
924``1245 $+- 16$''
925will be divided after 1245, not after 16.
926.PP
927.I
928Tbl
929.R
930limits tables to twenty columns; however,
931use of more than 16 numerical columns may fail because of
932limits in
933.I
934troff,
935.R
936producing the `too many number registers' message.
937\fITroff\fR number registers used by
938.I
939tbl
940.R
941must be avoided by the user within tables;
942these include two-digit names from 31 to 99,
943and names of the forms
944#\fIx\fR, \fIx\fR+, \fIx\fR\ |, \v'3p'^\v'-3p'\fIx\fR, and \fIx\fR\(mi,
945where
946\fIx\fR is any lower case letter.
947The names
948##, #\(mi, and #^ are also used in certain circumstances.
949To conserve number register names, the
950\fBn\fR
951and
952\fBa\fR
953formats share a register;
954hence the restriction above that they may not be used in the same column.
955.PP
956For aid in writing layout macros,
957.I
958tbl
959.R
960defines a number register TW which is
961the table width; it is defined by the time that the ``\*.TE'' macro
962is invoked and may be used in the expansion of that macro.
963More importantly, to assist in laying out multi-page boxed tables
964the macro T# is defined to produce the bottom lines and side lines of a boxed
965table, and then invoked at its end. By use of this macro
966in the page footer a multi-page table can be boxed.
967In particular, the
968.I
969ms
970.R
971macros can be used to print a multi-page boxed table with a repeated heading
972by giving the
973argument H to the ``\*.TS'' macro.
974If the table start macro is written
975.br
976 \&\*.TS H
977.br
978a line of the form
979.br
980 \&\*.TH
981.br
982must be given in the table after any table heading (or at the start if none).
983Material up to the ``\*.TH'' is placed at the top of each page of table;
984the remaining lines in the table are placed on several pages as required.
985Note that this is
986.I
987not
988.R
989a feature of
990.I
991tbl,
992.R
993but of the \fIms\fR layout macros.
994.SH
995Examples.
996.PP
997Here are some examples illustrating features of
998.I
999tbl.
1000.R
1001.ds T \|\h'.4n'\v'-.2n'\s6\zT\s0\s10\v'.2n'\h'-.4n'\(ci\|\s0
1002The symbol \*T in the input represents a tab character.
1003.de IN
1004.po \\n(POu
1005.sp |\\n(.hu
1006.sp
1007.ne \\$1
1008.mk
1009.B
1010Input:
1011.R
1012.sp .5
1013.nf
1014.in +3n
1015..
1016.de OU
1017.br
1018.in -3n
1019.rt
1020.po +3i
1021.B
1022Output:
1023.R
1024.sp .5
1025..
1026.rm TS
1027.rm TE
1028.nf
1029.IN 2.5i
1030\&\*.TS
1031\&box;
1032\&c c c
1033\&l l l\*.
1034\&Language\*TAuthors\*TRuns on
1035\&
1036\&Fortran\*TMany\*TAlmost anything
1037\&PL/1\*TIBM\*T360/370
1038\&C\*TBTL\*T11/45,H6000,370
1039\&BLISS\*TCarnegie-Mellon\*TPDP-10,11
1040\&IDS\*THoneywell\*TH6000
1041\&Pascal\*TStanford\*T370
1042\&\*.TE
1043.OU
1044.TS
1045box;
1046c c c
1047l l l.
1048Language Authors Runs on
1049
1050Fortran Many Almost anything
1051PL/1 IBM 360/370
1052C BTL 11/45,H6000,370
1053BLISS Carnegie-Mellon PDP-10,11
1054IDS Honeywell H6000
1055Pascal Stanford 370
1056.TE
1057.IN 2.8i
1058\&\*.TS
1059\&allbox;
1060\&c s s
1061\&c c c
1062\&n n n\*.
1063\&AT&T Common Stock
1064\&Year\*TPrice\*TDividend
1065\&1971\*T41-54\*T$2\*.60
1066\&2\*T41-54\*T2\*.70
1067\&3\*T46-55\*T2\*.87
1068\&4\*T40-53\*T3\*.24
1069\&5\*T45-52\*T3\*.40
1070\&6\*T51-59\*T\*.95*
1071\&\*.TE
1072\&* (first quarter only)
1073.OU
1074.TS
1075allbox;
1076c s s
1077c c c
1078n n n.
1079AT&T Common Stock
1080Year Price Dividend
10811971 41-54 $2.60
10822 41-54 2.70
10833 46-55 2.87
10844 40-53 3.24
10855 45-52 3.40
10866 51-59 .95*
1087.TE
1088* (first quarter only)
1089.IN 4i
1090\&\*.TS
1091\&box;
1092\&c s s
1093\&c | c | c
1094\&l | l | n\*.
1095\&Major New York Bridges
1096\&=
1097\&Bridge\*TDesigner\*TLength
1098\&\(ul
1099\&Brooklyn\*TJ\*. A\*. Roebling\*T1595
1100\&Manhattan\*TG\*. Lindenthal\*T1470
1101\&Williamsburg\*TL\*. L\*. Buck\*T1600
1102\&\(ul
1103\&Queensborough\*TPalmer &\*T1182
1104\&\*T Hornbostel
1105\&\(ul
1106\&\*T\*T1380
1107\&Triborough\*TO\*. H\*. Ammann\*T\(ul
1108\&\*T\*T383
1109\&\(ul
1110\&Bronx Whitestone\*TO\*. H\*. Ammann\*T2300
1111\&Throgs Neck\*TO\*. H\*. Ammann\*T1800
1112\&\(ul
1113\&George Washington\*TO\*. H\*. Ammann\*T3500
1114\&\*.TE
1115.OU
1116.TS
1117box;
1118c s s
1119c | c | c
1120l | l | n.
1121Major New York Bridges
1122=
1123Bridge Designer Length
1124_
1125Brooklyn J. A. Roebling 1595
1126Manhattan G. Lindenthal 1470
1127Williamsburg L. L. Buck 1600
1128_
1129Queensborough Palmer & 1182
1130 Hornbostel
1131_
1132 1380
1133Triborough O. H. Ammann _
1134 383
1135_
1136Bronx Whitestone O. H. Ammann 2300
1137Throgs Neck O. H. Ammann 1800
1138_
1139George Washington O. H. Ammann 3500
1140.TE
1141.IN 3.0i
1142\&\*.TS
1143\&c c
1144\&np-2 | n | \*.
1145\&\*TStack
1146\&\*T\(ul
1147\&1\*T46
1148\&\*T\(ul
1149\&2\*T23
1150\&\*T\(ul
1151\&3\*T15
1152\&\*T\(ul
1153\&4\*T6\*.5
1154\&\*T\(ul
1155\&5\*T2\*.1
1156\&\*T\(ul
1157\&\*.TE
1158.OU
1159.TS
1160c c
1161np-2 | n |.
1162 Stack
1163 _
11641 46
1165 _
11662 23
1167 _
11683 15
1169 _
11704 6.5
1171 _
11725 2.1
1173 _
1174.TE
1175.IN 2.5i
1176\&\*.TS
1177\&box;
1178\&L L L
1179\&L L \(ul
1180\&L L | LB
1181\&L L \(ul
1182\&L L L\*.
1183\&january\*Tfebruary\*Tmarch
1184\&april\*Tmay
1185\&june\*Tjuly\*TMonths
1186\&august\*Tseptember
1187\&october\*Tnovember\*Tdecember
1188\&\*.TE
1189.OU
1190.TS
1191box;
1192L L L
1193L L _
1194L L | LB
1195L L _
1196L L L.
1197january february march
1198april may
1199june july Months
1200august september
1201october november december
1202.TE
1203.IN 5.0i
1204.e2 ab
1205\&\*.TS
1206\&box;
1207\&cfB s s s\*.
1208\&Composition of Foods
1209\&\(ul
1210\&\*.T&
1211\&c | c s s
1212\&c | c s s
1213\&c | c | c | c\*.
1214\&Food\*TPercent by Weight
1215\&\e^\*T\(ul
1216\&\e^\*TProtein\*TFat\*TCarbo-
1217\&\e^\*T\e^\*T\e^\*Thydrate
1218\&\(ul
1219\&\*.T&
1220\&l | n | n | n\*.
1221\&Apples\*T\*.4\*T\*.5\*T13\*.0
1222\&Halibut\*T18\*.4\*T5\*.2\*T\*. \*. \*.
1223\&Lima beans\*T7\*.5\*T\*.8\*T22\*.0
1224\&Milk\*T3\*.3\*T4\*.0\*T5\*.0
1225\&Mushrooms\*T3\*.5\*T\*.4\*T6\*.0
1226\&Rye bread\*T9\*.0\*T\*.6\*T52\*.7
1227\&\*.TE
1228.OU
1229.TS
1230box;
1231cfB s s s.
1232Composition of Foods
1233_
1234.T&
1235c |c s s
1236c |c s s
1237c |c |c |c.
1238Food Percent by Weight
1239\^ _
1240\^ Protein Fat Carbo-
1241\^ \^ \^ hydrate
1242_
1243.T&
1244l |n |n |n.
1245Apples .4 .5 13.0
1246Halibut 18.4 5.2 ...
1247Lima beans 7.5 .8 22.0
1248Milk 3.3 4.0 5.0
1249Mushrooms 3.5 .4 6.0
1250Rye bread 9.0 .6 52.7
1251.TE
1252.IN 3.7i
1253.e2 aa
1254\&\*.TS
1255\&allbox;
1256\&cfI s s
1257\&c cw(1i) cw(1i)
1258\&lp9 lp9 lp9\*.
1259\&New York Area Rocks
1260\&Era\*TFormation\*TAge (years)
1261\&Precambrian\*TReading Prong\*T>1 billion
1262\&Paleozoic\*TManhattan Prong\*T400 million
1263\&Mesozoic\*TT{
1264\&\*.na
1265\&Newark Basin, incl\*.
1266\&Stockton, Lockatong, and Brunswick
1267\&formations; also Watchungs
1268\&and Palisades\*.
1269\&T}\*T200 million
1270\&Cenozoic\*TCoastal Plain\*TT{
1271\&On Long Island 30,000 years;
1272\&Cretaceous sediments redeposited
1273\&by recent glaciation\*.
1274\&\*.ad
1275\&T}
1276\&\*.TE
1277.OU
1278.fi
1279.TS
1280allbox;
1281cfI s s
1282c cw(1i) cw(1i)
1283lp9 lp9 lp9.
1284New York Area Rocks
1285Era Formation Age (years)
1286Precambrian Reading Prong >1 billion
1287Paleozoic Manhattan Prong 400 million
1288Mesozoic T{
1289.na
1290Newark Basin, incl.
1291Stockton, Lockatong, and Brunswick
1292formations; also Watchungs
1293and Palisades.
1294T} 200 million
1295Cenozoic Coastal Plain T{
1296On Long Island 30,000 years;
1297Cretaceous sediments redeposited
1298by recent glaciation.
1299.ad
1300T}
1301.TE
1302.IN 2i
1303\&\*.EQ
1304\&delim $$
1305\&\*.EN
1306.sp
1307\&\*. \*. \*.
1308.sp
1309\&\*.TS
1310\&doublebox;
1311\&c c
1312\&l l\*.
1313\&Name\*TDefinition
1314\&\*.sp
1315\&\*.vs +2p
1316\&Gamma\*T$GAMMA (z) = int sub 0 sup inf t sup {z-1} e sup -t dt$
1317\&Sine\*T$sin (x) = 1 over 2i ( e sup ix - e sup -ix )$
1318\&Error\*T$ roman erf (z) = 2 over sqrt pi int sub 0 sup z e sup {-t sup 2} dt$
1319\&Bessel\*T$ J sub 0 (z) = 1 over pi int sub 0 sup pi cos ( z sin theta ) d theta $
1320\&Zeta\*T$ zeta (s) = sum from k=1 to inf k sup -s ~~( Re~s > 1)$
1321\&\*.vs -2p
1322\&\*.TE
1323.di qq
1324.EQ
1325delim $$
1326.EN
1327.di
1328.rm qq
1329.rs
1330.OU
1331.TS
1332doublebox;
1333c c
1334l l.
1335Name Definition
1336.sp
1337.vs +2p
1338Gamma $GAMMA (z) = int sub 0 sup inf t sup {z-1} e sup -t dt$
1339Sine $sin (x) = 1 over 2i ( e sup ix - e sup -ix )$
1340Error $ roman erf (z) = 2 over sqrt pi int sub 0 sup z e sup {-t sup 2} dt$
1341Bessel $ J sub 0 (z) = 1 over pi int sub 0 sup pi cos ( z sin theta ) d theta $
1342Zeta $ zeta (s) = sum from k=1 to inf k sup -s ~~( Re~s > 1)$
1343.vs -2p
1344.TE
1345.ds : \|:\|
1346.IN 2i
1347\&\*.TS
1348\&box, tab(\*:);
1349\&cb s s s s
1350\&cp-2 s s s s
1351\&c |\|| c | c | c | c
1352\&c |\|| c | c | c | c
1353\&r2 |\|| n2 | n2 | n2 | n\*.
1354\&Readability of Text
1355\&Line Width and Leading for 10-Point Type
1356\&=
1357\&Line\*:Set\*:1-Point\*:2-Point\*:4-Point
1358\&Width\*:Solid\*:Leading\*:Leading\*:Leading
1359\&_
1360\&9 Pica\*:\e-9\*.3\*:\e-6\*.0\*:\e-5\*.3\*:\e-7\*.1
1361\&14 Pica\*:\e-4\*.5\*:\e-0\*.6\*:\e-0\*.3\*:\e-1\*.7
1362\&19 Pica\*:\e-5\*.0\*:\e-5\*.1\*: 0\*.0\*:\e-2\*.0
1363\&31 Pica\*:\e-3\*.7\*:\e-3\*.8\*:\e-2\*.4\*:\e-3\*.6
1364\&43 Pica\*:\e-9\*.1\*:\e-9\*.0\*:\e-5\*.9\*:\e-8\*.8
1365\&\*.TE
1366.OU
1367.TS
1368box, tab(:);
1369cb s s s s
1370cp-2 s s s s
1371c ||c |c |c |c
1372c ||c |c |c |c
1373r2 ||n2 |n2 |n2 |n.
1374Readability of Text
1375Line Width and Leading for 10-Point Type
1376=
1377Line:Set:1-Point:2-Point:4-Point
1378Width:Solid:Leading:Leading:Leading
1379_
13809 Pica:\-9.3:\-6.0:\-5.3:\-7.1
138114 Pica:\-4.5:\-0.6:\-0.3:\-1.7
138219 Pica:\-5.0:\-5.1: 0.0:\-2.0
138331 Pica:\-3.7:\-3.8:\-2.4:\-3.6
138443 Pica:\-9.1:\-9.0:\-5.9:\-8.8
1385.TE
1386.IN 7i
1387.e2 ac
1388\&\*.TS
1389\&c s
1390\&cip-2 s
1391\&l n
1392\&a n\*.
1393\&Some London Transport Statistics
1394\&(Year 1964)
1395\&Railway route miles\*T244
1396\&Tube\*T66
1397\&Sub-surface\*T22
1398\&Surface\*T156
1399\&\*.sp \*.5
1400\&\*.T&
1401\&l r
1402\&a r\*.
1403\&Passenger traffic \e- railway
1404\&Journeys\*T674 million
1405\&Average length\*T4\*.55 miles
1406\&Passenger miles\*T3,066 million
1407\&\*.T&
1408\&l r
1409\&a r\*.
1410\&Passenger traffic \e- road
1411\&Journeys\*T2,252 million
1412\&Average length\*T2\*.26 miles
1413\&Passenger miles\*T5,094 million
1414\&\*.T&
1415\&l n
1416\&a n\*.
1417\&\*.sp \*.5
1418\&Vehicles\*T12,521
1419\&Railway motor cars\*T2,905
1420\&Railway trailer cars\*T1,269
1421\&Total railway\*T4,174
1422\&Omnibuses\*T8,347
1423\&\*.T&
1424\&l n
1425\&a n\*.
1426\&\*.sp \*.5
1427\&Staff\*T73,739
1428\&Administrative, etc\*.\*T5,582
1429\&Civil engineering\*T5,134
1430\&Electrical eng\*.\*T1,714
1431\&Mech\*. eng\*. \e- railway\*T4,310
1432\&Mech\*. eng\*. \e- road\*T9,152
1433\&Railway operations\*T8,930
1434\&Road operations\*T35,946
1435\&Other\*T2,971
1436\&\*.TE
1437.OU
1438.TS
1439c s
1440cip-2 s
1441l n
1442a n.
1443Some London Transport Statistics
1444(Year 1964)
1445Railway route miles 244
1446Tube 66
1447Sub-surface 22
1448Surface 156
1449.sp .5
1450.T&
1451l r
1452a r.
1453Passenger traffic \(mi railway
1454Journeys 674 million
1455Average length 4.55 miles
1456Passenger miles 3,066 million
1457.T&
1458l r
1459a r.
1460Passenger traffic \(mi road
1461Journeys 2,252 million
1462Average length 2.26 miles
1463Passenger miles 5,094 million
1464.T&
1465l n
1466a n.
1467.sp .5
1468Vehicles 12,521
1469Railway motor cars 2,905
1470Railway trailer cars 1,269
1471Total railway 4,174
1472Omnibuses 8,347
1473.T&
1474l n
1475a n.
1476.sp .5
1477Staff 73,739
1478Administrative, etc. 5,582
1479Civil engineering 5,134
1480Electrical eng. 1,714
1481Mech. eng. \(mi railway 4,310
1482Mech. eng. \(mi road 9,152
1483Railway operations 8,930
1484Road operations 35,946
1485Other 2,971
1486.TE
1487.po \n(POu
1488.sp |\n(.hu
1489.de IN
1490.sp
1491.ne 1i
1492.B
1493Input:
1494.R
1495.sp .5
1496.in +3n
1497.nf
1498..
1499.de OU
1500.sp
1501.in -3n
1502.ne 1i
1503.B
1504Output:
1505.R
1506.sp .5
1507..
1508.ns
1509.EQ
1510delim off
1511.EN
1512.IN
1513\&\*.ps 8
1514\&\*.vs 10p
1515\&\*.TS
1516center box;
1517\&c s s
1518\&ci s s
1519\&c c c
1520\&lB l n\*.
1521\&New Jersey Representatives
1522\&(Democrats)
1523\&\*.sp \*.5
1524\&Name\*TOffice address\*TPhone
1525\&\*.sp \*.5
1526\&James J\*. Florio\*T23 S\*. White Horse Pike, Somerdale 08083\*T609-627-8222
1527\&William J\*. Hughes\*T2920 Atlantic Ave\*., Atlantic City 08401\*T609-345-4844
1528\&James J\*. Howard\*T801 Bangs Ave\*., Asbury Park 07712\*T201-774-1600
1529\&Frank Thompson, Jr\*.\*T10 Rutgers Pl\*., Trenton 08618\*T609-599-1619
1530\&Andrew Maguire\*T115 W\*. Passaic St\*., Rochelle Park 07662\*T201-843-0240
1531\&Robert A\*. Roe\*TU\*.S\*.P\*.O\*., 194 Ward St\*., Paterson 07510\*T201-523-5152
1532\&Henry Helstoski\*T666 Paterson Ave\*., East Rutherford 07073\*T201-939-9090
1533\&Peter W\*. Rodino, Jr\*.\*TSuite 1435A, 970 Broad St\*., Newark 07102\*T201-645-3213
1534\&Joseph G\*. Minish\*T308 Main St\*., Orange 07050\*T201-645-6363
1535\&Helen S\*. Meyner\*T32 Bridge St\*., Lambertville 08530\*T609-397-1830
1536\&Dominick V\*. Daniels\*T895 Bergen Ave\*., Jersey City 07306\*T201-659-7700
1537\&Edward J\*. Patten\*TNatl\*. Bank Bldg\*., Perth Amboy 08861\*T201-826-4610
1538\&\*.sp \*.5
1539\&\*.T&
1540\&ci s s
1541\&lB l n\*.
1542\&(Republicans)
1543\&\*.sp \*.5v
1544\&Millicent Fenwick\*T41 N\*. Bridge St\*., Somerville 08876\*T201-722-8200
1545\&Edwin B\*. Forsythe\*T301 Mill St\*., Moorestown 08057\*T609-235-6622
1546\&Matthew J\*. Rinaldo\*T1961 Morris Ave\*., Union 07083\*T201-687-4235
1547\&\*.TE
1548\&\*.ps 10
1549\&\*.vs 12p
1550.ne 3.2i
1551.OU
1552.ps 8
1553.vs 10p
1554.TS
1555center box;
1556c s s
1557ci s s
1558c c c
1559lB l n.
1560New Jersey Representatives
1561(Democrats)
1562.sp .5
1563Name Office address Phone
1564.sp .5
1565James J. Florio 23 S. White Horse Pike, Somerdale 08083 609-627-8222
1566William J. Hughes 2920 Atlantic Ave., Atlantic City 08401 609-345-4844
1567James J. Howard 801 Bangs Ave., Asbury Park 07712 201-774-1600
1568Frank Thompson, Jr. 10 Rutgers Pl., Trenton 08618 609-599-1619
1569Andrew Maguire 115 W. Passaic St., Rochelle Park 07662 201-843-0240
1570Robert A. Roe U.S.P.O., 194 Ward St., Paterson 07510 201-523-5152
1571Henry Helstoski 666 Paterson Ave., East Rutherford 07073 201-939-9090
1572Peter W. Rodino, Jr. Suite 1435A, 970 Broad St., Newark 07102 201-645-3213
1573Joseph G. Minish 308 Main St., Orange 07050 201-645-6363
1574Helen S. Meyner 32 Bridge St., Lambertville 08530 609-397-1830
1575Dominick V. Daniels 895 Bergen Ave., Jersey City 07306 201-659-7700
1576Edward J. Patten Natl. Bank Bldg., Perth Amboy 08861 201-826-4610
1577.sp .5
1578.T&
1579ci s s
1580lB l n.
1581(Republicans)
1582.sp .5v
1583Millicent Fenwick 41 N. Bridge St., Somerville 08876 201-722-8200
1584Edwin B. Forsythe 301 Mill St., Moorestown 08057 609-235-6622
1585Matthew J. Rinaldo 1961 Morris Ave., Union 07083 201-687-4235
1586.TE
1587.ps 10
1588.vs 12p
1589.sp
1590.fi
1591This is a paragraph of normal text placed here only to indicate where
1592the left and right margins are. In this way the reader can judge
1593the appearance of centered tables or expanded tables, and observe
1594how such tables are formatted.
1595.IN
1596\&\*.TS
1597\&expand;
1598\&c s s s
1599\&c c c c
1600\&l l n n\*.
1601\&Bell Labs Locations
1602\&Name\*TAddress\*TArea Code\*TPhone
1603\&Holmdel\*THolmdel, N\*. J\*. 07733\*T201\*T949-3000
1604\&Murray Hill\*TMurray Hill, N\*. J\*. 07974\*T201\*T582-6377
1605\&Whippany\*TWhippany, N\*. J\*. 07981\*T201\*T386-3000
1606\&Indian Hill\*TNaperville, Illinois 60540\*T312\*T690-2000
1607\&\*.TE
1608.ne 1.3i
1609.OU
1610.TS
1611expand;
1612c s s s
1613c c c c
1614l l n n.
1615Bell Labs Locations
1616Name Address Area Code Phone
1617Holmdel Holmdel, N. J. 07733 201 949-3000
1618Murray Hill Murray Hill, N. J. 07974 201 582-6377
1619Whippany Whippany, N. J. 07981 201 386-3000
1620Indian Hill Naperville, Illinois 60540 312 690-2000
1621.TE
1622.br
1623.ps 8
1624.vs 9p
1625.ne 5i
1626.IN
1627\&\*.TS
1628\&box;
1629\&cb s s s
1630\&c | c | c s
1631\&ltiw(1i) | ltw(2i) | lp8 | lw(1\*.6i)p8\*.
1632\&Some Interesting Places
1633\&_
1634\&Name\*TDescription\*TPractical Information
1635\&_
1636\&T{
1637\&American Museum of Natural History
1638\&T}\*TT{
1639\&The collections fill 11\*.5 acres (Michelin) or 25 acres (MTA)
1640\&of exhibition halls on four floors\*. There is a full-sized replica
1641\&of a blue whale and the world's largest star sapphire (stolen in 1964)\*.
1642\&T}\*THours\*T10-5, ex\*. Sun 11-5, Wed\*. to 9
1643\&\e^\*T\e^\*TLocation\*TT{
1644\&Central Park West & 79th St\*.
1645\&T}
1646\&\e^\*T\e^\*TAdmission\*TDonation: $1\*.00 asked
1647\&\e^\*T\e^\*TSubway\*TAA to 81st St\*.
1648\&\e^\*T\e^\*TTelephone\*T212-873-4225
1649\&_
1650\&Bronx Zoo\*TT{
1651\&About a mile long and \*.6 mile wide, this is the largest zoo in America\*.
1652\&A lion eats 18 pounds
1653\&of meat a day while a sea lion eats 15 pounds of fish\*.
1654\&T}\*THours\*TT{
1655\&10-4:30 winter, to 5:00 summer
1656\&T}
1657\&\e^\*T\e^\*TLocation\*TT{
1658\&185th St\*. & Southern Blvd, the Bronx\*.
1659\&T}
1660\&\e^\*T\e^\*TAdmission\*T$1\*.00, but Tu,We,Th free
1661\&\e^\*T\e^\*TSubway\*T2, 5 to East Tremont Ave\*.
1662\&\e^\*T\e^\*TTelephone\*T212-933-1759
1663\&_
1664\&Brooklyn Museum\*TT{
1665\&Five floors of galleries contain American and ancient art\*.
1666\&There are American period rooms and architectural ornaments saved
1667\&from wreckers, such as a classical figure from Pennsylvania Station\*.
1668\&T}\*THours\*TWed-Sat, 10-5, Sun 12-5
1669\&\e^\*T\e^\*TLocation\*TT{
1670\&Eastern Parkway & Washington Ave\*., Brooklyn\*.
1671\&T}
1672\&\e^\*T\e^\*TAdmission\*TFree
1673\&\e^\*T\e^\*TSubway\*T2,3 to Eastern Parkway\*.
1674\&\e^\*T\e^\*TTelephone\*T212-638-5000
1675\&_
1676\&T{
1677\&New-York Historical Society
1678\&T}\*TT{
1679\&All the original paintings for Audubon's
1680\&\*.I
1681\&Birds of America
1682\&\*.R
1683\&are here, as are exhibits of American decorative arts, New York history,
1684\&Hudson River school paintings, carriages, and glass paperweights\*.
1685\&T}\*THours\*TT{
1686\&Tues-Fri & Sun, 1-5; Sat 10-5
1687\&T}
1688\&\e^\*T\e^\*TLocation\*TT{
1689\&Central Park West & 77th St\*.
1690\&T}
1691\&\e^\*T\e^\*TAdmission\*TFree
1692\&\e^\*T\e^\*TSubway\*TAA to 81st St\*.
1693\&\e^\*T\e^\*TTelephone\*T212-873-3400
1694\&\*.TE
1695.br
1696.ps \n(PS
1697.vs \n(VSp
1698.OU
1699.fi
1700.rr 10 11 12 13 14 15 16 17 18 19 20 21 22 98 99
1701.rr 60 61 62 63 64 65 66 67 68 69 70
1702.rr 43 44 45 46 47 48 49 50 51 52 53
1703.rr 83 84 85 86 87 88 89 90 91 92 93
1704.rr #a
1705.rr #b
1706.rr #c
1707.rr #d
1708.rr #e
1709.rr YY
1710.rr OJ
1711.rr P
1712.rr AV CW GW DW FL KN SJ A1 A2 A3 I1 I2 I3
1713.in 0
1714.hy 1
1715.TS
1716box;
1717cb s s s
1718c | c | c s
1719ltiw(1i) | ltw(2i) | lp8| lw(1.6i)p8.
1720Some Interesting Places
1721_
1722Name Description Practical Information
1723_
1724T{
1725American Museum of Natural History
1726T} T{
1727The collections fill 11.5 acres (Michelin) or 25 acres (MTA)
1728of exhibition halls on four floors. There is a full-sized replica
1729of a blue whale and the world's largest star sapphire (stolen in 1964).
1730T} Hours 10-5, ex. Sun 11-5, Wed. to 9
1731\^ \^ Location T{
1732Central Park West & 79th St.
1733T}
1734\^ \^ Admission Donation: $1.00 asked
1735\^ \^ Subway AA to 81st St.
1736\^ \^ Telephone 212-873-4225
1737_
1738Bronx Zoo T{
1739About a mile long and .6 mile wide, this is the largest zoo in America.
1740A lion eats 18 pounds
1741of meat a day while a sea lion eats 15 pounds of fish.
1742T} Hours T{
174310-4:30 winter, to 5:00 summer
1744T}
1745\^ \^ Location T{
1746185th St. & Southern Blvd, the Bronx.
1747T}
1748\^ \^ Admission $1.00, but Tu,We,Th free
1749\^ \^ Subway 2, 5 to East Tremont Ave.
1750\^ \^ Telephone 212-933-1759
1751_
1752Brooklyn Museum T{
1753Five floors of galleries contain American and ancient art.
1754There are American period rooms and architectural ornaments saved
1755from wreckers, such as a classical figure from Pennsylvania Station.
1756T} Hours Wed-Sat, 10-5, Sun 12-5
1757\^ \^ Location T{
1758Eastern Parkway & Washington Ave., Brooklyn.
1759T}
1760\^ \^ Admission Free
1761\^ \^ Subway 2,3 to Eastern Parkway.
1762\^ \^ Telephone 212-638-5000
1763_
1764T{
1765New-York Historical Society
1766T} T{
1767All the original paintings for Audubon's
1768.I
1769Birds of America
1770.R
1771are here, as are exhibits of American decorative arts, New York history,
1772Hudson River school paintings, carriages, and glass paperweights.
1773T} Hours T{
1774Tues-Fri & Sun, 1-5; Sat 10-5
1775T}
1776\^ \^ Location T{
1777Central Park West & 77th St.
1778T}
1779\^ \^ Admission Free
1780\^ \^ Subway AA to 81st St.
1781\^ \^ Telephone 212-873-3400
1782.TE
1783.rr 40
1784.rr 41
1785.rr 42
1786.rr 43
1787.rr 80
1788.rr 81
1789.rr 82
1790.rr 83
1791.rr 60
1792.rr 61
1793.rr 62
1794.rr 63
1795.rr #a
1796.rr #b
1797.rr #c
1798.rr #d
1799.rr #e
1800.rr ##
1801.ne 2i
1802.fi
1803.LP
1804.SH
1805Acknowledgments.
1806.PP
1807Many thanks are due to J. C. Blinn, who has done a large amount
1808of testing and assisted with the design of the program.
1809He has also written many of the more intelligible sentences
1810in this document and helped edit all of it.
1811All phototypesetting programs on \s-2UNIX\s0 are dependent on the work
1812of the late J. F. Ossanna, whose assistance with this program in particular
1813had been most helpful.
1814This program is patterned on a table formatter originally
1815written by J. F. Gimpel.
1816The assistance of
1817T. A. Dolotta, B. W. Kernighan, and J. N. Sturman
1818is gratefully acknowledged.
1819.SG MH-1274-MEL-troff
1820.ne 2i
1821.SH
1822References.
1823.IP [1]
1824J. F. Ossanna,
1825.I
1826N\s-2ROFF\s0/T\s-2ROFF\s0 User's Manual,
1827.R
1828Computing Science Technical Report No. 54,
1829Bell Laboratories, 1976.
1830.IP [2]
1831K. Thompson and D. M. Ritchie,
1832``The U\s-2NIX\s0 Time-Sharing System,''
1833\fIComm. ACM. \fB17\fR, pp. 365\(mi75 (1974).
1834.IP [3]
1835B. W. Kernighan and L. L. Cherry,
1836``A System for Typesetting Mathematics,''
1837\fIComm. ACM. \fB18\fR, pp. 151\(mi57 (1975).
1838.IP [4]
1839M. E. Lesk,
1840.I
1841Typing Documents on U\s-2NIX\s0,
1842.R
1843UNIX Programmer's Manual, Volume 2.
1844.IP [5]
1845M. E. Lesk and B. W. Kernighan,
1846.I
1847Computer Typesetting of Technical Journals on U\s-2NIX\s0,
1848.R
1849\f2Proc. AFIPS NCC\f1, vol. 46, pp. 879-888 (1977).
1850.IP [6]
1851J. R. Mashey and D. W. Smith,
1852``Documentation Tools and Techniques,''
1853.I
1854Proc. 2nd Int. Conf. on Software Engineering,
1855.R
1856pp. 177-181 (October, 1976).
1857.sp 3
1858.SH
1859.ce
1860List of Tbl Command Characters and Words
1861.LP
1862.EQ
1863delim $$
1864gfont roman
1865.EN
1866.TS
1867center;
1868cI cI cI
1869aB lf1 nf1 .
1870Command Meaning Section
1871a A Alphabetic subcolumn 2
1872allbox Draw box around all items 1
1873b B Boldface item 2
1874box Draw box around table 1
1875c C Centered column 2
1876center Center table in page 1
1877doublebox Doubled box around table 1
1878e E Equal width columns 2
1879expand Make table full line width 1
1880f F Font change 2
1881i I Italic item 2
1882l L Left adjusted column 2
1883n N Numerical column 2
1884\fInnn\fR Column separation 2
1885p P Point size change 2
1886r R Right adjusted column 2
1887s S Spanned item 2
1888t T Vertical spanning at top 2
1889tab \fR(\fIx\|\fR) Change data separator character 1
1890$fat roman "T{" ~~ fat roman "T}"$ Text block 3
1891v V Vertical spacing change 2
1892w W Minimum width value 2
1893\&\s+4.\s0\fIxx\fR Included \fItroff\fR command 3
1894\(bv Vertical line 2
1895\(bv\|\(bv Double vertical line 2
1896\&\s+4\v'4p'^\v'-4p'\s0 Vertical span 2
1897\e\&\s+4\v'4p'^\v'-4p'\s0 Vertical span 3
1898\&= Double horizontal line 2,3
1899\&$fat "_"$ Horizontal line 2,3
1900\&$fat "\e_"$ Short horizontal line 3
1901\&$fat "\e"$\f3R\f2x Repeat character 3
1902.TE