Troff
formats text in the named
files
for printing on a Graphic Systems
C/A/T
phototypesetter;
Its capabilities are described in the
.%T Nroff/Troff user's manual .
If no
file
argument is present, the standard input is read.
An argument consisting of a single minus
(-)
is taken to be a file name corresponding to the standard input.
The options, which may appear in any order so long as they appear
before the files, are:
-o list
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.
-n N
Number first generated page
N.
-s N
Stop every
N
pages.
Troff
will stop the phototypesetter every
N
pages, produce a trailer to allow changing cassettes,
and resume when the typesetter's start button is pressed.
-m name
Prepend the macro file
/usr/lib/tmac/tmac.
to the input
files.
-r
Set register
a
(one-character) to
N.
-i
Read standard input after the input files are exhausted.
-q
Invoke the simultaneous input-output mode of the
rd
request.
-t
Direct output to the standard output instead of the phototypesetter.
-f
Refrain from feeding out paper and stopping
phototypesetter at the end of the run.
-w
Wait until phototypesetter is available, if currently busy.
-b
Report whether the phototypesetter is busy or available.
No text processing is done.
-a
Send a printable
ASCII
approximation of the results to the standard output.
-p N
Print all characters in point size
N
while retaining all prescribed spacings and motions,
to reduce phototypesetter elapsed time.
-F fontdir
The directory
fontdir
contains the font width tables instead of the default directory
/usr/libdata/troff_font.
This option can be used to produce output for devices
besides the phototypesetter.
If the file
/var/account/tracct
is writable,
troff
keeps phototypesetter accounting records there.
The integrity of that file may be secured by making
troff
a 'set user-id' program.
FILES
/tmp/ta*
Temporary file.
/usr/share/tmac/tmac.*
Standard macro files.
/usr/libdata/term/tab*
Terminal driving tables for
nroff.
/usr/libdata/troff_font/ftXX*
Font width tables for
troff/dev/cat
phototypesetter.
/var/account/tracct
Accounting statistics for
/dev/cat.
SEE ALSO
eqn(1),
tbl(1),
ms(7),
me(7),
man(7),
col(1)
.Rs
.%T Nroff/Troff user's manual
.%A J. F. Ossanna
.Re
.Rs
.%T A TROFF Tutorial
.%A B. W. Kernighan
.Re
HISTORY
The
troff
command appeared in
Version 6 AT&T UNIX.
The version this man page decribes appeared in
Version 7 AT&T UNIX.