troff(1) manual page
Table of Contents
troff - typeset or format documents
troff [ -a ] [ -f ] [ -Fdir
] [ -i ] [ -mname ] [ -nN ] [ -olist ] [ -raN ] [ -sN ] [ -Tdest ] [ -uN ] [
-z ] [ filename ] ...
SUNWdoc
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.
- /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
checknr(1)
, col(1)
, dpost(1)
, eqn(1)
, lp(1)
,
man(1)
, nroff(1)
, tbl(1)
, man(5)
, me(5)
, ms(5)
troff is not 8-bit clean
because it is by design based on 7-bit ASCII.
Table of Contents
![[Go to CFHT Home Page]](/images/cfht-icon.gif){kind=icon}
Man Pages 
Back to Software Index 
Manpage Top Level