beta-0.89.2
[luatex.git] / source / texk / web2c / man / dvitype.man
blobcaad25f09f2c642e250b4411b39264136d88aa0c
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)
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.