troff(1) [plan9 man page]

TROFF(1)						      General Commands Manual							  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 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 loading or changing.

       -Tname  Prepare output for specified terminal.  Known names include utf for the normal Plan 9 UTF encoding of the Unicode Standard  charac-
	       ter  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

SOURCE

       /sys/src/cmd/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), 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.

																	  TROFF(1)