troff(1) troff(1)NAME troff - text formatting and typesetting SYNOPSIS troff [-olist] [-nN] [-sN] [-mname] [-raN] [-i] [-q] [-a] [-Tdest] [file...] DESCRIPTION troff formats text in the named files for printing on a pho- totypesetter. It is the new ``device-independent'' version of troff. If no file argument is present, the standard input is read. An argument consisting of a single minus (-) is taken to be a filename corresponding to the standard input. The flag options, which may appear in any order so long as they ap- pear before the files, are -olist Print only pages whose page numbers appear in the comma-separated list of numbers and ranges. A range N-M means pages N through M; an initial -N means from the beginning to page N; and a final N- means from N to the end. (See BUGS, later in this sec- tion.) -nN Number the first generated page N. -sN Generate output to encourage typesetter to stop every N pages, produce a trailer to allow changing cassettes, and resume when the typesetter's start button is pressed. -mname Insert the macro file /usr/lib/tmac/tmac.name at the beginning of the input files. -raN Set register a (one character name) to N. -i Read standard input after the input files are ex- hausted. -q Invoke the simultaneous input-output mode of the .rd request. -a Send a printable ASCII approximation of the results to the standard output. -Tdest Prepare output for device dest, which may be a laser printer or a typesetter. For POSTSCRIPT output des- tined for an Apple LaserWriter, use -Tpsc, and pipe the output to the POSTSCRIPT filter psdit(1). The supported typesetter is the Autologic APS-5 April, 1990 1
troff(1) troff(1)(-Taps). For output destined for an Apple Image- Writer II printer, use the flag -Tiw and pipe the output to daiw(1). Other output devices may be available. EXAMPLES troff -o4,8-10 -mabc file1 file2 requests formatting of pages 4, 8, 9, and 10 of a document contained in the files named file1 and file2 and invokes the macro package abc. FILES /bin/troff /usr/lib/suftab suffix hyphenation tables /tmp/ta$# temporary file /tmp/trtmp* temporary file /usr/lib/tmac/tmac.* standard macro files and pointers /usr/lib/macros/* standard macro files /usr/lib/font/dev*/* font width tables SEE ALSO checknr(1), cw(1), daps(1), daiw(1), deroff(1), eqn(1), grap(1), mmt(1), nroff(1), otroff(1), pic(1), psdit(1), tbl(1), tc(1), mm(5), ms(5), mv(5). ``nroff/troff Reference Manual'' and ``Introduction to troff and mm'' in A/UX Text Processing Tools. BUGS The .tl request may not be used before the first break- producing request in the input to troff. troff recognizes only Eastern Standard Time; as a result, depending on the time of the year and on your local time zone, the date that troff generates may be off by one day from your idea of what the date is. When troff is used with the -olist flag option inside a pipeline (for example, with one or more of cw(1), eqn(1), and tbl(1)), it may cause a harmless broken pipe diagnostic if the last page of the document is not specified in list. 2 April, 1990