man/dev-dvi.1.in

   1 .ig
   2 @ @L_D_DVI@.1
   3
   4 Copyright (c) 2014 - 2017 Steffen (Daode) Nurpmeso <steffen@sdaoden.eu>.
   5
   6 Copyright (C) 1989 - 2004, 2006
   7   Free Software Foundation, Inc.
   8
   9 Permission is granted to make and distribute verbatim copies of
  10 this manual provided the copyright notice and this permission notice
  11 are preserved on all copies.
  12
  13 Permission is granted to copy and distribute modified versions of this
  14 manual under the conditions for verbatim copying, provided that the
  15 entire resulting derived work is distributed under the terms of a
  16 permission notice identical to this one.
  17
  18 Permission is granted to copy and distribute translations of this
  19 manual into another language, under the above conditions for modified
  20 versions, except that this permission notice may be included in
  21 translations approved by the Free Software Foundation instead of in
  22 the original English.
  23 ..
  24 .
  25 .do nr devdvi_C \n[.C]
  26 .cp 0
  27 .
  28 .ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
  29 .el .ds tx TeX
  30 .
  31 .\" Like TP, but if specified indent is more than half
  32 .\" the current line-length - indent, use the default indent.
  33 .de Tp
  34 .  ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
  35 .  el .TP "\\$1"
  36 ..
  37 .
  38 .de TQ
  39 .  br
  40 .  ns
  41 .  TP \$1
  42 ..
  43 .
  44 .de FT
  45 .  if '\\*(.T'dvi' .ft \\$1
  46 ..
  47 .
  48 .
  49 .TH @U_D_DVI@ @MAN1EXT@ "@MDATE@" "@T_ROFF@ v@VERSION@"
  50 .SH NAME
  51 @L_D_DVI@ \- convert @T_ROFF@ output to TeX dvi format
  52 .
  53 .
  54 .SH SYNOPSIS
  55 .B @L_D_DVI@
  56 [
  57 .B \-dlv
  58 ] [
  59 .BI \-F dir
  60 ] [
  61 .BI \-p papersize
  62 ] [
  63 .BI \-w n
  64 ] [
  65 .IR files \|.\|.\|.\&
  66 ]
  67 .PP
  68 It is possible to have whitespace between a command line option and its
  69 parameter.
  70 .
  71 .
  72 .SH DESCRIPTION
  73 .B @L_D_DVI@
  74 is a driver for
  75 .B @T_ROFF@
  76 that produces \*(tx dvi format.
  77 .
  78 Normally it should be run by
  79 .BR @L_ROFF@\ \-Tdvi .
  80 .
  81 This will run
  82 .BR @L_TROFF@\ \-Tdvi ;
  83 it will also input the macros in
  84 .BR @MACRODIR@/dvi.tmac .
  85 .
  86 .LP
  87 The generated dvi file can be printed by any correctly-written dvi driver.
  88 .
  89 The troff drawing primitives are implemented
  90 using the tpic version\~2 specials.
  91 .
  92 If the driver does not support these, the
  93 .B \[rs]D
  94 commands will not produce any output.
  95 .
  96 .LP
  97 There is an additional drawing command available:
  98 .
  99 .TP
 100 .BI \[rs]D'R\  dh\ dv '
 101 Draw a rule (solid black rectangle), with one corner
 102 at the current position, and the diagonally opposite corner
 103 at the current position
 104 .RI +( dh , dv ).
 105 .
 106 Afterwards the current position will be at the opposite corner.
 107 .
 108 This produces a rule in the dvi file and so can be printed even with a
 109 driver that does not support the tpic specials unlike the other
 110 .B \[rs]D
 111 commands.
 112 .
 113 .LP
 114 The @T_ROFF@ command
 115 .BI \[rs]X' anything '
 116 is translated into the same command in the dvi file as would be
 117 produced by
 118 .BI \[rs]special{ anything }
 119 in \*(tx;
 120 .I anything
 121 may not contain a newline.
 122 .
 123 .LP
 124 For inclusion of EPS image files,
 125 .B \-Tdvi
 126 loads
 127 .B pspic.tmac
 128 automatically, providing the
 129 .B PSPIC
 130 macro.
 131 .
 132 Please check
 133 .BR @L_ROFF@-tmac (@MAN5EXT@)
 134 for a detailed description.
 135 .
 136 .LP
 137 Font files can be created from tfm files using
 138 .BR @L_TFMTODIT@ (@MAN1EXT@).
 139 .
 140 The font description file should contain the following
 141 additional commands:
 142 .
 143 .Tp \w'\fBinternalname'u+2n
 144 .BI internalname\   name
 145 The name of the tfm file (without the
 146 .B .tfm
 147 extension) is
 148 .IR name .
 149 .
 150 .TP
 151 .BI checksum\  n
 152 The checksum in the tfm file is
 153 .IR n .
 154 .
 155 .TP
 156 .BI designsize\  n
 157 The designsize in the tfm file is
 158 .IR n .
 159 .
 160 .LP
 161 These are automatically generated by
 162 .B @L_TFMTODIT@.
 163 .
 164 .LP
 165 The default color for
 166 .B \[rs]m
 167 and
 168 .B \[rs]M
 169 is black.
 170 .
 171 Currently, the drawing color for
 172 .B \[rs]D
 173 commands is always black, and fill color values are translated to gray.
 174 .
 175 .LP
 176 In
 177 .B troff
 178 the
 179 .B \[rs]N
 180 escape sequence can be used to access characters by their position
 181 in the corresponding tfm file;
 182 all characters in the tfm file can be accessed this way.
 183 .
 184 .LP
 185 By design, the DVI format doesn't care about physical dimensions of the
 186 output medium.
 187 .
 188 Instead,
 189 .B @L_D_DVI@
 190 emits the equivalent to \*(tx's
 191 .BI \[rs]special{papersize= width , length }
 192 on the first page;
 193 .B dvips
 194 (and possibly other DVI drivers) then sets the page size accordingly.
 195 .
 196 If either the page width or length is not positive, no papersize special
 197 is output.
 198 .
 199 .
 200 .SH OPTIONS
 201 .TP
 202 .B \-d
 203 Do not use tpic specials to implement drawing commands.
 204 .
 205 Horizontal and vertical lines will be implemented by rules.
 206 .
 207 Other drawing commands will be ignored.
 208 .
 209 .TP
 210 .BI \-F dir
 211 Prepend directory
 212 .IB dir /dev name
 213 to the search path for font and device description files;
 214 .I name
 215 is the name of the device, usually
 216 .BR dvi .
 217 .
 218 .TP
 219 .B \-l
 220 Specify landscape orientation.
 221 .
 222 .TP
 223 .BI \-p papersize
 224 Specify paper dimensions.
 225 .
 226 This overrides the
 227 .BR papersize ,
 228 .BR paperlength ,
 229 and
 230 .B paperwidth
 231 commands in the
 232 .B DESC
 233 file; it accepts the same arguments as the
 234 .B papersize
 235 command (see
 236 .BR @L_ROFF@-font (@MAN5EXT@)
 237 for details).
 238 .
 239 .TP
 240 .B \-v
 241 Print the version number.
 242 .
 243 .TP
 244 .BI \-w n
 245 Set the default line thickness to
 246 .I n
 247 thousandths of an em.
 248 If this option isn't specified, the line thickness defaults to 0.04\~em.
 249 .
 250 .
 251 .SH USAGE
 252 There are styles called
 253 .BR R ,
 254 .BR I ,
 255 .BR B ,
 256 and
 257 .B BI
 258 mounted at font positions 1 to\ 4.
 259 The fonts are grouped into families
 260 .B T
 261 and
 262 .B H\ \c
 263 having members in each of these styles:
 264 .
 265 .RS
 266 .TP
 267 .B TR
 268 .FT TR
 269 CM Roman (cmr10)
 270 .FT
 271 .
 272 .TQ
 273 .B TI
 274 .FT TI
 275 CM Text Italic (cmti10)
 276 .FT
 277 .
 278 .TQ
 279 .B TB
 280 .FT TB
 281 CM Bold Extended Roman (cmbx10)
 282 .FT
 283 .
 284 .TQ
 285 .B TBI
 286 .FT TBI
 287 CM Bold Extended Text Italic (cmbxti10)
 288 .FT
 289 .
 290 .TQ
 291 .B HR
 292 .FT HR
 293 CM Sans Serif (cmss10)
 294 .FT
 295 .
 296 .TQ
 297 .B HI
 298 .FT HI
 299 CM Slanted Sans Serif (cmssi10)
 300 .FT
 301 .
 302 .TQ
 303 .B HB
 304 .FT HB
 305 CM Sans Serif Bold Extended (cmssbx10)
 306 .FT
 307 .
 308 .TQ
 309 .B HBI
 310 .FT HBI
 311 CM Slanted Sans Serif Bold Extended (cmssbxo10)
 312 .FT
 313 .RE
 314 .
 315 .LP
 316 There are also the following fonts which are not members of a family:
 317 .
 318 .RS
 319 .TP
 320 .B CW
 321 CM Typewriter Text (cmtt10)
 322 .FT CW
 323 .FT
 324 .
 325 .TQ
 326 .B CWI
 327 CM Italic Typewriter Text (cmitt10)
 328 .FT CWI
 329 .FT
 330 .RE
 331 .
 332 .LP
 333 Special fonts are
 334 .B MI
 335 (cmmi10),
 336 .B S
 337 (cmsy10),
 338 .B EX
 339 (cmex10),
 340 .B SC
 341 (cmtex10, only for
 342 .BR CW ),
 343 and, perhaps surprisingly,
 344 .BR TR ,
 345 .BR TI ,
 346 and
 347 .BR CW ,
 348 due to the different font encodings of text fonts.
 349 .
 350 For italic fonts,
 351 .B CWI
 352 is used instead of
 353 .BR CW .
 354 .
 355 .LP
 356 Finally, the symbol fonts of the American Mathematical Society are available
 357 as special fonts
 358 .B SA
 359 (msam10) and
 360 .B SB
 361 (msbm10).
 362 .
 363 These two fonts are not mounted by default.
 364 .
 365 .LP
 366 Using the option
 367 .B \-mec
 368 (which loads the file
 369 .BR ec.tmac )
 370 provides the EC and TC fonts.
 371 .
 372 The design of the EC family is very similar to that of the CM fonts;
 373 additionally, they give a much better coverage of @T_ROFF@ symbols.
 374 .
 375 Note that
 376 .B ec.tmac
 377 must be called before any language-specific files; it doesn't take care of
 378 hcode values.
 379 .
 380 .
 381 .SH ENVIRONMENT
 382 .TP
 383 .SM
 384 .B @U_ROFF@_FONT_PATH
 385 A list of directories in which to search for the
 386 .BI dev name
 387 directory in addition to the default ones.
 388 .
 389 See
 390 .BR \%@L_TROFF@ (@MAN1EXT@)
 391 and
 392 .BR \%@L_ROFF@-font (@MAN5EXT@)
 393 for more details.
 394 .
 395 .
 396 .SH FILES
 397 .TP
 398 .B @FONTDIR@/dvi/DESC
 399 Device description file.
 400 .
 401 .TP
 402 .BI @FONTDIR@/dvi/ F
 403 Font description file for font
 404 .IR F .
 405 .
 406 .TP
 407 .B @MACRODIR@/dvi.tmac
 408 Macros for use with
 409 .BR @L_D_DVI@ .
 410 .
 411 .TP
 412 .B @MACRODIR@/ec.tmac
 413 Macros to switch to EC fonts.
 414 .
 415 .
 416 .SH BUGS
 417 Dvi files produced by
 418 .B @L_D_DVI@
 419 use a different resolution (57816 units per inch) to those produced by
 420 \*(tx.
 421 .
 422 Incorrectly written drivers which assume the resolution used by \*(tx,
 423 rather than using the resolution specified in the dvi file, will not
 424 work.
 425 .
 426 .LP
 427 When using the
 428 .B \-d
 429 option with boxed tables,
 430 vertical and horizontal lines can sometimes protrude by one pixel.
 431 .
 432 This is a consequence of the way \*(tx requires that the heights
 433 and widths of rules be rounded.
 434 .
 435 .
 436 .SH "SEE ALSO"
 437 .BR @L_TFMTODIT@ (@MAN1EXT@),
 438 .BR @L_ROFF@ (@MAN1EXT@),
 439 .BR @L_TROFF@ (@MAN1EXT@),
 440 .BR @L_ROFF@-out (@MAN5EXT@),
 441 .BR @L_ROFF@-font (@MAN5EXT@),
 442 .BR @L_ROFF@-tmac (@MAN5EXT@),
 443 .BR @L_ROFF@-char (@MAN7EXT@)
 444 .
 445 .cp \n[devdvi_C]
 446 .\" s-ts-mode