term% cat index.txt TROFF(1) General Commands Manual TROFF(1)
NAME
troff, nroff, dpost - text formatting and typesetting
SYNOPSIS
troff [ option ... ] [ file ... ]
dpost [ -f ] [ file ... ]
nroff [ option ... ] [ file ... ]
DESCRIPTION
Troff formats text in the named files for printing on a typesetter,
emitting a textual intermediate format called ‘typesetter-independent
troff output', understood by programs such as proof(1) and lp(1), but
also by a troff post-processor named dpost, which emits corresponding
Postscript. Under -f, dpost also emits Postscript font definitions as
needed. Nroff does the same as troff, but produces output suitable for
typewriter-like devices, usually without further post-processing, but
see col(1).
If no file argument is present, the standard input is read. An argu‐
ment consisting of a single minus (-) is taken to be a file name corre‐
sponding to the standard input. The options 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:
-Tutf (The default.) PostScript printers with preprocessing
to handle Unicode characters encoded in UTF
-Tpost Regular 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 load‐
ing or changing.
-Tname Prepare output for specified terminal. Known names include utf
for the normal Plan 9 UTF encoding of the Unicode Standard
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 ter‐
minal 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
SOURCE
/sys/src/cmd/troff
/rc/bin/dpost
SEE ALSO
lp(1), proof(1), page(1), eqn(1), tbl(1), pic(1), grap(1), doctype(1),
ms(6), image(6), tex(1), deroff(1), col(1)
J. F. Ossanna and B. W. Kernighan, ‘‘Troff User's Manual''
B. W. Kernighan, ‘‘A Typesetter-Independent TROFF'', CSTR #97
B. W. Kernighan, ‘‘A TROFF Tutorial'', Unix Research System Program‐
mer's Manual, Tenth Edition, Volume 2.
TROFF(1)