BSD 4_1_snap development

[unix-history] / usr / man / man1 / troff.1

.TH TROFF 1 
.SH NAME
troff, nroff \- text formatting and typesetting
.SH SYNOPSIS
.B troff
[ option ] ...
[ file ] ...
.PP
.B nroff
[ option ] ...
[ file ] ...
.SH DESCRIPTION
.I Troff
formats text in the named
.I files
for
printing on a Graphic Systems C/A/T phototypesetter;
.I nroff
for typewriter-like devices.
Their capabilities are described in the
.I Nroff/Troff user's manual.
.PP
If no
.I file
argument is present, the standard input is read.
An argument consisting of a single minus
.RB ( \- )
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:
.TP "\w'\f3\-m\f1name 'u"
.BI \-o list
Print only pages whose page numbers appear in
the comma-separated
.I list
of numbers and ranges.
A range
.IB N \- M
means pages
.I N
through
.IR M ;
an initial
.I \-N
means
from the beginning to page
.IR N ;
and a final
.IR N \-
means
from
.I N
to the end.
.TP
.BI \-n N
Number first generated page
.IR N .
.TP
.BI \-s N
Stop every
.I N
pages.
.I Nroff
will halt prior to every
.I N
pages (default
.IR N =1)
to allow paper loading or
changing, and will resume upon receipt of a newline.
.I Troff
will stop the phototypesetter every
.I N
pages,
produce a trailer to allow changing cassettes,
and resume when the typesetter's start button is pressed.
.TP
.BI \-m name
Prepend the macro file
.BI /usr/lib/tmac/tmac. name
to the input
.IR files .
.TP
.BI \-r aN
Set register
.I a
(one-character) to
.IR N .
.TP
.B \-i
Read standard input after the input files are exhausted.
.TP
.B \-q
Invoke the simultaneous input-output mode of the
.B rd
request.
.HP
.bd I 3
.I Nroff only
.br
.bd I
.TP
.BI \-T name
Prepare output for specified terminal.
Known
.I names
are
.B 37
for the (default) 
Teletype Corporation Model 37 terminal,
.B tn300
for the GE TermiNet\ 300 (or any terminal without half-line
capability),
.B 300S
for the \s-1DASI\s+1-300S,
.B 300
for the \s-1DASI\s+1-300,
and
.B 450
for the \s-1DASI\s+1-450
(Diablo Hyterm).
.TP
.B \-e
Produce equally-spaced words in adjusted
lines, using full terminal resolution.
.TP
.B \-h
Use output tabs during horizontal spacing
to speed output and reduce output character count.
Tab settings are assumed to be every
8 nominal character widths.
.HP
.bd I 3
.I Troff only
.br
.bd I
.TP
.B \-t
Direct output to the standard output instead
of the phototypesetter.
.TP
.B \-f
Refrain from feeding out paper and stopping
phototypesetter at the end of the run.
.TP
.B \-w
Wait until phototypesetter is available, if
currently busy.
.TP
.B \-b
Report whether the phototypesetter
is busy or available.
No text processing is done.
.TP
.B \-a
Send a printable ASCII approximation
of the results to the standard output.
.TP
.BR \-p N
Print all characters in point size
.I  N
while retaining all prescribed spacings and motions,
to reduce phototypesetter elasped time.
.TP
.B \-g
Prepare output for a GCOS
phototypesetter and direct it to the standard output
(see
.IR gcat (1)).
.PP
If the file
.I /usr/adm/tracct
is writable,
.I troff
keeps phototypesetter accounting records there.
The integrity of that file may be secured by making
.I troff
a `set user-id' program.
.SH FILES
.ta \w'/usr/lib/tmac/tmac.*  'u
/usr/lib/suftab	suffix hyphenation tables
.br
/tmp/ta*	temporary file
.br
/usr/lib/tmac/tmac.*	standard macro files
.br
/usr/lib/term/*	terminal driving tables for
.I nroff
.br
/usr/lib/font/*	font width tables for
.I troff
.br
/dev/cat	phototypesetter
.br
/usr/adm/tracct	accounting statistics for /dev/cat
.SH "SEE ALSO"
J. F. Ossanna,
.I Nroff/Troff user's manual
.br
B. W. Kernighan,
.I
A TROFF Tutorial
.br
vtroff(1), eqn(1), tbl(1), pti(1), ms(7), me(7), man(7), soelim(1)
.br
col(1), tk(1)
.RI ( nroff
only)
.br
tc(1)
.RI ( troff
only)