troff(1)                                                 troff(1)



     NAME
          troff, otroff - text formatting and typesetting

     SYNOPSIS
          troff [-olist] [-nN] [-sN] [-mname] [-raN] [-i] [-q] [-z]
          [-a] [-Tdest] ...  [files]...
          otroff [-cname] [-kname] [-t] [-f] [-w] [-b] [-pN] [files]

     DESCRIPTION
          troff formats text in the named files for printing on a
          phototypesetter.  It is the new ``device-independent''
          version of the old otroff.  otroff formats text contained in
          files for a Wang Laboratories, Inc., C/A/T phototypesetter.

          If no file argument is present, the standard input is read.
          An argument consisting of a single minus (-) is taken to be
          a filename corresponding to the standard input.  The flag
          options, which may appear in any order so long as they
          appear before the files, 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.  (See BUGS, below.)

          -nN     Number first generated page N.

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

          -mname  Insert the macro file /usr/lib/tmac/tmac.name at the
                  beginning of 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.

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

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

          -Tdest  Prepare output for typesetter dest.  Currently the



     Page 1                                        (last mod. 1/16/87)

     troff(1)                                                 troff(1)



                  only supported typesetters are the Autologic APS-5
                  (-Taps) (troff only) and the Wang CAT (-Tcat)
                  (otroff only).  Supported laser printers are the
                  Imagen Imprint -10 (-Ti10) and the Xerox 9700 (see
                  dx9700(1)).  Other output devices may be available.


        otroff only
          -cname      Insert before the input files the compacted
                      macro files:
                      /usr/lib/macros/cmp.[nt].[dt].name and
                      /usr/lib/macros/ucmp.[nt].name.

          -kname      Compact the macros used in this invocation of
                      otroff, placing the output in files [dt].name in
                      the current directory

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

          -f          Refrain from feeding out paper and stopping
                      phototypesetter 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.

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

     EXAMPLE
               troff -o4,8-10 -mabc file1 file2

          requests formatting of pages 4, 8, 9, and 10 of a document
          contained in the files named file1 and file2, and invokes
          the macro package abc.

     FILES
          /bin/troff
          /bin/otroff
          /usr/lib/suftab                suffix hyphenation tables
          /tmp/ta$#                      temporary file
          /tmp/trtmp*                    temporary file
          /usr/lib/tmac/tmac.*           standard macro files and
                                         pointers
          /usr/lib/macros/*              standard macro files
          /usr/lib/font/dev*/*           font width tables for troff

     SEE ALSO



     Page 2                                        (last mod. 1/16/87)

     troff(1)                                                 troff(1)



          daps(1), dx9700(1), eqn(1), mmt(1), nroff(1), ocw(1),
          pic(1), tbl(1), tc(1), mm(5), ms(5), mv(5),
          ``nroff/troff Reference Manual'' and ``Introduction to troff
          and mm'' in Oreo Text Processing Tools.

     BUGS
          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 flag option inside a
          pipeline (e.g., with one or more of ocw(1), eqn(1), and
          tbl(1)), it may cause a harmless broken pipe diagnostic if
          the last page of the document is not specified in list.





































     Page 3                                        (last mod. 1/16/87)