troff(1)                                                 troff(1)



NAME
     troff - formats and typesets files

SYNOPSIS
     troff [-] [-a] [-i] [-mname] [-nN] [-olist] [-q] [-raN]
     [-sN] [-Tdest] [file...]

ARGUMENTS
     -    Specifies a filename corresponding to the standard
          input.

     -a   Sends a printable ASCII approximation of the results to
          the standard output.

     file Specifies the file to be processed through troff.  If
          this argument is not present, the standard input is
          read.

     -i   Reads standard input after the input files are
          exhausted.

     -mname
          Inserts the /usr/lib/tmac/tmac.name macro file at the
          beginning of the input files.

     -nN  Numbers the first generated page N.

     -olist
          Prints 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.  (See LIMITATIONS, later in this section.)

     -q   Invokes the simultaneous input-output mode of the .rd
          request.

     -raN Sets register a (one character name) to N.

     -sN  Generates output to encourage typesetter to stop every
          N pages, produce a trailer to allow changing cassettes,
          and resume when the typesetter's start button is
          pressed.

     -Tdest
          Prepares output for device dest, which may be a laser
          printer or a typesetter.  For POSTSCRIPT output
          destined for an Apple LaserWriter, use -Tpsc, and pipe
          the output to the POSTSCRIPT filter psdit.

          The supported typesetter is the Autologic APS-5
          (-Taps).  For output destined for an Apple ImageWriter



January 1992                                                    1

troff(1)                                                 troff(1)



          II printer, use the -Tiw option and pipe the output to
          daiw(1).  Other output devices may be available.

DESCRIPTION
     troff formats text in the named files for printing on a
     phototypesetter.  It is the new ``device-independent''
     version of troff.

EXAMPLES
     To request the formatting of pages 4, 8, 9, and 10 of a
     document contained in the files named file1 and file2, and
     to invoke the abc macro package, enter:

        troff -o4,8-10 -mabc file1 file2


LIMITATIONS
     The .tl request may not be used before the first break-
     producing request in the input to troff.

     troff recognizes only Eastern Standard Time; as a result,
     depending on the time of the year and on your local time
     zone, the date that troff generates may be off by one day
     from your idea of what the date is.

     When troff is used with the -olist option inside a pipeline
     (for example, with one or more of cw, eqn, and tbl), it may
     cause a harmless broken pipe message if the last page of the
     document is not specified in list.

FILES
     /bin/troff
          Executable file
     /usr/lib/suftab
          Suffix hyphenation tables file
     /tmp/ta$#
          Temporary file
     /tmp/trtmp*
          Temporary file
     /usr/lib/tmac/tmac.*
          Standard macro files and pointers file
     /usr/lib/macros/*
          Standard macro files
     /usr/lib/font/dev*/*
          Font width tables files

SEE ALSO
     checknr(1), cw(1), daps(1), daiw(1), deroff(1), eqn(1),
     grap(1), mmt(1), nroff(1), otroff(1), pic(1), psdit(1),
     tbl(1), tc(1)





2                                                    January 1992

troff(1)                                                 troff(1)



     mm(5), ms(5), mv(5) in A/UX Programmer's Reference

     ``nroff/troff Reference'' in A/UX Text Processing Tools

     ``Introduction to troff and mm'' in A/UX Text Processing
     Tools

















































January 1992                                                    3