1TROFF(1)                    General Commands Manual                   TROFF(1)
2
3
4

NAME

6       troff, nroff - text formatting and typesetting
7

SYNOPSIS

9       troff [ option ] ...  [ file ] ...
10
11       nroff [ option ] ...  [ file ] ...
12

DESCRIPTION

14       Troff formats text in the named files for printing on a Graphic Systems
15       C/A/T phototypesetter; nroff for typewriter-like devices.  Their  capa‐
16       bilities are described in the Nroff/Troff user's manual.
17
18       If  no  file argument is present, the standard input is read.  An argu‐
19       ment consisting of a single minus (-) is taken to be a file name corre‐
20       sponding  to  the standard input.  The options, which may appear in any
21       order so long as they appear before the files, are:
22
23       -olist Print only pages whose page numbers appear  in  the  comma-sepa‐
24              rated  list  of  numbers  and ranges.  A range N-M means pages N
25              through M; an initial -N means from the beginning to page N; and
26              a final N- means from N to the end.
27
28       -nN    Number first generated page N.
29
30       -sN    Stop  every  N  pages.   Nroff  will halt prior to every N pages
31              (default N=1) to allow  paper  loading  or  changing,  and  will
32              resume  upon  receipt  of a newline.  Troff will stop the photo‐
33              typesetter every N pages, produce a trailer  to  allow  changing
34              cassettes,  and  resume  when  the  typesetter's start button is
35              pressed.
36
37       -mname Prepend the macro  file  /usr/lib/tmac/tmac.name  to  the  input
38              files.
39
40       -raN   Set register a (one-character) to N.
41
42       -i     Read standard input after the input files are exhausted.
43
44       -q     Invoke the simultaneous input-output mode of the rd request.
45
46       NNrrooffff oonnllyy
47
48       -Tname Prepare  output  for specified terminal.  Known names are 37 for
49              the (default) Teletype Corporation Model 37 terminal, tn300  for
50              the  GE TermiNet 300 (or any terminal without half-line capabil‐
51              ity), 300S for the DASI-300S, 300 for the DASI-300, and 450  for
52              the DASI-450 (Diablo Hyterm).
53
54       -e     Produce  equally-spaced words in adjusted lines, using full ter‐
55              minal resolution.
56
57       -h     Use output tabs during horizontal spacing to  speed  output  and
58              reduce  output  character count.  Tab settings are assumed to be
59              every 8 nominal character widths.
60
61       TTrrooffff oonnllyy
62
63       -t     Direct output to the standard output instead of  the  phototype‐
64              setter.
65
66       -f     Refrain  from  feeding out paper and stopping phototypesetter at
67              the end of the run.
68
69       -w     Wait until phototypesetter is available, if currently busy.
70
71       -b     Report whether the phototypesetter is  busy  or  available.   No
72              text processing is done.
73
74       -a     Send a printable ASCII approximation of the results to the stan‐
75              dard output.
76
77       -pN    Print all characters in point size N while  retaining  all  pre‐
78              scribed  spacings and motions, to reduce phototypesetter elasped
79              time.
80
81       -g     Prepare output for a GCOS phototypesetter and direct it  to  the
82              standard output (see gcat(1)).
83
84       If  the  file  /usr/adm/tracct is writable, troff keeps phototypesetter
85       accounting records there.  The integrity of that file may be secured by
86       making troff a `set user-id' program.
87

FILES

89       /usr/lib/suftab       suffix hyphenation tables
90       /tmp/ta*              temporary file
91       /usr/lib/tmac/tmac.*  standard macro files
92       /usr/lib/term/*       terminal driving tables for nroff
93       /usr/lib/font/*       font width tables for troff
94       /dev/cat              phototypesetter
95       /usr/adm/tracct       accounting statistics for /dev/cat
96

SEE ALSO

98       J. F. Ossanna, Nroff/Troff user's manual
99       B. W. Kernighan, A TROFF Tutorial
100       eqn(1), tbl(1)
101       col(1), tk(1) (nroff only)
102       tc(1), gcat(1) (troff only)
103
104
105
106                                                                      TROFF(1)
Impressum