Debian Codegraph @

texmf-dist/doc/man/man1/dvitype.1

raw
1 .TH DVITYPE 1 "22 January 2026" "Web2C 2026"
2 .\"=====================================================================
3 .if t .ds TX \fRT\\h'-0.10m'\\v'0.17v'E\\v'-0.17v'\\h'-0.06m'X\fP
4 .if n .ds TX TeX
5 .ie t .ds OX \fIT\h'-0.17m'\v'+0.21m'E\v'-0.21m'\h'-0.04m'X\fP
6 .el .ds OX TeX
7 .\"=====================================================================
8 .SH NAME
9 dvitype, odvitype \- translate a dvi file for humans to read
10 .SH SYNOPSIS
11 .B dvitype
12 .IR dvi_file [ \fB.dvi\fP ]
13 .\"=====================================================================
14 .SH DESCRIPTION
15 The
16 .B dvitype
17 program translates a DVI (DeVice Independent) file output by (for example)
18 .BR tex (1)
19 or
20 .BR gftodvi (1),
21 to a file that humans can read. It also serves as a DVI file-validating
22 program (i.e., if
23 .B dvitype
24 can read it, it's correct) and as an example of a DVI-processing
25 program for future device drivers.
26 .PP
27 The output from
28 .B dvitype
29 can include all commands, just the important ones, or none at all (in
30 which case only errors are reported). A subinterval of pages may be
31 selected, the magnification and resolution of the
32 ``output device'' may be changed, and so on.
33 .PP
34 The
35 .B .dvi
36 extension is supplied if omitted from
37 .IR dvi_file .
38 The output goes to stdout.
39 .PP
40 The
41 .B odvitype
42 program does the same job for Omega/Aleph's output, modified to support
43 their \fI.ofm\fP font format.
44 .\"=====================================================================
45 .SH OPTIONS
46 See
47 .BR tex (1)
48 for details of command-line parsing.
49 .TP
50 .BI -dpi= real
51 Set resolution to
52 .I real
53 pixels per inch; default 300.0.
54 .TP
55 .BI -magnification= number
56 Override existing magnification with
57 .IR number .
58 .TP
59 .BI -max-pages= number
60 Process
61 .I number
62 pages; default one million.
63 .TP
64 .BI -output-level= number
65 Verbosity level, from 0 to 4; default 4.
66 .TP
67 .BI -page-start= page-spec
68 Start at
69 .IR page-spec ,
70 for example `2' or `5.*.-2'.
71 .TP
72 .B -show-opcodes
73 Show numeric opcodes (in decimal).
74 .PP
75 The standard
76 .B -help
77 and
78 .B -version
79 options are also supported.
80 .\"=====================================================================
81 .SH ENVIRONMENT
82 The environment variable TEXFONTS is used to search for the TFM files
83 used in the DVI file. See
84 .BR tex (1)
85 for the details of the searching.
86 If TEXFONTS is not set, it uses the system default.
87 .\"=====================================================================
88 .SH "SEE ALSO"
89 .BR gftype (1),
90 .BR pktype (1).
91 .br
92 Donald E. Knuth,
93 .IR "\*(OXware" .
94 .PP
95 DVI structure topic on CTAN: https://ctan.org/topic/dvi-struc
96 .br
97 Package page on CTAN: https://ctan.org/pkg/dvitype
98 .br
99 Section in the Web2c manual:
100 https://tug.org/texinfohtml/web2c.html#dvitype-invocation
101 .br
102 Typeset source code, including the DVI file format description:
103 https://ctan.org/pkg/knuth-pdf
104 .\"=====================================================================
105 .SH AUTHORS
106 Donald E. Knuth wrote the program, based on work by David Fuchs. It was
107 published as part of the
108 .I \*(OXware
109 technical report from Stanford. Howard Trickey and Pavel Curtis
110 originally ported it to Unix. Yannis Haralambous and John Plaice created
111 the Omega version.
112 .PP
113 Public discussion list and bug reports: https://lists.tug.org/tex-k