NAME

troff − typeset or format documents

SYNOPSIS

troff [ −a ] [ −f ] [ −Fdir ] [ −i ] [ −mname ] [ −nN ] [ −olist ] [ −raN ] [ −sN ] [ −Tdest ]

[ −uN ] [ −z ] [ filename ] ...

AVAILABILITY

SUNWdoc

DESCRIPTION

troff formats text in the filenames for typesetting or laser printing. Input to troff is expected to consist of text interspersed with formatting requests and macros.  If no filename argument is present, troff reads standard input.  A minus sign (−) as a filename indicates that standard input should be read at that point in the list of input files. 

The following options may appear in any order, but all must appear before the first filename.

−a Send an ASCII approximation of formatted output to standard output. 

−f Do not print a trailer after the final page of output or cause the postprocessor to relinquish control of the device. 

−Fdir Search directory dir for font width or terminal tables instead of the system default directory. 

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

−mname
Prepend the macro file /usr/share/lib/tmac/name to the input filenames. Note: most references to macro packages include the leading m as part of the name; for example, the man(5) macros reside in /usr/share/lib/tmac/an.  The macro directory can be changed by setting the TROFFMACS environment variable to a specific path.  Be certain to include the trailing ’/’ (slash) at the end of the path.

−nN Number the first generated page N.

−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. 

−q Quiet mode in nroff; ignored in troff. 

−raN Set register a (one-character names only) to N.

−sN Stop the phototypesetter every N pages.  On some devices, troff produces a trailer so you can change cassettes; resume by pressing the typesetter’s start button. 

−Tdest
Prepare output for typesetter dest. The following values can be supplied for dest:

post A PostScript printer; this is the default value. 

aps Autologic APS-5. 

−uN Set the emboldening factor for the font mounted in position 3 to N. If N is missing, then set the emboldening factor to 0. 

−z Suppress formatted output.  Only diagnostic messages and messages output using the .tm request are output. 

FILES

/tmp/trtmp temporary file

/usr/share/lib/tmac/∗ standard macro files

/usr/lib/font/∗ font width tables for alternate mounted troff fonts

/usr/share/lib/nterm/∗ terminal driving tables for nroff

SEE ALSO

checknr(1), col(1), dpost(1), eqn(1), lp(1), man(1), nroff(1), tbl(1), man(5), me(5), ms(5)

NOTES

troff is not 8-bit clean because it is by design based on 7-bit ASCII. 

SunOS 5.5/SPARC  —  Last change: 6 Oct 1992