236 lines
3.6 KiB
Text
236 lines
3.6 KiB
Text
.TH TROFF 1
|
|
.SH NAME
|
|
troff, nroff, dpost \- text formatting and typesetting
|
|
.SH SYNOPSIS
|
|
.B troff
|
|
[
|
|
.I option ...
|
|
]
|
|
[
|
|
.I file ...
|
|
]
|
|
.PP
|
|
.B dpost
|
|
[
|
|
.B -f
|
|
] [
|
|
.I file ...
|
|
]
|
|
.PP
|
|
.B nroff
|
|
[
|
|
.I option ...
|
|
]
|
|
[
|
|
.I file ...
|
|
]
|
|
.SH DESCRIPTION
|
|
.I Troff
|
|
formats text in the named
|
|
.I files
|
|
for
|
|
printing on a typesetter,
|
|
emitting a textual intermediate format called
|
|
`typesetter-independent
|
|
.I troff
|
|
output',
|
|
understood by programs such as
|
|
.IR proof (1)
|
|
and
|
|
.IR lp (1),
|
|
but also by a
|
|
.I troff
|
|
post-processor named
|
|
.IR dpost ,
|
|
which emits corresponding Postscript.
|
|
Under
|
|
.BR -f ,
|
|
.I dpost
|
|
also emits Postscript font definitions as needed.
|
|
.I Nroff
|
|
does the same as
|
|
.IR troff ,
|
|
but produces output suitable
|
|
for typewriter-like devices,
|
|
usually without further post-processing,
|
|
but see
|
|
.IR col (1).
|
|
.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 are:
|
|
.nr xx \w'\fL-m\f2name\ \ '
|
|
.TP \n(xxu
|
|
.BI -o list
|
|
Print pages in the comma-separated
|
|
.I list
|
|
of numbers and ranges.
|
|
A range
|
|
.IB N - M
|
|
means
|
|
.I N
|
|
through
|
|
.IR M ;
|
|
initial
|
|
.BI - M
|
|
means up to
|
|
.IR M ;
|
|
final
|
|
.IB N -
|
|
means from
|
|
.I N
|
|
to the end.
|
|
.TP
|
|
.BI -n N
|
|
Number first generated page
|
|
.IR N .
|
|
.TP
|
|
.BI -m name
|
|
Process the macro file
|
|
.BI /sys/lib/tmac/tmac. name
|
|
before the input
|
|
.IR files .
|
|
.TP
|
|
.BI -r aN
|
|
Set register
|
|
.I a
|
|
(one character name) 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.
|
|
.TP
|
|
.B -N
|
|
Produce output suitable for typewriter-like devices.
|
|
.SS Typesetter devices (not \fL-N\fP) only
|
|
.TP \n(xxu
|
|
.B -a
|
|
Send a printable
|
|
textual
|
|
approximation
|
|
of the results to the standard output.
|
|
.TP
|
|
.BI -T dest
|
|
Prepare output for typesetter
|
|
.IR dest :
|
|
.br
|
|
.ns
|
|
.RS
|
|
.TP \w'\fL-TLatin1\ 'u
|
|
.B -Tutf
|
|
(The default.) PostScript printers with
|
|
preprocessing to handle Unicode
|
|
characters encoded in
|
|
.SM UTF
|
|
.PD0
|
|
.TP
|
|
.B -Tpost
|
|
Regular PostScript printers
|
|
.PD0
|
|
.TP
|
|
.B -T202
|
|
Mergenthaler Linotron 202
|
|
.RE
|
|
.PD
|
|
.TP "\w'\fL-m\f2name 'u"
|
|
.BI -F dir
|
|
Take font information from directory
|
|
.IR dir .
|
|
.SS Typewriter (\fL-N\fP) output only
|
|
.TP \n(xxu
|
|
.BI -s N
|
|
Halt prior to every
|
|
.I N
|
|
pages (default
|
|
.IR N =1)
|
|
to allow paper loading or changing.
|
|
.TP
|
|
.BI -T name
|
|
Prepare output for specified terminal.
|
|
Known
|
|
.I names
|
|
include
|
|
.B utf
|
|
for the normal Plan 9
|
|
.SM UTF
|
|
encoding of the Unicode Standard character set (default),
|
|
.B 37
|
|
for the
|
|
Teletype model 37,
|
|
.B lp
|
|
(`line-printer')
|
|
for any terminal without half-line capability,
|
|
.B 450
|
|
for the \s-1DASI\s+1-450
|
|
(Diablo Hyterm),
|
|
and
|
|
.B think
|
|
(HP ThinkJet).
|
|
.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.
|
|
.SH FILES
|
|
.TF /sys/lib/troff/term/*
|
|
.TP
|
|
.B /tmp/trtmp*
|
|
temporary file
|
|
.TP
|
|
.B /sys/lib/tmac/tmac.*
|
|
standard macro files
|
|
.TP
|
|
.B /sys/lib/troff/term/*
|
|
terminal driving tables for
|
|
.I nroff
|
|
.TP
|
|
.B /sys/lib/troff/font/*
|
|
font width tables for
|
|
.I troff
|
|
.SH SOURCE
|
|
.B /sys/src/cmd/troff
|
|
.br
|
|
.B /rc/bin/dpost
|
|
.br
|
|
.ne 3
|
|
.SH "SEE ALSO"
|
|
.IR lp (1),
|
|
.IR proof (1),
|
|
.IR page (1),
|
|
.IR eqn (1),
|
|
.IR tbl (1),
|
|
.IR pic (1),
|
|
.IR grap (1),
|
|
.IR doctype (1),
|
|
.IR ms (6),
|
|
.IR image (6),
|
|
.IR deroff (1),
|
|
.IR col (1)
|
|
.br
|
|
J. F. Ossanna and B. W. Kernighan,
|
|
``Troff User's Manual''
|
|
.br
|
|
B. W. Kernighan,
|
|
``A Typesetter-Independent TROFF'',
|
|
CSTR #97
|
|
.br
|
|
B. W. Kernighan,
|
|
``A TROFF Tutorial'',
|
|
.I
|
|
Unix Research System Programmer's Manual,
|
|
Tenth Edition, Volume 2.
|