1.\" Copyright (c) 1985, 1991 Regents of the University of California. 2.\" All rights reserved. 3.\" 4.\" %sccs.include.proprietary.roff% 5.\" 6.\" @(#)troff.1 6.3 (Berkeley) 08/09/91 7.\" 8.Dd 9.Dt TROFF 1 10.Os ATT 7th 11.Sh NAME 12.Nm troff , 13.Nm nroff 14.Nd text formatting and typesetting 15.Sh SYNOPSIS 16.Nm troff 17.Op Ar option 18.Ar ... 19.Op Ar file 20.Ar ... 21.Sh DESCRIPTION 22.Nm Troff 23formats text in the named 24.Ar files 25for printing on a Graphic Systems 26.Tn C/A/T 27phototypesetter; 28Its capabilities are described in the 29.%T Nroff/Troff user's manual . 30.Pp 31If no 32.Ar file 33argument is present, the standard input is read. 34An argument consisting of a single minus 35.Pq Fl 36is taken to be a file name corresponding to the standard input. 37The options, which may appear in any order so long as they appear 38before the files, are: 39.Bl -tag -width indent 40.It Fl o Ar list 41Print only pages whose page numbers appear in the comma-separated 42.Ar list 43of numbers and ranges. 44A range 45.Ar N\-M 46means pages 47.Ar N 48through 49.Ar M ; 50an initial 51.Ar \-N 52means from the beginning to page 53.Ar N ; 54and a final 55.Ar N\- 56means from 57.Ar N 58to the end. 59.It Fl n Ar N 60Number first generated page 61.Ar N . 62.It Fl s Ar N 63Stop every 64.Ar N 65pages. 66.Nm Troff 67will stop the phototypesetter every 68.Ar N 69pages, produce a trailer to allow changing cassettes, 70and resume when the typesetter's start button is pressed. 71.It Fl m Ar name 72Prepend the macro file 73.Pa /usr/lib/tmac/tmac. Ns Em name 74to the input 75.Ar files . 76.It Fl r Ns Ar aN 77Set register 78.Ar a 79(one-character) to 80.Ar N . 81.It Fl i 82Read standard input after the input files are exhausted. 83.It Fl q 84Invoke the simultaneous input-output mode of the 85.Ic rd 86request. 87.It Fl t 88Direct output to the standard output instead of the phototypesetter. 89.It Fl f 90Refrain from feeding out paper and stopping 91phototypesetter at the end of the run. 92.It Fl w 93Wait until phototypesetter is available, if currently busy. 94.It Fl b 95Report whether the phototypesetter is busy or available. 96No text processing is done. 97.It Fl a 98Send a printable 99.Tn ASCII 100approximation of the results to the standard output. 101.It Fl p Ar N 102Print all characters in point size 103.Ar N 104while retaining all prescribed spacings and motions, 105to reduce phototypesetter elapsed time. 106.It Fl F Ar fontdir 107The directory 108.Ar fontdir 109contains the font width tables instead of the default directory 110.Pa /usr/libdata/troff_font . 111This option can be used to produce output for devices 112besides the phototypesetter. 113.El 114.Pp 115If the file 116.Pa /var/account/tracct 117is writable, 118.Nm troff 119keeps phototypesetter accounting records there. 120The integrity of that file may be secured by making 121.Nm troff 122a 'set user-id' program. 123.Sh FILES 124.Bl -tag -width /usr/libdata/troff_font/ftXXXX -compact 125.It Pa /tmp/ta* 126Temporary file. 127.It Pa /usr/share/tmac/tmac.* 128Standard macro files. 129.It Pa /usr/libdata/term/tab* 130Terminal driving tables for 131.Nm nroff . 132.It Pa /usr/libdata/troff_font/ftXX* 133Font width tables for 134.Nm troff 135.Pa /dev/cat 136phototypesetter. 137.It Pa /var/account/tracct 138Accounting statistics for 139.Pa /dev/cat . 140.El 141.Sh SEE ALSO 142.Xr eqn 1 , 143.Xr tbl 1 , 144.Xr ms 7 , 145.Xr me 7 , 146.Xr man 7 , 147.Xr col 1 148.Rs 149.%T Nroff/Troff user's manual 150.%A J. F. Ossanna 151.Re 152.Rs 153.%T A TROFF Tutorial 154.%A B. W. Kernighan 155.Re 156.Sh HISTORY 157The 158.Nm troff 159command appeared in 160.At v6 . 161The version this man page decribes appeared in 162.At v7 . 163