ref: a3beef236344ca326ed2010580b99e50cab983da
dir: /sys/man/1/troff/
.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.