troff.1 (3106B)
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 .MR lpr (1) , 180 .MR proof (1) , 181 .MR tr2post (1) , 182 .IR eqn (1), 183 .IR tbl (1), 184 .IR pic (1), 185 .MR grap (1) , 186 .IR doctype (1), 187 .MR ms (7) , 188 .MR image (7) , 189 .MR tex (1) , 190 .MR 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.