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