diff options
Diffstat (limited to 'Build/source/texk/dtl/dv2dt.man')
-rw-r--r-- | Build/source/texk/dtl/dv2dt.man | 719 |
1 files changed, 0 insertions, 719 deletions
diff --git a/Build/source/texk/dtl/dv2dt.man b/Build/source/texk/dtl/dv2dt.man deleted file mode 100644 index 9b5b40a02f3..00000000000 --- a/Build/source/texk/dtl/dv2dt.man +++ /dev/null @@ -1,719 +0,0 @@ -.\" This file is public domain. -.\" Originally written 1995, Geoffrey Tobin. -.\" The author has expressed the hope that any modification will retain enough content to remain useful. He would also appreciate being acknowledged as the original author in the documentation. -.\" This declaration added 2008/11/14 by Clea F. Rees with the permission of Geoffrey Tobin. -.\" ==================================================================== -.\" @Troff-man-file{ -.\" author = "Nelson H. F. Beebe and Geoffrey Tobin", -.\" version = "0.6.0", -.\" date = "08 March 1995", -.\" time = "19:52:00 GMT +11", -.\" filename = "dv2dt.man", -.\" address = "Center for Scientific Computing -.\" Department of Mathematics -.\" University of Utah -.\" Salt Lake City, UT 84112 -.\" USA", -.\" telephone = "+1 801 581 5254", -.\" FAX = "+1 801 581 4148", -.\" checksum = "32328 715 2191 12898", -.\" email = "beebe@math.utah.edu (Internet)", -.\" codetable = "ISO/ASCII", -.\" keywords = "DVI, TeX", -.\" supported = "no", -.\" docstring = "This file contains the UNIX manual pages -.\" for the dv2dt utility, a program for -.\" converting a binary TeX DVI file to an -.\" editable text representation in DTL (DVI Text -.\" Language). The companion dt2dv utility can -.\" convert the output DTL file back to a binary -.\" DVI file. -.\" -.\" The checksum field above contains a CRC-16 -.\" checksum as the first value, followed by the -.\" equivalent of the standard UNIX wc (word -.\" count) utility output of lines, words, and -.\" characters. This is produced by Robert -.\" Solovay's checksum utility.", -.\" } -.\" ==================================================================== -.if t .ds Te T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X -.if n .ds Te TeX -.if t .ds Xe X\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'T -.if n .ds Xe XeT -.TH DV2DT 1 "08 March 1995" "Version 0.6.0" -.\"====================================================================== -.SH NAME -dv2dt \- convert a binary TeX DVI file to DTL text representation -.\"====================================================================== -.SH SYNOPSIS -.B dv2dt -.I input-DVI-file -.I output-DTL-file -.PP -If the filenames are omitted, then -.I stdin -and -.I stdout -are assumed. -.\"====================================================================== -.SH DESCRIPTION -.B dv2dt -converts a binary \*(Te\& DVI file to an editable -text file in DTL -.RI ( "DVI Text Language" ) -format. The companion -.BR dt2dv (1) -utility can convert the DTL file back to a binary -DVI file. -.\"====================================================================== -.SH "DVI COMMAND DESCRIPTION" -\*(Te\& DVI files contain a compact binary -description of typeset pages, as a stream of -operation code bytes, each immediately followed by -zero or more parameter bytes. The format of DVI -files is fully described in Donald E. Knuth, -.IR "\*(Te\&: The Program" , -Addison-Wesley (1986), ISBN 0-201-13437-3, as well -as in the -.BR dvitype (1) -literate program source code. -.PP -For convenience, we provide a summary of DVI -commands here. In the following list, operation -code bytes are given as unsigned decimal values, -followed by their symbolic names (not present in -the DVI file), and a short description. A -designation like -.I b[+n] -means that the operation code byte is followed by -a parameter -.I b -which uses -.I n -bytes, and is signed. Without the plus sign, the -parameter is unsigned. Signed integer parameter -values are always represented in two's complement -arithmetic, which is the system followed by most -computers manufactured today, including all -personal computers and workstations. -.if n .TP \w'\fI128_set1__c[1]\fP'u+3n -.if t .TP \w'\fI243_fnt_def1__k[1]_c[4]_s[4]_d[4]_a[1]_l[1]_n[a+l]\fP'u+3n -.I "0 set_char_0" -Set character 0 from current font. -.TP -.I .\|.\|. -.TP -.I "127 set_char_127" -Set character 127 from current font. -.TP -.I "128 set1 c[1]" -Set 1-byte unsigned character (uchar) number -.IR c . -.TP -.I "129 set2 c[2]" -Set 2-byte uchar number -.IR c . -.TP -.I "130 set3 c[3]" -Set 3-byte uchar number -.IR c . -.TP -.I "131 set4 c[+4]" -Set 4-byte signed character (schar) number -.IR c . -.TP -.I "132 set_rule a[+4] b[+4]" -Set rule, height -.IR a , -width -.IR b . -.TP -.I "133 put1 c[1]" -Put 1-byte uchar -.IR c . -.TP -.I "134 put2 c[2]" -Put 2-byte uchar -.IR c . -.TP -.I "135 put3 c[3]" -Put 3-byte uchar -.IR c . -.TP -.I "136 put4 c[+4]" -Put 4-byte schar -.IR c . -.TP -.I "137 put_rule a[+4] b[+4]" -Put rule, height -.IR a , -width -.IR b . -.TP -.I "138 nop" -Do nothing. -.TP -.I "139 bop c0[+4] .\|.\|. c9[+4] p[+4]" -Beginning of page. The parameters -.I "c0 .\|.\|. c9" -are the \*(Te\& page counters, the contents of -\*(Te\& count registers -.IR "\ecount0 .\|.\|. \ecount9" . -The parameter -.I p -is the byte offset from the beginning of the DVI -file of the previous -.I bop -operation code byte. The first such command in -the file has -.IR "p = \-1" . -.TP -.I "140 eop" -End of page. -.TP -.I "141 push" -Push -.RI ( h,v,w,x,y,z ) -onto stack. -.TP -.I "142 pop" -Pop -.RI ( h,v,w,x,y,z ) -from stack. -.TP -.I "143 right1 b[+1]" -Move right -.I b -units. -.TP -.I "144 right2 b[+2]" -Move right -.I b -units. -.TP -.I "145 right3 b[+3]" -Move right -.I b -units. -.TP -.I "146 right4 b[+4]" -Move right -.I b -units. -.TP -.I "147 w0" -Move right -.I w -units. -.TP -.I "148 w1 b[+1]" -Move right -.I b -units, and set -.IR "w = b" . -.TP -.I "149 w2 b[+2]" -Move right -.I b -units, and set -.IR "w = b" . -.TP -.I "150 w3 b[+3]" -Move right -.I b -units, and set -.IR "w = b" . -.TP -.I "151 w4 b[+4]" -Move right -.I b -units, and set -.IR "w = b" . -.TP -.I "152 x0" -Move right -.I x -units. -.TP -.I "153 x1 b[+1]" -Move right -.I b -units, and set -.IR "x = b" . -.TP -.I "154 x2 b[+2]" -Move right -.I b -units, and set -.IR "x = b" . -.TP -.I "155 x3 b[+3]" -Move right -.I b -units, and set -.IR "x = b" . -.TP -.I "156 x4 b[+4]" -Move right -.I b -units, and set -.IR "x = b" . -.TP -.I "157 down1 a[+1]" -Move down -.I a -units. -.TP -.I "158 down2 a[+2]" -Move down -.I a -units. -.TP -.I "159 down3 a[+3]" -Move down -.I a -units. -.TP -.I "160 down4 a[+4]" -Move down -.I a -units. -.TP -.I "161 y0" -Move right -.I y -units. -.TP -.I "162 y1 a[+1]" -Move right -.I a -units, and set -.IR "y = a" . -.TP -.I "163 y2 a[+2]" -Move right -.I a -units, and set -.IR "y = a" . -.TP -.I "164 y3 a[+3]" -Move right -.I a -units, and set -.IR "y = a" . -.TP -.I "165 y4 a[+4]" -Move right -.I a -units, and set -.IR "y = a" . -.TP -.I "166 z0" -Move right -.I z -units. -.TP -.I "167 z1 a[+1]" -Move right -.I a -units, and set -.IR "z = a" . -.TP -.I "168 z2 a[+2]" -Move right -.I a -units, and set -.IR "z = a" . -.TP -.I "169 z3 a[+3]" -Move right -.I a -units, and set -.IR "z = a" . -.TP -.I "170 z4 a[+4]" -Move right -.I a -units, and set -.IR "z = a" . -.TP -.I "171 fnt_num_0" -Set current font number -.IR "(f) = 0" . -.TP -.I .\|.\|. -.TP -.I "234 fnt_num_63" -Set -.IR "f = 63" . -.TP -.I "235 fnt1 k[1]" -Set -.IR "f = k" . -.TP -.I "236 fnt2 k[2]" -Set -.IR "f = k" . -.TP -.I "237 fnt3 k[3]" -Set -.IR "f = k" . -.TP -.I "238 fnt4 k[+4]" -Set -.IR "f = k" . -.TP -.I "239 xxx1 k[1] x[k]" -Special string -.I x -with -.I k -bytes. -.TP -.I "240 xxx2 k[2] x[k]" -Special string -.I x -with -.I k -bytes. -.TP -.I "241 xxx3 k[3] x[k]" -Special string -.I x -with -.I k -bytes. -.TP -.I "242 xxx4 k[4] x[k]" -Special string -.I x -with (unsigned) -.I k -bytes. -.TP -.I "243 fnt_def1 k[1] c[4] s[4] d[4] a[1] l[1] n[a+l]" -Define font -.IR k . -The parameters are: -.RS -.TP \w'\fIm\fP'u+3n -.I c -Checksum for TFM file. -.TP -.I s -Scale factor, in DVI units. -.TP -.I d -Design size, in DVI units. -.TP -.I a -Length of the ``area'' or directory. -.TP -.I l -Length of the font name. -.TP -.I n -Area and font name string(s). -.RE -.TP -.I "244 fnt_def2 k[2] c[4] s[4] d[4] a[1] l[1] n[a+l]" -Define font -.IR k . -.TP -.I "245 fnt_def3 k[3] c[4] s[4] d[4] a[1] l[1] n[a+l]" -Define font -.IR k . -.TP -.I "246 fnt_def4 k[+4] c[4] s[4] d[4] a[1] l[1] n[a+l]" -Define font -.IR k . -.TP -.I "247 pre i[1] num[4] den[4] mag[4] k[1] x[k]" -Begin preamble. The parameters are: -.RS -.TP \w'\fInum\fP'u+3n -.I i -DVI format. Standard \*(Te\& has -.IR "ID = 2" , -and \*(Te\&-\*(Xe\& has -.IR "ID = 3" . -.TP -.I num -Numerator of 100 nm / DVI unit. -.TP -.I den -Denominator of 100 nm / DVI unit. -.TP -.I mag -1000 * magnification. -.TP -.I k -Comment length. -.TP -.I x -Comment string. -.RE -.TP -.I "248 post p[4] num[4] den[4] mag[4] l[4] u[4] s[2] t[2]" -Begin postamble. The parameters are: -.RS -.TP \w'\fInum\fP'u+3n -.I p -Pointer to final bop. -.TP -.I "num, den, mag" -Duplicates of values in preamble. -.TP -.I l -Height-plus-depth of tallest page, in DVI units. -.TP -.I u -Width of widest page, in DVI units. -.TP -.I s -Maximum stack depth needed to process this DVI file. -.TP -.I t -Total number of pages -.RI ( bop -commands) present. -.RE -.TP -.I "249 post_post q[4] i[1] 223 .\|.\|. 223" -End postamble. The parameters are: -.RS -.TP \w'\fI223\fP'u+3n -.I q -Byte offset from the beginning of the DVI file to -the -.I post -command that started the postamble. -.TP -.I i -DVI format ID, as in the preamble. -.TP -.I -223 -At least four -.I 223 -bytes. -.RE -.TP -.I "250" -Undefined. -.TP -.I .\|.\|. -.TP -.I "255" -Undefined. -.\"====================================================================== -.SH "DTL COMMAND DESCRIPTION" -A DTL file contains one line per command, with a -limit of 1024 characters per line. Each command -contains a symbolic operation name, followed by -zero or more parameter values. The parameter -value descriptions are not repeated here; they can -be found in the previous section. -.TP \w'\fIw0,_w1,_w2,_w3,_w4\fP'u+3n -variety <variety-name> -This command specifies the name of the DTL file -type; it has no DVI file equivalent. -.TP -.I (text) -Series of set_char commands, for printable ASCII text. -.TP -.I \e( -Literal ASCII left parenthesis in (text). -.TP -.I \e) -Literal ASCII right parenthesis in (text). -.TP -.I \e\e -Literal ASCII backslash in (text). -.TP -.I \e" -Literal ASCII double quote in (text). -.TP -.I \eXY -Set_char for character with hexadecimal code XY, -not in parentheses, but by itself for readability. -.TP -.I "s1, s2, s2, s3" -Set, with (1,2,3,4)-byte charcodes. -.TP -.I sr -.IR set_rule . -.TP -.I "p1, p2, p2, p3" -Put, with (1,2,3,4)-byte charcodes. -.TP -.I pr -.IR put_rule . -.TP -.I nop -.I nop -(do nothing). -.TP -.I bop -.I bop -(beginning of page). -.TP -.I eop -.I eop -(end of page). -.TP -.I [ -Push. -.TP -.I ] -Pop. -.TP -.I "r1, r2, r3, r4" -Right, with (1,2,3,4)-byte argument. -.TP -.I "w0, w1, w2, w3, w4" -As in DVI. -.TP -.I "x0, x1, x2, x3, x4" -As in DVI. -.TP -.I "d1, d2, d3, d4" -Down, with (1,2,3,4)-byte argument. -.TP -.I "y0, y1, y2, y3, y4" -As in DVI. -.TP -.I "z0, z1, z2, z3, z4" -As in DVI. -.TP -.I fn -.I fnt_num -(set current font to font number in 0 to 63). -.TP -.I "f1, f2, f3, f4" -.I fnt -(set current font to (1,2,3,4)-byte font number). -.TP -.I special -.I xxx -(special commands with (1,2,3,4)-byte string length). -.TP -.I fd -.I fnt_def -(assign a number to a named font). -.TP -.I pre -Preamble. -.TP -.I post -.I post -(begin postamble). -.TP -.I post_post -.I post_post -(end postamble). -.TP -.I opcode -Undefined DVI command (250 to 255). -.\"====================================================================== -.SH "SAMPLE DTL FILE" -The following 2-line \*(Te\& file -.RS -.nf -Hello. -\ebye -.fi -.RE -when processed with the commands -.RS -.nf -tex hello.tex -dv2dt hello.dvi hello.dtl -.fi -.RE -produces this DTL file: -.RS -.nf -variety sequences-6 -pre 2 25400000 473628672 1000 27 ' TeX output 1995.03.02:2334' -bop 1 0 0 0 0 0 0 0 0 0 -1 -[ -d3 -917504 -] -d4 42152922 -[ -d4 -41497562 -[ -r3 1310720 -fd1 0 11374260171 655360 655360 0 5 '' 'cmr10' -fn0 -(Hello.) -] -] -d3 1572864 -[ -r4 15229091 -(1) -] -eop -post 42 25400000 473628672 1000 43725786 30785863 2 1 -fd1 0 11374260171 655360 655360 0 5 'cmr10' -post_post 152 2 223 223 223 223 -.fi -.RE -The command -.RS -.nf -dt2dv hello.dtl hello.dvi -.fi -.RE -will reconstruct the original DVI file. -.\"====================================================================== -.SH "SEE ALSO" -.BR dt2dv (1), -.BR dvitype (1), -.BR tex (1). -.\"====================================================================== -.SH FILES -.TP \w'\fI*.dvi\fP'u+3n -.I *.dvi -binary \*(Te\& DVI file. -.TP -.I *.dtl -text representation of a \*(Te\& DVI file in -.I "DVI Text Language" -format. -.\"====================================================================== -.SH AUTHOR -.B dv2dt -and -.BR dt2dv (1) -were written by -.RS -.nf -Geoffrey Tobin -Department of Electronic Engineering -La Trobe University -Bundoora, Victoria 3083 -Australia -Tel: +61 3 479 3736 -FAX: +61 3 479 3025 -Email: <G.Tobin@ee.latrobe.edu.au> -.fi -.RE -.PP -These manual pages were primarily written by -.RS -.nf -Nelson H. F. Beebe, Ph.D. -Center for Scientific Computing -Department of Mathematics -University of Utah -Salt Lake City, UT 84112 -Tel: +1 801 581 5254 -FAX: +1 801 581 4148 -Email: <beebe@math.utah.edu> -.fi -.RE -.\"==============================[The End]============================== |