Import sources from 2011-03-30 iso image - sys/man

1 files changed, 237 insertions, 0 deletions

diff --git a/sys/man/1/troff b/sys/man/1/troff
new file mode 100755
index 000000000..2838fcd26
--- /dev/null
+++ b/sys/man/1/troff
@@ -0,0 +1,237 @@
+.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 tex (1),
+.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.