NAME
troff - text formatting and typesetting
SYNOPSIS
ditroff [ option ] ... [ file ] ...
DESCRIPTION
Ditroff formats text in the named files for printing on one of a few printers. Different output devices are selected through the -P option or the environment variables PRINTER and TYPESETTER (see -P below). Output will go to those devices unless one of the -t or -a options is specified. The companion preprocessors, pic, ideal, deqn, dtbl and grn all accept the PRINTER and TYPESETTER environment variables too. Troff's capabilities are described in the Nroff/Troff user's manual.
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 only pages whose page numbers appear in the comma-separated list of numbers and ranges. A range N-M means pages N through M; an initial -N means from the beginning to page N; and a final N- means from N to the end.
- -nN
- Number first generated page N.
- -mname
- Prepend the macro file /usr/lib/ditmac/tmac.name to the input files.
- -Pdest
- Prepare output for typesetter dest. If no printer is specified, the default is the Imagen (ip). The environment variable PRINTER will override the default, and the environment variable TYPESETTER will override PRINTER (except for output to the lineprinter via -Pter). A -P option will override all else. -Pip (or -Pimagen ) = Canon/Imagen Laser Printer, -Pvp (or -Pversatec ) = Versatec Electrostatic Plotter, -Pcx (or -Pimagen-cx ) = Canon/Imagen-cx Laser Printer, -Pdp (or -Pxerox ) = Xerox Dandelion Laser Printer, -Pter = Line Printer (or terminals if -t is specified).
- -I
- Prepare the ditroff output for the imagen printer.
- -W
- Prepare the ditroff output for the versatec printer.
- -t
- Send the ditroff output to standard output.
- -uN
- Set the emboldening factor to N.
- -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.
- -a
- Send a printable ASCII approximation of the results to the standard output.
- -Fdir
- Use font directory dir instead of /usr/lib/font.
FILES
/usr/lib/ditmac/tmac.* standard macro files
/usr/lib/font/dev* font width tables
BUGS
The -F option is not very useful since the same directory must be available on the machine that drives the printer.
SEE ALSO
trchange(l) for a list of differences, in ditroff, to TROFF
commands
J. F. Ossanna, Nroff/Troff user's manual
B. W. Kernighan, A TROFF Tutorial
eqn(1), grn(1), ideal(1), pic(1), refer(1),
tbl(1), dterm(1), lpr(1), font(1)