sys/man/1/troff

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