TROFF(1)                                                 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 pro-
          grams 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 fur-
          ther post-processing, but see col(1).

          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 /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:

     TROFF(1)                                                 TROFF(1)

                  -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 set-
                  tings 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
          Programmer's Manual, Tenth Edition, Volume 2.