source/texk/web2c/man/dvitype.man

   1 .TH DVITYPE 1 "16 June 2015" "Web2C @VERSION@"
   2 .\"=====================================================================
   3 .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
   4 .if n .ds TX TeX
   5 .ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP
   6 .el .ds OX TeX
   7 .\" BX definition must follow TX so BX can use TX
   8 .if t .ds BX \fRB\s-2IB\s0\fP\*(TX
   9 .if n .ds BX BibTeX
  10 .\" LX definition must follow TX so LX can use TX
  11 .if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
  12 .if n .ds LX LaTeX
  13 .\"=====================================================================
  14 .SH NAME
  15 dvitype, odvitype \- translate a dvi file for humans
  16 .SH SYNOPSIS
  17 .B dvitype
  18 .IR dvi_name [ \fB.dvi\fP ]
  19 .\"=====================================================================
  20 .SH DESCRIPTION
  21 This manual page is not meant to be exhaustive.  The complete
  22 documentation for this version of \*(TX can be found in the info file
  23 or manual
  24 .IR "Web2C: A TeX implementation" .
  25 .PP
  26 The
  27 .B dvitype
  28 program translates a DVI (DeVice Independent) file output by (for example)
  29 .BR tex (1)
  30 or
  31 .BR gftodvi (1),
  32 to a file that humans can read. It also serves as a DVI file-validating
  33 program (i.e., if
  34 .B dvitype
  35 can read it, it's correct) and as an example of a DVI-reading
  36 program for future device drivers.
  37 .PP
  38 The output file can include all commands, just the important
  39 ones, or none at all (in which case only errors are reported).
  40 A subinterval of pages may be selected for transliteration; the
  41 magnification and resolution of the ``output device'' may be
  42 changed; and so on. All options are specified with an on-line dialog.
  43 .PP
  44 The
  45 .B .dvi
  46 extension is supplied if omitted from
  47 .IR dvi_name .
  48 The output goes to
  49 .IR stdout .
  50 .\"=====================================================================
  51 .SH OPTIONS
  52 .TP
  53 .BI \-dpi= REAL
  54 Set resolution to
  55 .I REAL
  56 pixels per inch; default 300.0.
  57 .PP
  58 .TP
  59 .BI \-magnification= NUMBER
  60 Override existing magnification with
  61 .IR NUMBER .
  62 .PP
  63 .TP
  64 .BI \-max-pages= NUMBER
  65 Process
  66 .I NUMBER
  67 pages; default one million.
  68 .PP
  69 .TP
  70 .BI \-output-level= NUMBER
  71 Verbosity level, from 0 to 4; default 4.
  72 .PP
  73 .TP
  74 .BI \-page-start= PAGE-SPEC
  75 Start at
  76 .IR PAGE-SPEC ,
  77 for example `2' or `5.*.-2'.
  78 .PP
  79 .TP
  80 .B \-show-opcodes
  81 Show numeric opcodes (in decimal).
  82 .\"=====================================================================
  83 .SH ENVIRONMENT
  84 The environment variable TEXFONTS is used to search for the TFM files
  85 used in the DVI file.  See
  86 .BR tex (1)
  87 for the details of the searching.
  88 If TEXFONTS is not set, it uses the system default.
  89 .\"=====================================================================
  90 .SH "SEE ALSO"
  91 .BR gftype (1),
  92 .BR pktype (1).
  93 .br
  94 Donald E. Knuth,
  95 .IR "\*(OXware" .
  96 .\"=====================================================================
  97 .SH AUTHORS
  98 Donald E. Knuth wrote the program.  It was published as part of the
  99 .I \*(OXware
 100 technical report, available from the \*(TX Users Group.
 101 Howard Trickey and Pavel Curtis originally ported it to Unix.