TROFF(1)                 DOMAIN/IX SYS5                  TROFF(1)



NAME
     troff - typeset text

USAGE
     troff [ options ] [ files ]

DESCRIPTION
     Troff formats text found in files (standard input by
     default) for printing on a phototypesetter.

     An argument consisting of a dash (-) is interpreted as a
     filename corresponding to the standard input.

     The options below may appear in any order, but must appear
     before the files.

OPTIONS
     -olist    Print only pages whose page numbers appear in the
               list of numbers and ranges, separated by commas.
               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.

     -raN      Set register a (which must have a one-character
               name) to N.

     -i        Read standard input after files are exhausted.

     -q        Invoke the simultaneous input/output mode of the
               .rd request.

     -z        Print only messages generated by .tm (terminal
               message) requests.

     -mname    Prepend to the input files the non-compacted
               (ASCII text) macro file /usr/lib/tmac/tmac.name.

     -cname    Prepend to the input files the
               /usr/lib/macros/cmp.[nt].[dt].name and
               /usr/lib/macros/ucmp.[nt].name compacted macro
               files.

     -kname    Compact the macros used in this invocation, plac-
               ing the output in [dt].name files in the current
               directory.

     -sN       Stop the phototypesetter every N pages (the
               default is one), produce a trailer to allow



Printed 12/4/86                                           TROFF-1

TROFF(1)                 DOMAIN/IX SYS5                  TROFF(1)



               changing of cassettes, and resume when the
               typesetter's start button is pressed.  When troff
               halts between pages, the message page stop is sent
               to the terminal.

     -t        Direct output to the standard output instead of
               the phototypesetter.

     -f        Refrain from feeding out paper and stopping photo-
               typesetter at the end of the run.

     -w        Wait until phototypesetter is available, if it is
               currently busy.

     -b        Report whether the phototypesetter is busy or
               available.  No text processing is done.

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

     -pN       Print all characters in point size N while retain-
               ing all prescribed spacings and motions, to reduce
               phototypesetter elapsed time.

     -Tname    Use font-width tables for device name (the font
               tables are found in /usr/lib/font/name /*).
               Currently, no names are supported.

CAUTIONS
     Troff believes in 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.

     Using troff with the -olist option inside a pipeline, may
     cause a harmless ``broken pipe'' diagnostic if the last page
     of the document is not specified in list.

FILES
     /usr/lib/suftab          suffix hyphenation tables

     /tmp/ta$#                temporary file

     /usr/lib/tmac/tmac.*     standard macro files and pointers

     /usr/lib/macros/*        standard macro files

     /usr/lib/font/*          font width tables for troff





TROFF-2                                           Printed 12/4/86

TROFF(1)                 DOMAIN/IX SYS5                  TROFF(1)



RELATED INFORMATION
     col(1), cw(1), eqn(1), mm(1), mmt(1), nroff(1), tbl(1).



















































Printed 12/4/86                                           TROFF-3