Debian Codegraph @

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

raw
1 .\" This file is public domain.
2 .\" Originally written 1995, Geoffrey Tobin.
3 .\" The author has expressed the hope that any modification will
4 .\" retain enough content to remain useful. He would also appreciate being
5 .\" acknowledged as the original author in the documentation.
6 .\" This declaration added 2008/11/14 by Clea F. Rees with the
7 .\" permission of Geoffrey Tobin.
8 .\" ====================================================================
9 .\" @Troff-man-file{
10 .\" author = "Nelson H. F. Beebe and Geoffrey R. D. Tobin",
11 .\" version = "0.6.0",
12 .\" date = "08 March 1995",
13 .\" time = "19:57:00 GMT +11",
14 .\" filename = "dt2dv.man",
15 .\" address = "Center for Scientific Computing
16 .\" Department of Mathematics
17 .\" University of Utah
18 .\" Salt Lake City, UT 84112
19 .\" USA",
20 .\" telephone = "+1 801 581 5254",
21 .\" FAX = "+1 801 581 4148",
22 .\" checksum = "03708 156 634 4989",
23 .\" email = "[email protected] (Internet)",
24 .\" codetable = "ISO/ASCII",
25 .\" keywords = "DVI, TeX",
26 .\" supported = "no",
27 .\" docstring = "This file contains the UNIX manual pages
28 .\" for the dt2dv utility, a program for
29 .\" converting a DTL text representation of a TeX
30 .\" DVI file, usually produced by the companion
31 .\" dv2dt utility, back to a binary DVI file.
32 .\"
33 .\" The checksum field above contains a CRC-16
34 .\" checksum as the first value, followed by the
35 .\" equivalent of the standard UNIX wc (word
36 .\" count) utility output of lines, words, and
37 .\" characters. This is produced by Robert
38 .\" Solovay's checksum utility.",
39 .\" }
40 .\" ====================================================================
41 .if t .ds Te T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X
42 .if n .ds Te TeX
43 .TH DT2DV 1 "08 March 1995" "Version 0.6.0"
44 .\"======================================================================
45 .SH NAME
46 dt2dv \- convert a DTL text representation of a TeX DVI file to a binary DVI file
47 .\"======================================================================
48 .SH SYNOPSIS
49 .B dt2dv
50 .RB [ \-debug ]
51 .RB [ \-group ]
52 .RB [ \-si ]
53 .RB [ \-so ]
54 .RI [ input-DTL-file ]
55 .RI [ output-DVI-file ]
56 .PP
57 In the absence of the
58 .B \-si
59 and
60 .B \-so
61 options,
62 both file arguments are
63 .I required
64 in the order
65 .BR "input-DTL-file output-DVI-file" .
66 But also see the OPTIONS section below.
67 No default file extensions are supplied.
68 .\"======================================================================
69 .SH DESCRIPTION
70 .B dt2dv
71 converts a text representation of a \*(Te\& DVI
72 file, usually produced by the companion
73 .BR dv2dt (1)
74 utility, back to a binary DVI file.
75 DTL
76 .RI ( "DVI Text Language" )
77 files can be edited, with care, and then restored
78 to DVI form for processing by any \*(Te\& DVI
79 driver program. In DTL files, font directory names
80 and font names are preceded by a length field,
81 which must be updated if the names are modified.
82 .PP
83 .BR dvitype (1)
84 can also display a textual representation of DVI
85 files, but in some implementations at least, it
86 cannot be used in batch mode, and its output is
87 not well-suited for conversion back to a DVI file.
88 .PP
89 The format of \*(Te\& DVI files is fully described
90 in
91 Donald E.\& Knuth,
92 .IR "\*(Te\&: The Program" ,
93 Addison-Wesley (1986), ISBN 0-201-13437-3, as well
94 as in the
95 .BR dvitype (1)
96 literate program source code. Brief descriptions
97 of the DTL and DVI formats are given in
98 .BR dv2dt (1).
99 .\"======================================================================
100 .SH OPTIONS
101 .\"-----------------------------------------------
102 .TP \w'\-debug'u+3n
103 .B \-debug
104 Turn on detailed debugging output.
105 .\"-----------------------------------------------
106 .TP
107 .B \-group
108 Expect each DTL command to be in parentheses.
109 .\"-----------------------------------------------
110 .TP
111 .B \-si
112 Read all DTL commands from standard input.
113 .\"-----------------------------------------------
114 .TP
115 .B \-so
116 Write all DVI commands to standard output.
117 .\"======================================================================
118 .SH "SEE ALSO"
119 .BR dv2dt (1),
120 .BR dvitype (1),
121 .BR tex (1).
122 .\"======================================================================
123 .SH FILES
124 .TP \w'\fI*.dvi\fP'u+3n
125 .I *.dvi
126 binary \*(Te\& DVI file.
127 .TP
128 .I *.dtl
129 text representation of a \*(Te\& DVI file in
130 .I "DVI Text Language"
131 format.
132 .\"======================================================================
133 .SH AUTHOR
134 .B dt2dv
135 and
136 .BR dv2dt (1)
137 were written by
138 .RS
139 .nf
140 Geoffrey Tobin
141 Department of Electronic Engineering
142 La Trobe University
143 Bundoora, Victoria 3083
144 Australia
145 Tel: +61 3 479 3736
146 FAX: +61 3 479 3025
147 Email: <[email protected]>
148 .fi
149 .RE
150 .PP
151 These manual pages were written primarily by
152 .RS
153 .nf
154 Nelson H.\& F.\& Beebe, Ph.D.
155 Center for Scientific Computing
156 Department of Mathematics
157 University of Utah
158 Salt Lake City, UT 84112
159 Tel: +1 801 581 5254
160 FAX: +1 801 581 4148
161 Email: <[email protected]>
162 .fi
163 .RE
164 .\"==============================[The End]==============================