troff(1) text formatting and typesetting

Other Alias

nroff

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 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 /usr/share/9base/troff/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 loading 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 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
/tmac/tmac.*
standard macro files
/troff/term/*
terminal driving tables for nroff
/troff/font/*
font width tables for troff

SOURCE

/src/cmd/troff