| 1 | .TH TROFF 1 |
| 2 | .SH NAME |
| 3 | troff, nroff \- text formatting and typesetting |
| 4 | .SH SYNOPSIS |
| 5 | .B troff |
| 6 | [ option ] ... |
| 7 | [ file ] ... |
| 8 | .PP |
| 9 | .B nroff |
| 10 | [ option ] ... |
| 11 | [ file ] ... |
| 12 | .SH DESCRIPTION |
| 13 | .I Troff |
| 14 | formats text in the named |
| 15 | .I files |
| 16 | for |
| 17 | printing on a Graphic Systems C/A/T phototypesetter; |
| 18 | .I nroff |
| 19 | for typewriter-like devices. |
| 20 | Their capabilities are described in the |
| 21 | .I Nroff/Troff user's manual. |
| 22 | .PP |
| 23 | If no |
| 24 | .I file |
| 25 | argument is present, the standard input is read. |
| 26 | An argument consisting of a single minus |
| 27 | .RB ( \- ) |
| 28 | is taken to be |
| 29 | a file name corresponding to the standard input. |
| 30 | The options, which may appear in any order so long as they appear |
| 31 | before the files, are: |
| 32 | .TP "\w'\f3\-m\f1name 'u" |
| 33 | .BI \-o list |
| 34 | Print only pages whose page numbers appear in |
| 35 | the comma-separated |
| 36 | .I list |
| 37 | of numbers and ranges. |
| 38 | A range |
| 39 | .IB N \- M |
| 40 | means pages |
| 41 | .I N |
| 42 | through |
| 43 | .IR M ; |
| 44 | an initial |
| 45 | .I \-N |
| 46 | means |
| 47 | from the beginning to page |
| 48 | .IR N ; |
| 49 | and a final |
| 50 | .IR N \- |
| 51 | means |
| 52 | from |
| 53 | .I N |
| 54 | to the end. |
| 55 | .TP |
| 56 | .BI \-n N |
| 57 | Number first generated page |
| 58 | .IR N . |
| 59 | .TP |
| 60 | .BI \-s N |
| 61 | Stop every |
| 62 | .I N |
| 63 | pages. |
| 64 | .I Nroff |
| 65 | will halt prior to every |
| 66 | .I N |
| 67 | pages (default |
| 68 | .IR N =1) |
| 69 | to allow paper loading or |
| 70 | changing, and will resume upon receipt of a newline. |
| 71 | .I Troff |
| 72 | will stop the phototypesetter every |
| 73 | .I N |
| 74 | pages, |
| 75 | produce a trailer to allow changing cassettes, |
| 76 | and resume when the typesetter's start button is pressed. |
| 77 | .TP |
| 78 | .BI \-m name |
| 79 | Prepend the macro file |
| 80 | .BI /usr/lib/tmac/tmac. name |
| 81 | to the input |
| 82 | .IR files . |
| 83 | .TP |
| 84 | .BI \-r aN |
| 85 | Set register |
| 86 | .I a |
| 87 | (one-character) to |
| 88 | .IR N . |
| 89 | .TP |
| 90 | .B \-i |
| 91 | Read standard input after the input files are exhausted. |
| 92 | .TP |
| 93 | .B \-q |
| 94 | Invoke the simultaneous input-output mode of the |
| 95 | .B rd |
| 96 | request. |
| 97 | .HP |
| 98 | .bd I 3 |
| 99 | .I Nroff only |
| 100 | .br |
| 101 | .bd I |
| 102 | .TP |
| 103 | .BI \-T name |
| 104 | Prepare output for specified terminal. |
| 105 | Known |
| 106 | .I names |
| 107 | are |
| 108 | .B 37 |
| 109 | for the (default) |
| 110 | Teletype Corporation Model 37 terminal, |
| 111 | .B tn300 |
| 112 | for the GE TermiNet\ 300 (or any terminal without half-line |
| 113 | capability), |
| 114 | .B 300S |
| 115 | for the \s-1DASI\s+1-300S, |
| 116 | .B 300 |
| 117 | for the \s-1DASI\s+1-300, |
| 118 | and |
| 119 | .B 450 |
| 120 | for the \s-1DASI\s+1-450 |
| 121 | (Diablo Hyterm). |
| 122 | .TP |
| 123 | .B \-e |
| 124 | Produce equally-spaced words in adjusted |
| 125 | lines, using full terminal resolution. |
| 126 | .TP |
| 127 | .B \-h |
| 128 | Use output tabs during horizontal spacing |
| 129 | to speed output and reduce output character count. |
| 130 | Tab settings are assumed to be every |
| 131 | 8 nominal character widths. |
| 132 | .HP |
| 133 | .bd I 3 |
| 134 | .I Troff only |
| 135 | .br |
| 136 | .bd I |
| 137 | .TP |
| 138 | .B \-t |
| 139 | Direct output to the standard output instead |
| 140 | of the phototypesetter. |
| 141 | .TP |
| 142 | .B \-f |
| 143 | Refrain from feeding out paper and stopping |
| 144 | phototypesetter at the end of the run. |
| 145 | .TP |
| 146 | .B \-w |
| 147 | Wait until phototypesetter is available, if |
| 148 | currently busy. |
| 149 | .TP |
| 150 | .B \-b |
| 151 | Report whether the phototypesetter |
| 152 | is busy or available. |
| 153 | No text processing is done. |
| 154 | .TP |
| 155 | .B \-a |
| 156 | Send a printable ASCII approximation |
| 157 | of the results to the standard output. |
| 158 | .TP |
| 159 | .BR \-p N |
| 160 | Print all characters in point size |
| 161 | .I N |
| 162 | while retaining all prescribed spacings and motions, |
| 163 | to reduce phototypesetter elasped time. |
| 164 | .TP |
| 165 | .B \-g |
| 166 | Prepare output for a GCOS |
| 167 | phototypesetter and direct it to the standard output |
| 168 | (see |
| 169 | .IR gcat (1)). |
| 170 | .PP |
| 171 | If the file |
| 172 | .I /usr/adm/tracct |
| 173 | is writable, |
| 174 | .I troff |
| 175 | keeps phototypesetter accounting records there. |
| 176 | The integrity of that file may be secured by making |
| 177 | .I troff |
| 178 | a `set user-id' program. |
| 179 | .SH FILES |
| 180 | .ta \w'/usr/lib/tmac/tmac.* 'u |
| 181 | /usr/lib/suftab suffix hyphenation tables |
| 182 | .br |
| 183 | /tmp/ta* temporary file |
| 184 | .br |
| 185 | /usr/lib/tmac/tmac.* standard macro files |
| 186 | .br |
| 187 | /usr/lib/term/* terminal driving tables for |
| 188 | .I nroff |
| 189 | .br |
| 190 | /usr/lib/font/* font width tables for |
| 191 | .I troff |
| 192 | .br |
| 193 | /dev/cat phototypesetter |
| 194 | .br |
| 195 | /usr/adm/tracct accounting statistics for /dev/cat |
| 196 | .SH "SEE ALSO" |
| 197 | J. F. Ossanna, |
| 198 | .I Nroff/Troff user's manual |
| 199 | .br |
| 200 | B. W. Kernighan, |
| 201 | .I |
| 202 | A TROFF Tutorial |
| 203 | .br |
| 204 | eqn(1), tbl(1) |
| 205 | .br |
| 206 | col(1), tk(1) |
| 207 | .RI ( nroff |
| 208 | only) |
| 209 | .br |
| 210 | tc(1) |
| 211 | .RI ( troff |
| 212 | only) |