TROFF(1)TROFF(1)

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 are:
−olist   Print pages in the comma-separated list of numbers and ranges. A range NM means N through M; initial M means up to M; final N means from N to the end.
−nN    Number first generated page N.
−mnameProcess 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.
−TdestPrepare 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 loading or changing.
−TnamePrepare 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 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
/home/opt/plan9port/tmac/tmac.*   standard macro files
/home/opt/plan9port/troff/term/*   terminal driving tables for nroff
/home/opt/plan9port/troff/font/*   font width tables for troff

SOURCE
/home/opt/plan9port/src/cmd/troff

SEE ALSO
lpr(1), proof(1), tr2post(1), eqn(1), tbl(1), pic(1), grap(1), doctype(1), ms(7), image(7), tex(1), deroff(1)
J. F. Ossanna and B. W. Kernighan, “Troff User’s Manual”
B. W. Kernighan, “A TROFF Tutorial”, Unix Research System Programmer’s Manual, Tenth Edition, Volume 2.

Space Glenda