TROFF(CT) XENIX System V TROFF(CT)
Name
troff - Typesets text.
Syntax
troff [ options ] [ files ]
Description
troff formats text contained in files (standard input by
default) for printing on a phototypesetter.
An argument consisting of a lone dash (-) is taken to be a
filename corresponding to the standard input. The options,
which may appear in any order, but must appear before the
files, are:
-olist Prints only pages whose page numbers appear in the
list of numbers and ranges, separated by commas. 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 NOTES below.)
-nN Numbers first generated page N.
-sN Stops every N pages. nroff(CT) will halt after
every N pages (default N=1) to allow paper loading
or changing, and will resume upon receipt of a
linefeed or newline (newlines do not work in
pipelines, e.g., with mm(CT)). This option does not
work if the output of nroff is piped through
col(CT). troff(CT) will stop the phototypesetter
every N pages, produce a trailer to allow changing
cassettes, and resume when the typesetter's start
button is pressed. When nroff(CT) (troff) halts
between pages, an ASCII BEL (in troff, the message
page stop) is sent to the terminal.
-raN Sets register a (which must have a one-character
name) to N.
-i Reads standard input after files are exhausted.
-q Invokes the simultaneous input-output mode of the
.rd request.
-z Prints only messages generated by .tm (terminal
message) requests.
-mname Prepends to the input files the noncompacted (ASCII
text) macro file /usr/lib/tmac/tmac.name.
-cname Prepends to the input files the compacted macro
files /usr/lib/macros/cmp.[nt].[dt].name and
Page 1 (printed 8/7/87)
TROFF(CT) XENIX System V TROFF(CT)
/usr/lib/macros/ucmp.[nt].name.
-kname Compacts the macros used in this invocation of
nroff/troff, placing the output in files [dt].name
in the current directory.
-e Produces equally-spaced words in adjusted lines,
using the full resolution of the particular
terminal.
-h Uses output tabs during horizontal spacing to speed
output and reduce output character count. Tab
settings are assumed to be every 8 nominal character
widths.
-un Sets the emboldening factor (number of character
overstrikes) for the third font position (bold) to
n, or to zero if n is missing.
troff only:
-t Directs output to the standard output instead of the
phototypesetter.
-f Refrains from feeding out paper and stopping
phototypesetter at the end of the run.
-w Waits until phototypesetter is available, if it is
currently busy.
-b Reports whether the phototypesetter is busy or
available. No text processing is done.
-a Sends a printable ASCII approximation of the results
to the standard output.
-pN Prints all characters in point size N while
retaining all prescribed spacings and motions, to
reduce phototypesetter elapsed time.
-Tname Uses font-width tables for device name (the font
tables are found in /usr/lib/font/name/*).
Currently, no names are supported.
-Fname Uses font-width tables for device name (the font
tables are found in name/*). Currently, no names
are supported.
Page 2 (printed 8/7/87)
TROFF(CT) XENIX System V TROFF(CT)
Files
/usr/lib/suftab Suffix hyphenation tables
/tmp/ta# Temporary file
/usr/lib/tmac/tmac* Standard macro files and pointers
/usr/lib/macros/* Standard macro files
/usr/lib/term/* Terminal driving tables for nroff
/usr/lib/font/* Font width tables for troff
See Also
eqn(CT), tbl(CT)
(nroff only) col(CT), mm(CT)
(troff only) mmt(CT)
Notes
nroff/troff uses Eastern Standard Time; as a result,
depending on the time of the year and on your local time
zone, the date that nroff/troff generates may be off by one
day.
When nroff/troff is used with the -olist option inside a
pipeline (e.g., with one or more of cw(CT), eqn(CT), and
tbl(CT)), it may cause a harmless ``broken pipe'' diagnostic
if the last page of the document is not specified in list.
troff normally sends output directly to the typesetter. If
you do not have a typesetter attached to your system as
/dev/cat , troff will display the message ``typesetter
busy''. If this is the case, you must use the -t option and
the shell's redirection symbol to direct the output to the
standard output and into a file.
Page 3 (printed 8/7/87)