home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / PDP-11 / Trees / V7 / usr / doc / tbl < prev   
Encoding:
Text File  |  1979-01-16  |  42.0 KB  |  1,903 lines

  1. .if \nM=0 .RP
  2. .TM 76-1274-5 39199 39199-11
  3. .if \n(tm>0 .ND June 11, 1976*
  4. .TL
  5. Tbl \(em A Program to Format Tables
  6. .AU "MH 2C-569" 6377
  7. M. 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
  15. Tbl
  16. .R
  17. is a document formatting preprocessor for
  18. .I
  19. troff
  20. .R
  21. or
  22. .I
  23. nroff
  24. .R
  25. which makes
  26. even
  27. fairly complex tables easy to specify and enter.
  28. It is available on
  29. the
  30. .SM
  31. PDP-11 UNIX*
  32. .NL
  33. system
  34. .FS
  35. * UNIX is a Trademark/Service Mark of the Bell System
  36. .FE
  37. and on Honeywell 6000
  38. .SM
  39. GCOS.
  40. .NL
  41. Tables are made up of columns which may be independently centered, right-adjusted,
  42. left-adjusted, or aligned by decimal points.
  43. Headings may be placed over single columns or groups of columns.
  44. A table entry may contain equations, or may consist of several rows of text.
  45. Horizontal or vertical lines may be drawn as desired
  46. in the table,
  47. and any table or element may be enclosed in a box.
  48. For example:
  49. .in 0
  50. .ll
  51. .sp .5
  52. .TS
  53. center, box;
  54. c  s  s  s
  55. c  s  s  s
  56. c |c |c |c
  57. c |c |c |c
  58. l |n |n |n.
  59. 1970 Federal Budget Transfers
  60. \s-2(in billions of dollars)\s0
  61. =
  62. State    Taxes    Money    Net
  63. \^    collected    spent    \^
  64. _
  65. New York    22.91    21.35    \-1.56
  66. New Jersey    8.33    6.96    \-1.37
  67. Connecticut    4.12    3.10    \-1.02
  68. Maine    0.74    0.67    \-0.07
  69. California    22.29    22.42    +0.13
  70. New Mexico    0.70    1.49    +0.79
  71. Georgia    3.30    4.28    +0.98
  72. Mississippi    1.15    2.32    +1.17
  73. Texas    9.33    11.13    +1.80
  74. .TE
  75. .AE
  76. .OK
  77. Phototypesetting
  78. Documentation
  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
  90. delim $$
  91. .EN
  92. .di
  93. .rm qq
  94. .SH
  95. Introduction.
  96. .PP
  97. .I
  98. Tbl
  99. .R
  100. turns a simple description
  101. of a table into a
  102. .I
  103. troff
  104. .R
  105. or
  106. .I
  107. nroff
  108. .R
  109. [1]
  110. program (list of commands) that prints the table.
  111. .I
  112. Tbl
  113. .R
  114. may be used on the
  115. \s-2PDP-\s011 \s-2UNIX\s0
  116. .NL
  117. [2] system and on the Honeywell 6000
  118. .SM
  119. GCOS
  120. .NL
  121. system.
  122. It
  123. attempts to isolate a portion of a job that it can
  124. successfully
  125. handle and leave the remainder for other programs.
  126. Thus
  127. .I
  128. tbl
  129. .R
  130. may be used with the equation formatting
  131. program
  132. .I
  133. eqn
  134. .R
  135. [3]
  136. or various
  137. layout macro packages
  138. [4,5,6],
  139. but does not duplicate their functions.
  140. .PP
  141. This memorandum is divided into two parts.
  142. First we give the rules for preparing
  143. .I
  144. tbl
  145. .R
  146. input; then some examples are shown.
  147. The description of rules is precise but technical, and
  148. the beginning user may prefer to read the examples first,
  149. as they show some common table arrangements.
  150. A section explaining how to invoke
  151. .I
  152. tbl
  153. .R
  154. precedes the examples.
  155. To avoid repetition, henceforth read
  156. .I
  157. troff
  158. .R
  159. as
  160. .I
  161. ``troff
  162. .R
  163. or
  164. .I
  165. nroff.''
  166. .R
  167. .ds . \^\s14.\s0
  168. .PP
  169. The input to
  170. .I
  171. tbl
  172. .R
  173. is text for a document, with tables preceded by a ``\*.TS''
  174. (table start)
  175. command and followed by a ``\*.TE''
  176. (table end) command.
  177. .I
  178. Tbl
  179. .R
  180. processes the tables, generating
  181. .I
  182. troff
  183. .R
  184. formatting commands,
  185. and leaves the remainder of the text unchanged.
  186. The ``\*.TS'' and ``\*.TE''
  187. lines are copied, too, so that
  188. .I
  189. troff
  190. .R
  191. page layout macros
  192. (such as the memo formatting macros [4]\|) can use these lines
  193. to delimit and place tables as they see fit.
  194. In particular, any arguments on the ``\*.TS'' or ``\*.TE''
  195. lines
  196. are copied but otherwise ignored, and may be used by document layout
  197. macro commands.
  198. .PP
  199. The 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
  212. where the format of each table is as follows:
  213. .DS
  214. \&\*.TS
  215. \fIoptions \fB;\fR
  216. \fIformat \*.
  217. data
  218. \&\fR\*.TE
  219. .DE
  220. Each table is independent, and must contain formatting
  221. information
  222. followed by the data to be entered in the table.
  223. The formatting information, which describes the
  224. individual columns and rows of the table, may be preceded
  225. by a few options that affect the entire table.
  226. A detailed description of tables is given in the next section.
  227. .sp .5
  228. .SH
  229. Input commands.
  230. .PP
  231. As indicated above, a table contains, first, global options,
  232. then a format section describing the layout of the table
  233. entries, and then the data to be printed.  The format and data
  234. are always required, but not the options.
  235. The various parts of the table are entered as follows:
  236. .sp .5v
  237. .IP 1)
  238. O\s-2PTIONS.\s0
  239. There may be a single line of options
  240. affecting the whole table.
  241. If present, this line must follow the \*.TS line immediately
  242. and must contain a list of option names
  243. separated by spaces, tabs, or commas, and must be terminated by a semicolon.
  244. The 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
  266. The
  267. .I
  268. tbl
  269. .R
  270. program
  271. tries to keep boxed tables on one page by issuing
  272. appropriate ``need'' (\fI\*.ne\fR\|) commands.
  273. These requests are calculated from the number of lines in the tables,
  274. and if there are spacing commands embedded in the input, these requests may be inaccurate;
  275. use normal
  276. .I
  277. troff
  278. .R
  279. procedures, such as keep-release macros, in that case.
  280. The user who must have a multi-page boxed table
  281. should use macros designed for this purpose,
  282. as explained below under `Usage.'
  283. .sp .5v
  284. .IP 2) 5
  285. F\s-2ORMAT\s0.
  286. The format section of the table specifies the layout
  287. of the columns.
  288. Each line in this section corresponds to one line
  289. of the table (except that the last line corresponds to all following
  290. lines up to the next \*.T&, if any \(em see below),
  291. and each line contains a key-letter for each column
  292. of the table.
  293. It is good practice to separate the key letters for each
  294. column by spaces or tabs.
  295. Each key-letter is one of the following:
  296. .RS
  297. .cs B 25
  298. .IP "##\fBL\fR#or#\fBl\fR" 10
  299. to indicate a left-adjusted column entry;
  300. .IP "##\fBR\fR#or#\fBr\fR
  301. to indicate a right-adjusted column entry;
  302. .IP "##\fBC\fR#or#\fBc\fR
  303. to indicate a centered column entry;
  304. .IP "##\fBN\fR#or#\fBn\fR
  305. to indicate a numerical column entry, to be aligned with other
  306. numerical entries so that the units digits of numbers line up;
  307. .IP "##\fBA\fR#or#\fBa\fR
  308. to indicate an alphabetic subcolumn;
  309. all corresponding entries are aligned on the left, and positioned
  310. so that the widest is centered within the column (see
  311. example on page 12);
  312. .IP "##\fBS\fR#or#\fBs\fR
  313. to indicate a spanned heading, i.e. to indicate that the
  314. entry from the previous column continues across this
  315. column
  316. (not allowed for the first column, obviously); or
  317. .IP ##\fB\s+4\v'6p'^\v'-6p'\s0\fR
  318. to indicate a vertically spanned heading, i.e. to indicate that
  319. the 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
  326. When numerical alignment is specified, a location for the decimal
  327. point is sought.  The rightmost dot (\*.)
  328. adjacent to a digit is used as a decimal point; if there is no
  329. dot adjoining a digit, the rightmost digit is used as a units digit;
  330. if no alignment is indicated, the item is centered in the column.
  331. However, the special non-printing character string \e& may be used
  332. to override unconditionally dots
  333. and digits, or to align alphabetic data;
  334. this string lines up where a dot normally would,
  335. and then disappears from the final output.
  336. In the example below, the items shown at the left will be
  337. aligned (in a numerical column) as shown on the right:
  338. .KS
  339. .TS
  340. center;
  341. l6 n.
  342. 13    13
  343. 4\*.2    4\&\*.2
  344. 26\*.4\*.12    26\*.4\&\*.12
  345. abc    abc
  346. abc\e&    abc\&
  347. 43\e&3\*.22    43\&3\*.22
  348. 749\*.12    749\&\*.12
  349. .TE
  350. .KE
  351. .IP
  352. \fBNote:\fR
  353. If numerical data are used in the same column with wider
  354. .B L
  355. or
  356. .B r
  357. type table entries, the widest \fInumber\fR is centered relative
  358. to the wider
  359. .B L
  360. or
  361. .B r
  362. items (\fBL\fR is used instead of \fBl\fR for readability;
  363. they have the same meaning as key-letters).
  364. Alignment within the numerical items is preserved.
  365. This is similar to the behavior of
  366. .B a
  367. type data, as explained above.
  368. However,
  369. alphabetic subcolumns (requested by the
  370. .B
  371. a
  372. .R
  373. key-letter)
  374. are always slightly indented relative to
  375. .B
  376. L
  377. .R
  378. items;
  379. if necessary, the column width is increased to force this.
  380. This is not true for \fBn\fR type entries.
  381. .IP
  382. .bd I 3
  383. .ft I
  384. Warning:
  385. .ft 1
  386. .bd I
  387. the \fBn\fR and \fBa\fR items should not be used in
  388. the same column.
  389. .IP
  390. For readability, the key-letters describing each column should
  391. be separated by spaces.
  392. The end of the format section is indicated by a period.
  393. The layout of the key-letters in the format section resembles
  394. the layout of the actual data in the table.
  395. Thus a simple format might appear as:
  396. .br
  397. .ne 3
  398. .in +2
  399. .nf
  400. c  s  s
  401. l  n  n \*.
  402. .fi
  403. .in -2
  404. which specifies a table of three columns. The first line
  405. of the table contains a heading centered across all three
  406. columns; each remaining line contains a left-adjusted item
  407. in the first column followed by two columns of numerical
  408. data.
  409. A sample table in this format might be:
  410. .br
  411. .ne 6v
  412. .br
  413. .in +4
  414. .TS
  415. c s s
  416. l n n.
  417. Overall title
  418. Item-a    34.22    9.1
  419. Item-b    12.65    .02
  420. Items: c,d,e    23    5.8
  421. Total    69.87    14.92
  422. .TE
  423. .in -4
  424. There 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
  429. a horizontal line in place of the corresponding column entry,
  430. or by `=' to indicate a double horizontal line.
  431. If an adjacent column contains a horizontal line, or if
  432. there are vertical lines adjoining this column,
  433. this horizontal line is extended to meet the nearby lines.
  434. If any data entry is provided for this column, it is ignored and
  435. a 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
  440. cause a vertical line between the corresponding columns of the table.
  441. A vertical bar to the left of the first key-letter
  442. or to the right of the last one produces a line at the
  443. edge of the table.
  444. If two vertical bars appear between key-letters, a double vertical
  445. line is drawn.
  446. .IP "\fI##Space between columns#\fR"
  447. \(em A number may follow the key-letter.  This indicates the amount of separation
  448. between this column and the next column.
  449. The number normally specifies the separation in
  450. .I
  451. ens
  452. .R
  453. (one
  454. en
  455. .ne 3
  456. is about the width of the letter `n').* 
  457. .FS
  458. * More precisely, an en is a number of points (1 point = 1/72 inch)
  459. equal to half the current type size.
  460. .FE
  461. If the ``expand'' option is used, then these numbers are multiplied
  462. by a constant such that the table is as wide as the current line length.
  463. The default column separation number is 3.
  464. If 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
  467. rows of the table are centered in their vertical range.
  468. If a key-letter is followed by
  469. .B
  470. t
  471. .R
  472. or
  473. .B T ,
  474. any corresponding vertically spanned item
  475. will 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
  478. name or number
  479. preceded by the letter
  480. .B f
  481. or
  482. .B F .
  483. This indicates that the corresponding column should be in a different
  484. font from the default font (usually Roman).
  485. All font names are one or two letters; a one-letter font
  486. name should be separated from whatever follows by a space or tab.
  487. The single letters
  488. \f3B\f1, \f3b\f1, \f3I\f1,
  489. and
  490. \f3i\f1
  491. are shorter synonyms for
  492. .B f\^B
  493. and
  494. .B f\^I .
  495. Font change commands given with the table entries
  496. override these specifications.
  497. .IP "\fI##Point size changes#\fR"
  498. \(em A key-letter may be followed by the letter
  499. .B p
  500. or
  501. .B P
  502. and a number to indicate the point size of the corresponding table entries.
  503. The number may be a signed digit, in which case it is taken as
  504. an increment or decrement
  505. from the current point size.
  506. If both a point size and a column separation value are given,
  507. one 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
  511. or
  512. .B V
  513. and a number to indicate the vertical line spacing to be used
  514. within a multi-line corresponding table entry.
  515. The number may be a signed digit, in which case it is taken as an increment
  516. or decrement from the current vertical spacing.
  517. A column separation value must be separated by blanks or some other
  518. specification from a vertical spacing request.
  519. This request has no effect unless the corresponding table entry
  520. is 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
  524. or
  525. .B W
  526. and a width value in parentheses.
  527. This width is used as a minimum column width.
  528. If the largest element in the column is not as wide as the width value
  529. given after the \fBw\fR, the largest element is assumed to be that wide.
  530. If the largest element in the column is wider than the specified value,
  531. its width is used.
  532. The width is also used as a default line
  533. length for included text blocks.
  534. Normal
  535. .I
  536. troff
  537. .R
  538. units can be used to scale the width value; if none are used,
  539. the default is
  540. ens.
  541. If the width specification is a unitless integer
  542. the parentheses may be omitted.
  543. If 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
  547. or
  548. .B E
  549. to indicate equal width columns.
  550. All columns whose
  551. key-letters are followed by \fBe\fR or \fBE\fR are made the same width.
  552. This permits the user to get a group of regularly spaced
  553. columns.
  554. .IP "##\fBNote:\fR#"
  555. The order of the above features is immaterial; they need not be separated
  556. by spaces, except as indicated above to avoid ambiguities involving
  557. point size and font changes.  Thus
  558. a numerical column entry in italic font and 12 point type with a minimum
  559. width of 2.5 inches and separated by 6 ens from the next column could
  560. be specified as
  561. .in +5
  562. np12w(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
  566. on consecutive lines of the format section,
  567. successive line formats may be given on the same line, separated
  568. by commas, so that the format for the example
  569. above might have been written:
  570. .in +5
  571. c s s, l n n \*.
  572. .in -5
  573. .IP "\fI##Default#\fR"
  574. \(em Column descriptors missing from the end
  575. of a format line are assumed to be \fBL\fR.
  576. The longest line in the format section, however,
  577. defines the number of columns
  578. in the table;
  579. extra columns in the data are ignored silently.
  580. .QQ put in the diagnostics.
  581. .RE
  582. .sp .5v
  583. .IP 3)
  584. D\s-2ATA\s0.
  585. The data for the table are typed after the format.
  586. Normally, each table line is typed as one line of data.
  587. Very long input lines can be broken: any line whose last character is
  588. \e is combined with the following line (and the \e vanishes).
  589. The data for different columns (the table entries) are separated by tabs,
  590. or by whatever character has been specified in the option
  591. .I tabs
  592. option.
  593. There are a few special cases:
  594. .RS
  595. .IP "\fI##Troff commands within tables\fR#"
  596. \(em An input line
  597. beginning with a `\*.' followed by anything
  598. but a number is assumed to be a command to
  599. .I
  600. troff
  601. .R
  602. and is passed through unchanged, retaining its position in the table.
  603. So, for example, space within a table may be produced by ``\*.sp''
  604. commands
  605. in the data.
  606. .IP "\fI##Full width horizontal lines\fR#"
  607. \(em An input
  608. .I line
  609. containing only the character $fat "\(ul" $ (underscore)
  610. or \fB=\fR (equal sign) is taken to be a single or double
  611. line, respectively, extending the
  612. full width
  613. of the
  614. .I table.
  615. .IP "\fI##Single column horizontal lines\fR#"
  616. \(em An input table
  617. .I entry
  618. containing only the character $fat "\(ul" $ or \fB=\fR
  619. is taken to be a single or double line extending
  620. the full width of the
  621. .I column.
  622. Such lines are extended to meet horizontal or vertical
  623. lines adjoining this column.
  624. To obtain these characters explicitly in a column, either
  625. precede them by \e& or
  626. follow 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
  630. containing only the string $fat "\e\(ul"$
  631. is taken to be a single line as wide as the contents of
  632. the column.  It is not extended to meet
  633. adjoining lines.
  634. .IP "\fI##Repeated characters\fR#"
  635. \(em An input table
  636. .I entry
  637. containing only a string of the form $fat "\e"$\f3R\f2x\f1
  638. where
  639. .I x
  640. is any character is replaced by repetitions of the character
  641. .I x
  642. as wide as the data in the column.
  643. The sequence of
  644. .I x 's
  645. is not extended to meet adjoining columns.
  646. .IP "\fI##Vertically spanned items\fR#"
  647. \(em An input table entry containing only the
  648. character string
  649. .ft B
  650. \e\s+2\v'2p'^\v'-2p'\s0
  651. .ft R
  652. indicates that the table entry immediately
  653. above spans downward over this row.  It is equivalent
  654. to 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,
  657. precede it by $fat roman "T{" $ and follow
  658. it by $fat roman "T}" $.
  659. Thus 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
  670. is the way to enter, as a single entry in the table, something
  671. that cannot conveniently be typed as a simple string between
  672. tabs.
  673. Note that the $fat roman "T}" $ end delimiter must begin a line;
  674. additional columns of data may follow after a tab on the same line.
  675. See the example on page 10 for an illustration of included text blocks
  676. .e1 aa 10
  677. in a table.
  678. If more than twenty or thirty text blocks are used in a table,
  679. various limits in the
  680. .I
  681. troff
  682. .R
  683. program are likely to be exceeded,
  684. producing diagnostics such as `too many string/macro names' or `too many
  685. number registers.'
  686. .IP
  687. Text blocks are pulled out from the table, processed separately by
  688. .I
  689. troff,
  690. .R
  691. and replaced in the table as a solid block.  If no line length
  692. is specified in the
  693. .I
  694. block of text
  695. .R
  696. itself, or in the table format,
  697. the default is to use
  698. $ L times C / (N+1) $
  699. where
  700. .I
  701. L
  702. .R
  703. is the current line length,
  704. .I
  705. C
  706. .R
  707. is the number of table columns spanned by the text,
  708. and
  709. .I
  710. N
  711. .R
  712. is the total number of columns in the table.
  713. The other parameters (point size, font, etc.) used in setting the
  714. .I
  715. block of text
  716. .R
  717. are those in effect at the beginning of the table (including
  718. the effect of the ``\*.TS'' macro)
  719. and any table format specifications of size, spacing and font,
  720. using the \fBp\fR, \fBv\fR and \fBf\fR modifiers to the column key-letters.
  721. Commands within the text block itself are also recognized, of course.
  722. However,
  723. .I troff
  724. commands within the table data but not within the text block
  725. do not affect that block.
  726. .br
  727. .di RR
  728. .     this is going down a rathole
  729. .EQ
  730. delim 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,
  736. only the first 200 lines are used in calculating
  737. the widths of the various columns.  A multi-page table,
  738. of course, may be arranged as several single-page tables
  739. if this proves to be a problem.
  740. Other difficulties with formatting may arise because,
  741. in the calculation of column widths all table entries
  742. are assumed to be in the font and size being used when
  743. the ``\*.TS'' command was encountered, except for font and size changes
  744. indicated (a) in the table format section and (b)
  745. within the table data (as in the entry
  746. \es+3\efIdata\efP\es0\|).
  747. Therefore, although arbitrary
  748. .I
  749. troff
  750. .R
  751. requests may be sprinkled in a table, care must be taken
  752. to avoid confusing the width calculations;
  753. use requests such as `\*.ps' with care.
  754. .tr ##
  755. .sp .5v
  756. .RE
  757. .IP 4)
  758. A\s-2DDITIONAL COMMAND LINES\s0.
  759. If the format of a table must be changed after
  760. many similar lines, as with sub-headings or summarizations, the ``\*.T&''
  761. (table continue)
  762. command can be used
  763. to change column parameters.
  764. The 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
  786. as in the examples on pages 10 and 12.
  787. .e1 ab 10
  788. .e1 ac 12
  789. Using 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
  794. Warning:
  795. .ft R
  796. .bd I
  797. it is not possible to change the number of columns, the space
  798. between columns, the global options such as \fIbox,\fR
  799. or the selection of columns to be made equal width.
  800. .SH
  801. Usage.
  802. .PP
  803. On
  804. \s-2UNIX\s0,
  805. .I
  806. tbl
  807. .R
  808. can be run on a simple table with the command
  809. .DS
  810. tbl input-file | troff
  811. .DE
  812. but
  813. for more complicated use, where there are several input files,
  814. and they contain equations and \fIms\fR memorandum layout commands as well
  815. as tables, the normal command would be
  816. .DS
  817. tbl file-1 file-2 \*. \*. \*. | eqn | troff \-ms
  818. .DE
  819. and, of course, the usual options may be used on the
  820. .I
  821. troff
  822. .R
  823. and
  824. .I
  825. eqn
  826. .R
  827. commands.  The usage for
  828. .I
  829. nroff
  830. .R
  831. is similar
  832. to that for
  833. .I
  834. troff,
  835. .R
  836. but only
  837. \s-2TELETYPE\s+2\(rg Model 37 and
  838. Diablo-mechanism (\s-2DASI\s0 or \s-2GSI\s0)
  839. terminals can print boxed tables directly.
  840. .PP
  841. For the convenience of users employing line printers without
  842. adequate driving tables or post-filters, there is a special
  843. .I \-TX
  844. command line option to
  845. .I tbl
  846. which produces output that does not have fractional line
  847. motions in it.
  848. The only other command line options recognized by
  849. .I tbl
  850. are
  851. .I \-ms
  852. and
  853. .I \-mm
  854. which are turned into
  855. commands to fetch the corresponding macro files;
  856. usually it is more convenient to place these arguments
  857. on the
  858. .I troff
  859. part of the command line,
  860. but they are accepted by
  861. .I tbl
  862. as well.
  863. .PP
  864. Note that when
  865. .I
  866. eqn
  867. .R
  868. and
  869. .I
  870. tbl
  871. .R
  872. are used together on the same file
  873. .I
  874. tbl
  875. .R
  876. should be used first.
  877. If there are no equations within tables,
  878. either order works, but it is usually faster
  879. to run
  880. .I
  881. tbl
  882. .R
  883. first, since
  884. .I
  885. eqn
  886. .R
  887. normally produces a larger expansion of the input
  888. than
  889. .I
  890. tbl.
  891. .R
  892. However, if there are equations within tables
  893. (using the
  894. .I
  895. delim
  896. .R
  897. mechanism in
  898. .I
  899. eqn\fR),
  900. .I
  901. tbl
  902. .R
  903. must be first or the output will be scrambled.
  904. Users must also beware of using equations in
  905. \fBn\fR-style columns; this is nearly always wrong,
  906. since
  907. .I
  908. tbl
  909. .R
  910. attempts to split numerical format items into two parts and this
  911. is not possible with equations.
  912. The user can defend against this by giving the
  913. .I delim(xx)
  914. table option;
  915. this prevents splitting of numerical columns within the delimiters.
  916. For example, if the
  917. .I eqn
  918. delimiters
  919. are
  920. .I $$ ,
  921. giving
  922. .I delim($$)
  923. a numerical column such as
  924. ``1245 $+- 16$''
  925. will be divided after 1245, not after 16.
  926. .PP
  927. .I
  928. Tbl
  929. .R
  930. limits tables to twenty columns; however,
  931. use of more than 16 numerical columns may fail because of
  932. limits in
  933. .I
  934. troff,
  935. .R
  936. producing the `too many number registers' message.
  937. \fITroff\fR number registers used by
  938. .I
  939. tbl
  940. .R
  941. must be avoided by the user within tables;
  942. these include two-digit names from 31 to 99,
  943. and names of the forms
  944. #\fIx\fR, \fIx\fR+, \fIx\fR\ |, \v'3p'^\v'-3p'\fIx\fR, and \fIx\fR\(mi,
  945. where
  946. \fIx\fR is any lower case letter.
  947. The names
  948. ##, #\(mi, and #^ are also used in certain circumstances.
  949. To conserve number register names, the
  950. \fBn\fR
  951. and
  952. \fBa\fR
  953. formats share a register;
  954. hence the restriction above that they may not be used in the same column.
  955. .PP
  956. For aid in writing layout macros,
  957. .I
  958. tbl
  959. .R
  960. defines a number register TW which is
  961. the table width; it is defined by the time that the ``\*.TE'' macro
  962. is invoked and may be used in the expansion of that macro.
  963. More importantly, to assist in laying out multi-page boxed tables
  964. the macro T# is defined to produce the bottom lines and side lines of a boxed
  965. table, and then invoked at its end.  By use of this macro
  966. in the page footer a multi-page table can be boxed.
  967. In particular, the
  968. .I
  969. ms
  970. .R
  971. macros can be used to print a multi-page boxed table with a repeated heading
  972. by giving the
  973. argument H to the ``\*.TS'' macro.
  974. If the table start macro is written
  975. .br
  976.     \&\*.TS H
  977. .br
  978. a line of the form
  979. .br
  980.     \&\*.TH
  981. .br
  982. must be given in the table after any table heading (or at the start if none).
  983. Material up to the ``\*.TH'' is placed at the top of each page of table;
  984. the remaining lines in the table are placed on several pages as required.
  985. Note that this is
  986. .I
  987. not
  988. .R
  989. a feature of
  990. .I
  991. tbl,
  992. .R
  993. but of the \fIms\fR layout macros.
  994. .SH
  995. Examples.
  996. .PP
  997. Here are some examples illustrating features of
  998. .I
  999. tbl.
  1000. .R
  1001. .ds T \|\h'.4n'\v'-.2n'\s6\zT\s0\s10\v'.2n'\h'-.4n'\(ci\|\s0
  1002. The 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
  1010. Input:
  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
  1022. Output:
  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
  1045. box;
  1046. c c c
  1047. l l l.
  1048. Language    Authors    Runs on
  1049.  
  1050. Fortran    Many    Almost anything
  1051. PL/1    IBM    360/370
  1052. C    BTL    11/45,H6000,370
  1053. BLISS    Carnegie-Mellon    PDP-10,11
  1054. IDS    Honeywell    H6000
  1055. Pascal    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
  1075. allbox;
  1076. c s s
  1077. c c c
  1078. n n n.
  1079. AT&T Common Stock
  1080. Year    Price    Dividend
  1081. 1971    41-54    $2.60
  1082. 2    41-54    2.70
  1083. 3    46-55    2.87
  1084. 4    40-53    3.24
  1085. 5    45-52    3.40
  1086. 6    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
  1117. box;
  1118. c s s
  1119. c | c | c
  1120. l | l | n.
  1121. Major New York Bridges
  1122. =
  1123. Bridge    Designer    Length
  1124. _
  1125. Brooklyn    J. A. Roebling    1595
  1126. Manhattan    G. Lindenthal    1470
  1127. Williamsburg    L. L. Buck    1600
  1128. _
  1129. Queensborough    Palmer &    1182
  1130.       Hornbostel
  1131. _
  1132.         1380
  1133. Triborough    O. H. Ammann    _
  1134.         383
  1135. _
  1136. Bronx Whitestone    O. H. Ammann    2300
  1137. Throgs Neck    O. H. Ammann    1800
  1138. _
  1139. George 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
  1160. c c
  1161. np-2 | n |.
  1162.     Stack
  1163.     _
  1164. 1    46
  1165.     _
  1166. 2    23
  1167.     _
  1168. 3    15
  1169.     _
  1170. 4    6.5
  1171.     _
  1172. 5    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
  1191. box;
  1192. L L L
  1193. L L _
  1194. L L | LB
  1195. L L _
  1196. L L L.
  1197. january    february    march
  1198. april    may
  1199. june    july    Months
  1200. august    september
  1201. october    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
  1230. box;
  1231. cfB s s s.
  1232. Composition of Foods
  1233. _
  1234. .T&
  1235. c  |c s s
  1236. c  |c s s
  1237. c   |c  |c  |c.
  1238. Food    Percent by Weight
  1239. \^    _
  1240. \^    Protein    Fat    Carbo-
  1241. \^    \^    \^    hydrate
  1242. _
  1243. .T&
  1244. l  |n  |n  |n.
  1245. Apples    .4    .5    13.0
  1246. Halibut    18.4    5.2    ...
  1247. Lima beans    7.5    .8    22.0
  1248. Milk    3.3    4.0    5.0
  1249. Mushrooms    3.5    .4    6.0
  1250. Rye 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
  1280. allbox;
  1281. cfI s   s
  1282. c   cw(1i)   cw(1i)
  1283. lp9 lp9 lp9.
  1284. New York Area Rocks
  1285. Era    Formation    Age (years)
  1286. Precambrian    Reading Prong    >1 billion
  1287. Paleozoic    Manhattan Prong    400 million
  1288. Mesozoic    T{
  1289. .na
  1290. Newark Basin, incl.
  1291. Stockton, Lockatong, and Brunswick
  1292. formations; also Watchungs
  1293. and Palisades.
  1294. T}    200 million
  1295. Cenozoic    Coastal Plain    T{
  1296. On Long Island 30,000 years;
  1297. Cretaceous sediments redeposited
  1298. by recent glaciation.
  1299. .ad
  1300. T}
  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
  1325. delim $$
  1326. .EN
  1327. .di
  1328. .rm qq
  1329. .rs
  1330. .OU
  1331. .TS
  1332. doublebox;
  1333. c c
  1334. l l.
  1335. Name    Definition
  1336. .sp
  1337. .vs +2p
  1338. Gamma    $GAMMA (z) = int sub 0 sup inf  t sup {z-1} e sup -t dt$
  1339. Sine    $sin (x) = 1 over 2i ( e sup ix - e sup -ix )$
  1340. Error    $ roman erf (z) = 2 over sqrt pi int sub 0 sup z e sup {-t sup 2} dt$
  1341. Bessel    $ J sub 0 (z) = 1 over pi int sub 0 sup pi cos ( z sin theta ) d theta $
  1342. Zeta    $ 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
  1368. box, tab(:);
  1369. cb s s s s
  1370. cp-2 s s s s
  1371. c ||c |c |c |c
  1372. c ||c |c |c |c
  1373. r2 ||n2 |n2 |n2 |n.
  1374. Readability of Text
  1375. Line Width and Leading for 10-Point Type
  1376. =
  1377. Line:Set:1-Point:2-Point:4-Point
  1378. Width:Solid:Leading:Leading:Leading
  1379. _
  1380. 9 Pica:\-9.3:\-6.0:\-5.3:\-7.1
  1381. 14 Pica:\-4.5:\-0.6:\-0.3:\-1.7
  1382. 19 Pica:\-5.0:\-5.1: 0.0:\-2.0
  1383. 31 Pica:\-3.7:\-3.8:\-2.4:\-3.6
  1384. 43 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
  1439. c s
  1440. cip-2 s
  1441. l n
  1442. a n.
  1443. Some London Transport Statistics
  1444. (Year 1964)
  1445. Railway route miles    244
  1446. Tube    66
  1447. Sub-surface    22
  1448. Surface    156
  1449. .sp .5
  1450. .T&
  1451. l r
  1452. a r.
  1453. Passenger traffic \(mi railway
  1454. Journeys    674 million
  1455. Average length    4.55 miles
  1456. Passenger miles    3,066 million
  1457. .T&
  1458. l r
  1459. a r.
  1460. Passenger traffic \(mi road
  1461. Journeys    2,252 million
  1462. Average length    2.26 miles
  1463. Passenger miles    5,094 million
  1464. .T&
  1465. l n
  1466. a n.
  1467. .sp .5
  1468. Vehicles    12,521
  1469. Railway motor cars    2,905
  1470. Railway trailer cars    1,269
  1471. Total railway    4,174
  1472. Omnibuses    8,347
  1473. .T&
  1474. l n
  1475. a n.
  1476. .sp .5
  1477. Staff    73,739
  1478. Administrative, etc.    5,582
  1479. Civil engineering    5,134
  1480. Electrical eng.    1,714
  1481. Mech. eng. \(mi railway    4,310
  1482. Mech. eng. \(mi road    9,152
  1483. Railway operations    8,930
  1484. Road operations    35,946
  1485. Other    2,971
  1486. .TE
  1487. .po \n(POu
  1488. .sp |\n(.hu
  1489. .de IN
  1490. .sp
  1491. .ne 1i
  1492. .B
  1493. Input:
  1494. .R
  1495. .sp .5
  1496. .in +3n
  1497. .nf
  1498. ..
  1499. .de OU
  1500. .sp
  1501. .in -3n
  1502. .ne 1i
  1503. .B
  1504. Output:
  1505. .R
  1506. .sp .5
  1507. ..
  1508. .ns
  1509. .EQ
  1510. delim off
  1511. .EN
  1512. .IN
  1513. \&\*.ps 8
  1514. \&\*.vs 10p
  1515. \&\*.TS
  1516. center 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
  1555. center box;
  1556. c s s
  1557. ci s s
  1558. c c c
  1559. lB l n.
  1560. New Jersey Representatives
  1561. (Democrats)
  1562. .sp .5
  1563. Name    Office address    Phone
  1564. .sp .5
  1565. James J. Florio    23 S. White Horse Pike, Somerdale 08083    609-627-8222
  1566. William J. Hughes    2920 Atlantic Ave., Atlantic City 08401    609-345-4844
  1567. James J. Howard    801 Bangs Ave., Asbury Park 07712    201-774-1600
  1568. Frank Thompson, Jr.    10 Rutgers Pl., Trenton 08618    609-599-1619
  1569. Andrew Maguire    115 W. Passaic St., Rochelle Park 07662    201-843-0240
  1570. Robert A. Roe    U.S.P.O., 194 Ward St., Paterson 07510    201-523-5152
  1571. Henry Helstoski    666 Paterson Ave., East Rutherford 07073    201-939-9090
  1572. Peter W. Rodino, Jr.    Suite 1435A, 970 Broad St., Newark 07102    201-645-3213
  1573. Joseph G. Minish    308 Main St., Orange 07050    201-645-6363
  1574. Helen S. Meyner    32 Bridge St., Lambertville 08530    609-397-1830
  1575. Dominick V. Daniels    895 Bergen Ave., Jersey City 07306    201-659-7700
  1576. Edward J. Patten    Natl. Bank Bldg., Perth Amboy 08861    201-826-4610
  1577. .sp .5
  1578. .T&
  1579. ci s s
  1580. lB l n.
  1581. (Republicans)
  1582. .sp .5v
  1583. Millicent Fenwick    41 N. Bridge St., Somerville 08876    201-722-8200
  1584. Edwin B. Forsythe    301 Mill St., Moorestown 08057    609-235-6622
  1585. Matthew J. Rinaldo    1961 Morris Ave., Union 07083    201-687-4235
  1586. .TE
  1587. .ps 10
  1588. .vs 12p
  1589. .sp
  1590. .fi
  1591. This is a paragraph of normal text placed here only to indicate where
  1592. the left and right margins are.  In this way the reader can judge
  1593. the appearance of centered tables or expanded tables, and observe
  1594. how 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
  1611. expand;
  1612. c s s s
  1613. c c c c
  1614. l l n n.
  1615. Bell Labs Locations
  1616. Name    Address    Area Code    Phone
  1617. Holmdel    Holmdel, N. J. 07733    201    949-3000
  1618. Murray Hill    Murray Hill, N. J. 07974    201    582-6377
  1619. Whippany    Whippany, N. J. 07981    201    386-3000
  1620. Indian 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. \<iw(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
  1716. box;
  1717. cb   s   s   s
  1718. c | c | c   s
  1719. ltiw(1i) | ltw(2i) | lp8| lw(1.6i)p8.
  1720. Some Interesting Places
  1721. _
  1722. Name    Description    Practical Information
  1723. _
  1724. T{
  1725. American Museum of Natural History
  1726. T}    T{
  1727. The collections fill 11.5 acres (Michelin) or 25 acres (MTA)
  1728. of exhibition halls on four floors.  There is a full-sized replica
  1729. of a blue whale and the world's largest star sapphire (stolen in 1964).
  1730. T}    Hours    10-5, ex. Sun 11-5, Wed. to 9
  1731. \^    \^    Location    T{
  1732. Central Park West & 79th St.
  1733. T}
  1734. \^    \^    Admission    Donation: $1.00 asked
  1735. \^    \^    Subway    AA to 81st St.
  1736. \^    \^    Telephone    212-873-4225
  1737. _
  1738. Bronx Zoo    T{
  1739. About a mile long and .6 mile wide, this is the largest zoo in America.
  1740. A lion eats 18 pounds
  1741. of meat a day while a sea lion eats 15 pounds of fish.
  1742. T}    Hours    T{
  1743. 10-4:30 winter, to 5:00 summer
  1744. T}
  1745. \^    \^    Location    T{
  1746. 185th St. & Southern Blvd, the Bronx.
  1747. T}
  1748. \^    \^    Admission    $1.00, but Tu,We,Th free
  1749. \^    \^    Subway    2, 5 to East Tremont Ave.
  1750. \^    \^    Telephone    212-933-1759
  1751. _
  1752. Brooklyn Museum    T{
  1753. Five floors of galleries contain American and ancient art.
  1754. There are American period rooms and architectural ornaments saved
  1755. from wreckers, such as a classical figure from Pennsylvania Station.
  1756. T}    Hours    Wed-Sat, 10-5, Sun 12-5
  1757. \^    \^    Location    T{
  1758. Eastern Parkway & Washington Ave., Brooklyn.
  1759. T}
  1760. \^    \^    Admission    Free
  1761. \^    \^    Subway    2,3 to Eastern Parkway.
  1762. \^    \^    Telephone    212-638-5000
  1763. _
  1764. T{
  1765. New-York Historical Society
  1766. T}    T{
  1767. All the original paintings for Audubon's
  1768. .I
  1769. Birds of America
  1770. .R
  1771. are here, as are exhibits of American decorative arts, New York history,
  1772. Hudson River school paintings, carriages, and glass paperweights.
  1773. T}    Hours    T{
  1774. Tues-Fri & Sun, 1-5; Sat 10-5
  1775. T}
  1776. \^    \^    Location    T{
  1777. Central Park West & 77th St.
  1778. T}
  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
  1805. Acknowledgments.
  1806. .PP
  1807. Many thanks are due to J. C. Blinn, who has done a large amount
  1808. of testing and assisted with the design of the program.
  1809. He has also written many of the more intelligible sentences
  1810. in this document and helped edit all of it.
  1811. All phototypesetting programs on \s-2UNIX\s0 are dependent on the work
  1812. of the late J. F. Ossanna, whose assistance with this program in particular
  1813. had been most helpful.
  1814. This program is patterned on a table formatter originally
  1815. written by J. F. Gimpel.
  1816. The assistance of
  1817. T. A. Dolotta, B. W. Kernighan, and J. N. Sturman
  1818. is gratefully acknowledged.
  1819. .SG MH-1274-MEL-troff
  1820. .ne 2i
  1821. .SH
  1822. References.
  1823. .IP [1]
  1824. J. F. Ossanna,
  1825. .I
  1826. N\s-2ROFF\s0/T\s-2ROFF\s0 User's Manual,
  1827. .R
  1828. Computing Science Technical Report No. 54,
  1829. Bell Laboratories, 1976.
  1830. .IP [2]
  1831. K. 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]
  1835. B. W. Kernighan and L. L. Cherry,
  1836. ``A System for Typesetting Mathematics,''
  1837. \fIComm. ACM. \fB18\fR, pp. 151\(mi57 (1975).
  1838. .IP [4]
  1839. M. E. Lesk,
  1840. .I
  1841. Typing Documents on U\s-2NIX\s0,
  1842. .R
  1843. UNIX Programmer's Manual, Volume 2.
  1844. .IP [5]
  1845. M. E. Lesk and B. W. Kernighan,
  1846. .I
  1847. Computer 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]
  1851. J. R. Mashey and D. W. Smith,
  1852. ``Documentation Tools and Techniques,''
  1853. .I
  1854. Proc. 2nd Int. Conf. on Software Engineering,
  1855. .R
  1856. pp. 177-181 (October, 1976).
  1857. .sp 3
  1858. .SH
  1859. .ce
  1860. List of Tbl Command Characters and Words
  1861. .LP
  1862. .EQ
  1863. delim $$
  1864. gfont roman
  1865. .EN
  1866. .TS
  1867. center;
  1868. cI cI cI
  1869. aB lf1 nf1 .
  1870. Command    Meaning    Section
  1871. a A    Alphabetic subcolumn    2
  1872. allbox    Draw box around all items    1
  1873. b B    Boldface item    2
  1874. box    Draw box around table    1
  1875. c C    Centered column    2
  1876. center    Center table in page    1
  1877. doublebox    Doubled box around table    1
  1878. e E    Equal width columns    2
  1879. expand    Make table full line width    1
  1880. f F    Font change    2
  1881. i I    Italic item    2
  1882. l L    Left adjusted column    2
  1883. n N    Numerical column    2
  1884. \fInnn\fR    Column separation    2
  1885. p P    Point size change    2
  1886. r R    Right adjusted column    2
  1887. s S    Spanned item    2
  1888. t T    Vertical spanning at top    2
  1889. tab \fR(\fIx\|\fR)    Change data separator character    1
  1890. $fat roman "T{" ~~ fat roman "T}"$    Text block    3
  1891. v V    Vertical spacing change    2
  1892. w 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
  1903.