Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought



TROFF(1)        DOMAIN/IX Reference Manual (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.

     Note:  This version of troff is an older one (pre-System 5),
     because the System 5 version is only available through the
     AT&T Documenter's Workbench, which Apollo is not yet
     licensed to provide.

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.



Printed 6/10/85                                           TROFF-1





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



     -sN       Stop the phototypesetter every N pages (the
               default is one), produce a trailer to allow chang-
               ing 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 termi-
               nal.

     -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



TROFF-2                                           Printed 6/10/85





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



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

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

















































Printed 6/10/85                                           TROFF-3



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026