.TH TROFF 1.SH NAMEtroff, 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 Troffformats text in the named.I filesforprinting on a typesetter,emitting a textual intermediate format called`typesetter-independent.I troffoutput',understood by programs such as.IR proof (1)and.IR lp (1),but also by a.I troffpost-processor named.IR dpost ,which emits corresponding Postscript.Under.BR -f ,.I dpostalso emits Postscript font definitions as needed..I Nroffdoes the same as.IR troff ,but produces output suitablefor typewriter-like devices,usually without further post-processing,but see.IR col (1)..PPIf no.I fileargument is present, the standard input is read.An argument consisting of a single minus.RB ( - )is taken to bea file name corresponding to the standard input.The options are:.nr xx \w'\fL-m\f2name\ \ '.TP \n(xxu.BI -o listPrint pages in the comma-separated.I listof numbers and ranges.A range.IB N - Mmeans.I Nthrough.IR M ;initial.BI - Mmeans up to.IR M ;final.IB N -means from.I Nto the end..TP.BI -n NNumber first generated page.IR N ..TP.BI -m nameProcess the macro file.BI /sys/lib/tmac/tmac. namebefore the input.IR files ..TP.BI -r aNSet register.I a(one character name) to.IR N ..TP.B -iRead standard input after the input files are exhausted..TP.B -qInvoke the simultaneous input-output mode of the.B rdrequest..TP.B -NProduce output suitable for typewriter-like devices..SS Typesetter devices (not \fL-N\fP) only.TP \n(xxu.B -aSend a printabletextualapproximationof the results to the standard output..TP.BI -T destPrepare output for typesetter.IR dest :.br.ns.RS.TP \w'\fL-TLatin1\ 'u.B -Tutf(The default.) PostScript printers withpreprocessing to handle Unicodecharacters encoded in.SM UTF.PD0.TP.B -TpostRegular PostScript printers.PD0.TP.B -T202Mergenthaler Linotron 202.RE.PD.TP "\w'\fL-m\f2name 'u".BI -F dirTake font information from directory.IR dir ..SS Typewriter (\fL-N\fP) output only.TP \n(xxu.BI -s NHalt prior to every.I Npages (default.IR N =1)to allow paper loading or changing..TP.BI -T namePrepare output for specified terminal.Known.I namesinclude.B utffor the normal Plan 9.SM UTFencoding of the Unicode Standard character set (default),.B 37for theTeletype model 37,.B lp(`line-printer')for any terminal without half-line capability,.B 450for the \s-1DASI\s+1-450(Diablo Hyterm),and.B think(HP ThinkJet)..TP.B -eProduce equally-spaced words in adjustedlines, using full terminal resolution..TP.B -hUse output tabs during horizontal spacingto speed output and reduce output character count.Tab settings are assumed to be every8 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).brJ. F. Ossanna and B. W. Kernighan,``Troff User's Manual''.brB. W. Kernighan,``A Typesetter-Independent TROFF'',CSTR #97.brB. W. Kernighan,``A TROFF Tutorial'',.IUnix Research System Programmer's Manual,Tenth Edition, Volume 2.