3rdparty/dtl/dt2dv.man

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