NAME

troff, nroff − text formatting and typesetting

SYNOPSIS

­troff [ ­option ...  ] [ ­file ...  ]

­nroff [ ­option ...  ] [ ­file ...  ]

DESCRIPTION

­Troff formats text in the named ­files for printing on a typesetter.  ­Nroff does the same, but produces output suitable for typewriter-like devices. 

If no ­file argument is present, the standard input is read.  An argument consisting of a single minus (-) 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:

-olist Print pages in the comma-separated ­list of numbers and ranges.  A range N-M means ­N through M; initial -M means up to ­M; final N- means from ­N to the end. 

-nN Number first generated page N.

-mname Process the macro file /sys/lib/tmac/tmac.name before the input files.

-raN Set register ­a (one character name) to N.

­-i Read standard input after the input files are exhausted. 

­-q Invoke the simultaneous input-output mode of the ­rd request. 

­-N Produce output suitable for typewriter-like devices. 

Typesetter devices (not -N) only

­-a Send a printable textual approximation of the results to the standard output. 

-Tdest Prepare output for typesetter dest:

­-TLatin1 (The default.) PostScript printers with ISO 8859-1 Latin-1 and other characters.  The name is a holdover; in fact the output is Unicode characters encoded in UTF. 

­-Tpost PostScript printers

­-T202 Mergenthaler Linotron 202

-Fdir Take font information from directory ­dir. 

Typewriter (-N) output only

-sN Halt prior to every ­N pages (default N=1) to allow paper loading or changing.

-Tname Prepare output for specified terminal.  Known ­names include ­utf for the normal Plan 9 Unicode/UTF character set (default), ­37 for the Teletype model 37, ­lp (‘line-printer’) for any terminal without half-line capability, ­450 for the DASI-450 (Diablo Hyterm), and ­think (HP ThinkJet). 

­-e Produce equally-spaced words in adjusted lines, using full terminal resolution. 

­-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. 

FILES

­/tmp/trtmp∗ temporary file

­/sys/lib/tmac/tmac.∗
standard macro files

­/sys/lib/troff/term/∗
terminal driving tables for ­nroff

­/sys/lib/troff/font/∗
font width tables for ­troff

SEE ALSO

lp(1), proof(1), eqn(1), tbl(1), pic(1), grap(1), doctype(1), ms(6), mpm(6), bitmap(6), tex(1)
J. F. Ossanna and B. W. Kernighan, ‘Nroff/Troff User’s Manual’, Unix Research System Programmer’s Manual, Volume 2
B. W. Kernighan, ‘A TROFF Tutorial’, ­ibid. 

Plan 9  —  January 03, 1993