troff.1 (3099B)
1 .TH TROFF 1 2 .SH NAME 3 troff, nroff \- text formatting and typesetting 4 .SH SYNOPSIS 5 .B troff 6 [ 7 .I option ... 8 ] 9 [ 10 .I file ... 11 ] 12 .PP 13 .B nroff 14 [ 15 .I option ... 16 ] 17 [ 18 .I file ... 19 ] 20 .SH DESCRIPTION 21 .I Troff 22 formats text in the named 23 .I files 24 for 25 printing on a typesetter. 26 .I Nroff 27 does the same, but produces output suitable 28 for typewriter-like devices. 29 .PP 30 If no 31 .I file 32 argument is present, the standard input is read. 33 An argument consisting of a single minus 34 .RB ( - ) 35 is taken to be 36 a file name corresponding to the standard input. 37 The options are: 38 .nr xx \w'\fL-m\f2name\ \ ' 39 .TP \n(xxu 40 .BI -o list 41 Print pages in the comma-separated 42 .I list 43 of numbers and ranges. 44 A range 45 .IB N - M 46 means 47 .I N 48 through 49 .IR M ; 50 initial 51 .BI - M 52 means up to 53 .IR M ; 54 final 55 .IB N - 56 means from 57 .I N 58 to the end. 59 .TP 60 .BI -n N 61 Number first generated page 62 .IR N . 63 .TP 64 .BI -m name 65 Process the macro file 66 .BI /sys/lib/tmac/tmac. name 67 before the input 68 .IR files . 69 .TP 70 .BI -r aN 71 Set register 72 .I a 73 (one character name) to 74 .IR N . 75 .TP 76 .B -i 77 Read standard input after the input files are exhausted. 78 .TP 79 .B -q 80 Invoke the simultaneous input-output mode of the 81 .B rd 82 request. 83 .TP 84 .B -N 85 Produce output suitable for typewriter-like devices. 86 .SS Typesetter devices (not \fL-N\fP) only 87 .TP \n(xxu 88 .B -a 89 Send a printable 90 textual 91 approximation 92 of the results to the standard output. 93 .TP 94 .BI -T dest 95 Prepare output for typesetter 96 .IR dest : 97 .br 98 .ns 99 .RS 100 .TP \w'\fL-TLatin1\ 'u 101 .B -Tutf 102 (The default.) PostScript printers with 103 preprocessing to handle Unicode 104 characters encoded in 105 .SM UTF 106 .PD0 107 .TP 108 .B -Tpost 109 Regular PostScript printers 110 .PD0 111 .TP 112 .B -T202 113 Mergenthaler Linotron 202 114 .RE 115 .PD 116 .TP "\w'\fL-m\f2name 'u" 117 .BI -F dir 118 Take font information from directory 119 .IR dir . 120 .SS Typewriter (\fL-N\fP) output only 121 .TP \n(xxu 122 .BI -s N 123 Halt prior to every 124 .I N 125 pages (default 126 .IR N =1) 127 to allow paper loading or changing. 128 .TP 129 .BI -T name 130 Prepare output for specified terminal. 131 Known 132 .I names 133 include 134 .B utf 135 for the normal Plan 9 136 .SM UTF 137 encoding of the Unicode Standard character set (default), 138 .B 37 139 for the 140 Teletype model 37, 141 .B lp 142 (`line-printer') 143 for any terminal without half-line capability, 144 .B 450 145 for the \s-1DASI\s+1-450 146 (Diablo Hyterm), 147 and 148 .B think 149 (HP ThinkJet). 150 .TP 151 .B -e 152 Produce equally-spaced words in adjusted 153 lines, using full terminal resolution. 154 .TP 155 .B -h 156 Use output tabs during horizontal spacing 157 to speed output and reduce output character count. 158 Tab settings are assumed to be every 159 8 nominal character widths. 160 .SH FILES 161 .TF \*9/troff/term/* 162 .TP 163 .B /tmp/trtmp* 164 temporary file 165 .TP 166 .B \*9/tmac/tmac.* 167 standard macro files 168 .TP 169 .B \*9/troff/term/* 170 terminal driving tables for 171 .I nroff 172 .TP 173 .B \*9/troff/font/* 174 font width tables for 175 .I troff 176 .SH SOURCE 177 .B \*9/src/cmd/troff 178 .SH "SEE ALSO" 179 .IR lpr (1), 180 .IR proof (1), 181 .IR tr2post (1), 182 .IR eqn (1), 183 .IR tbl (1), 184 .IR pic (1), 185 .IR grap (1), 186 .IR doctype (1), 187 .IR ms (7), 188 .IR image (7), 189 .IR tex (1), 190 .IR deroff (1) 191 .br 192 J. F. Ossanna and B. W. Kernighan, 193 ``Troff User's Manual'' 194 .br 195 B. W. Kernighan, 196 ``A TROFF Tutorial'', 197 .I 198 Unix Research System Programmer's Manual, 199 Tenth Edition, Volume 2.