development/Win32/packaging/dtl/dt2dv.man

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