User Commands troff(1)
NAME
troff - typeset or format documents
SYNOPSIS
troff [-a] [-f] [-Fdir] [-i] [-mname] [-nN] [-olist] [-raN]
[-sN] [-Tdest] [-uN] [-z] [filename]...
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 output of troff is usually piped through dpost(1) to
create a printable postscript file (see EXAMPLES).
OPTIONS
The following options are supported. They may appear in any
order, but all must appear before the first filename.
-a Send an ASCI approximation of formatted output
to standard output. (Note: a rough ASCI version
can also be printed out on ordinary terminals
with an old and rarely used command,
/usr/bin/ta.)
-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 TROFMACS environ-
ment variable to a specific path. Be certain to
include the trailing '/' (slash) at the end of
SunOS 5.11 Last change: 22 Jul 1998 1
User Commands troff(1)
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. The output of the -T
option must go through dpost(1) before
it is sent to a PostScript printer to
obtain the proper output.
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 mes-
sages and messages output using the .tm request
are output.
OPERANDS
The following operand is supported:
SunOS 5.11 Last change: 22 Jul 1998 2
User Commands troff(1)
filename The file containing text to be processed by
troff.
EXAMPLES
Example 1 Using troff
The following example shows how to print an input text file
mytext, coded with formatting requests and macros. The input
file contains equations and tables and must go through the
tbl(1) and eqn(1) preprocessors before it is formatted by
troff with ms macros, processed by dpost(1), and printed by
lp(1):
tbl mytext eqn troff -ms dpost lp
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
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWdoc
SEE ALSO
checknr(1), col(1), dpost(1), eqn(1), lp(1), man(1),
nroff(1), tbl(1), attributes(5), man(5), me(5), ms(5)
NOTES
SunOS 5.11 Last change: 22 Jul 1998 3
User Commands troff(1)
troff is not 8-bit clean because it is by design based on
7-bit ASCI.
Previous documentation incorrectly described the numeric
register yr as being the "Last two digits of current year".
yr is in actuality the number of years since 1900. To
correctly obtain the last two digits of the current year
through the year 2099, the definition given below of string
register yy may be included in a document and subsequently
used to display a two-digit year. Note that any other avail-
able one- or two-character register name may be substituted
for yy.
.\" definition of new string register yy--last two digits of year
.\" use yr (# of years since 1900) if it is < 100
.ie \n(yr<100 .ds yy \n(yr
.el \{ .\" else, subtract 100 from yr, store in ny
.nr ny \n(yr-100
.ie \n(ny>9 \{ .\" use ny if it is two digits
.ds yy \n(ny
.\" remove temporary number register ny
.rr ny \}
.el \{.ds yy 0
.\" if ny is one digit, append it to 0
.as yy \n(ny
.rr ny \} \}
SunOS 5.11 Last change: 22 Jul 1998 4
|
