Manual page for troff(1)
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 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.
OPERANDS
- filename
-
The file containing text to be processed by
troff.
EXAMPLES
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
ATTRIBUTES
See
attributes.5
for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE 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
troff
is not 8-bit clean because it is by design based on 7-bit
ASCII.
Created by unroff & hp-tools.
© by Hans-Peter Bischof. All Rights Reserved (1997).
Last modified 07/October/97
