Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ troff(1) — GENIX 4.1A

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

vtroff(1)

eqn(1)

tbl(1)

pti(1)

ms(7)

me(7)

man(7)

soelim(1)

col(1)

tk(1)

tc(1)



      TROFF(1)                GENIX Programmer's Manual                TROFF(1)



      NAME
           troff, nroff - text formatting and typesetting

      SYNOPSIS
           troff [ option ] ...  [ file ] ...

           nroff [ option ] ...  [ file ] ...

      DESCRIPTION
           Troff formats text in the named files for printing on a Graphic Sys-
           tems  C/A/T  phototypesetter;  nroff  for  typewriter-like  devices.
           Their capabilities are described in the Nroff/Troff user's manual.

           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, 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.

           -nN    Number first generated page N.

           -sN    Stop every N pages.  Nroff will halt prior to every  N  pages
                  (default  N=1)  to  allow paper loading or changing, and will
                  resume upon receipt of a newline.  Troff will stop the photo-
                  typesetter every N pages, produce a trailer to allow changing
                  cassettes, and resume when the typesetter's start  button  is
                  pressed.

           -mname Prepend the macro file /usr/lib/tmac/tmac.name to  the  input
                  files.

           -raN   Set register a (one-character) to N.

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

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

           Nroff only

           -Tname Prepare output for specified terminal.  Known  names  are  37
                  for  the  (default)  Teletype  Corporation Model 37 terminal,
                  tn300 for the GE TermiNet 300 (or any terminal without  half-
                  line  capability),  300S for the DASI-300S, 300 for the DASI-
                  300, and 450 for the DASI-450 (Diablo Hyterm).

           -e     Produce equally-spaced words in adjusted  lines,  using  full
                  terminal resolution.




      Printed 11/16/83                                                        1





      TROFF(1)                GENIX Programmer's Manual                TROFF(1)



           -h     Use output tabs during horizontal spacing to speed output and
                  reduce  output  character count.  Tab settings are assumed to
                  be every 8 nominal character widths.

           Troff only

           -t     Direct output to the standard output instead  of  the  photo-
                  typesetter.

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

           -w     Wait until phototypesetter is available, if 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  retaining  all
                  prescribed  spacings  and  motions, to reduce phototypesetter
                  elasped time.

           -g     Prepare output for a GCOS phototypesetter and  direct  it  to
                  the standard output (see gcat(1)).

           If the file /usr/adm/tracct is writable, troff keeps phototypesetter
           accounting records there.  The integrity of that file may be secured
           by making troff a `set user-id' program.

      FILES
           /usr/lib/suftab       suffix hyphenation tables
           /tmp/ta*              temporary file
           /usr/lib/tmac/tmac.*  standard macro files
           /usr/lib/term/*       terminal driving tables for nroff
           /usr/lib/font/*       font width tables for troff
           /dev/cat              phototypesetter
           /usr/adm/tracct       accounting statistics for /dev/cat

      SEE ALSO
           J. F. Ossanna, Nroff/Troff user's manual
           B. W. Kernighan, A TROFF Tutorial
           vtroff(1), eqn(1), tbl(1), pti(1), ms(7), me(7), man(7), soelim(1)
           col(1), tk(1) (nroff only)
           tc(1) (troff only)









      Printed 11/16/83                                                        2



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