NAME

troff − text formatting and typesetting language

SYNOPSIS

troff [ options ] [ files ] | typesetter

DESCRIPTION

troff formats text in the named files for printing on a phototypesetter or comparable device.  If no files argument is present, the standard input is read.  An argument consisting of a single minus (−) is taken to be a file name corresponding to the standard input.  The options, which may appear in any order so long as they appear 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 below.) 

−nN Number first generated page N.

−sN Generate output to encourage typesetter to stop every N pages. 

−mname Prepend the macro file /usr/lib/tmac/tmac.name to the input files.

−raN Set register a (one character name) to N.

−i Read standard input after the input files are exhausted. 

−q Invoke the simultaneous input-output mode of the .rd request. 

−z Print only messages generated by .tm requests. 

−a Send a printable ASCII approximation of the results to the standard output. 

−Ttty_type
Prepare output for typesetter or laser printer tty_type. Currently, the only supported device is psc , (the Apple LaserWriter).  Alternatively, the environment variable TYPESETTER may be set. 

FILES

/tmp/trtmp*temporary file

/usr/lib/tmac/tmac.*standard macro files

/usr/lib/macros/∗standard macro files

/usr/lib/font/dev*/*font width tables

SEE ALSO

grap(1), eqn(1), mmt(1), nroff(1), pic(1), tbl(1), tc(1). 

The section entitled “troff” in the Documenter’s Workbench User’s Guide. 

The section entitled “nroff/troff” in the Documenter’s Workbench Reference Manual. 

BUGS

The .tl request may not be used before the first break-producing request in the input to troff.

troff believes in 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 option inside a pipeline (e.g., with one or more of pic(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.

Version 3.6  —  December 20, 1987