source/texk/web2c/man/gftodvi.man

   1 .TH GFTODVI 1 "16 June 2015" "Web2C @VERSION@"
   2 .\"=====================================================================
   3 .if n .ds MF Metafont
   4 .if t .ds MF Metafont
   5 .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
   6 .if n .ds TX TeX
   7 .ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP
   8 .el .ds OX TeX
   9 .\" BX definition must follow TX so BX can use TX
  10 .if t .ds BX \fRB\s-2IB\s0\fP\*(TX
  11 .if n .ds BX BibTeX
  12 .\" LX definition must follow TX so LX can use TX
  13 .if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
  14 .if n .ds LX LaTeX
  15 .\"=====================================================================
  16 .SH NAME
  17 gftodvi \- make proof sheets from generic font files
  18 .SH SYNOPSIS
  19 .B gftodvi
  20 .RB [ \-overflow-label-offset=\fIreal\fP ]
  21 .RB [ \-verbose ]
  22 .I gf_file_name
  23 .\"=====================================================================
  24 .SH DESCRIPTION
  25 This manual page is not meant to be exhaustive.  The complete
  26 documentation for this version of \*(TX can be found in the info file
  27 or manual
  28 .IR "Web2C: A TeX implementation" .
  29 .PP
  30 The
  31 .B gftodvi
  32 program converts a generic font
  33 .RI ( gf )
  34 file output by, for example,
  35 .BR mf (1),
  36 to a device independent (DVI) file (that can then be typeset using the same
  37 software that has already been written for \*(TX). The characters in the
  38 .I gf
  39 file will appear one per page, with labels, titles, and annotations
  40 as specified in Appendix H (Hardcopy Proofs) of
  41 .IR "The \*(MFbook" .
  42 .PP
  43 .B gftodvi
  44 uses other fonts in addition to the main
  45 .I gf
  46 file.
  47 A `gray' font is used to typeset the
  48 pixels that actually make up the character. (We wouldn't
  49 want all the pixels to be simply black, since then labels,
  50 key points, and other information would be lost.)  A `title' font
  51 is used for the information at the top of the page. A `label' font
  52 is used for the labels on key points of the figure. A `slant'
  53 font is used to typeset diagonal lines, which
  54 otherwise have to be simulated using horizontal and vertical rules.
  55 The default gray, title, and label fonts are
  56 .IR gray ,
  57 .IR cmr8 ,
  58 and
  59 .IR cmtt10 ,
  60 respectively; there is no default slant font.
  61 .PP
  62 To change the default fonts, you can give
  63 .BR special
  64 commands in your
  65 \*(MF source file, or you can change the fonts online. An online dialog
  66 ensues if you end the
  67 .I gf_file_name
  68 with a `/'. For example,
  69 .br
  70 .ti +2
  71 gftodvi cmr10.300gf/
  72 .br
  73 .ti +2
  74 Special font substitution: grayfont black
  75 .br
  76 .ti +2
  77 OK; any more? grayfontarea /home/art/don/
  78 .br
  79 .ti +2
  80 OK; any more? slantfont /home/fonts/slantimagen6
  81 .br
  82 .ti +2
  83 OK; any more? <RET>
  84 .br
  85 will use
  86 .I /home/art/don/black
  87 as the `gray' font and
  88 .I /home/fonts/slantimagen6
  89 as the `slant' font (this name indicates
  90 a font for lines with slope 1/6 at the resolution of an Imagen printer).
  91 .PP
  92 The
  93 .I gf_file_name
  94 on the command line must be complete.  Because
  95 the resolution is part of the extension, it would not make
  96 sense to append a default extension as is done with \*(TX or
  97 DVI-reading software. The output file name uses the same
  98 root as the
  99 .I gf
 100 file, with the
 101 .B .dvi
 102 extension added. For example, the input file
 103 .I cmr10.2602gf
 104 would become
 105 .IR cmr10.dvi .
 106 .\"=====================================================================
 107 .SH OPTIONS
 108 The argument to
 109 .B \-overflow-label-offset
 110 specifies the distance from the right edge of the character
 111 bounding box at which the overflow equations (if any) are typeset.
 112 The value is given in \*(TX points.  The default is a little over two
 113 inches.
 114 .PP
 115 Without the
 116 .B \-verbose
 117 option,
 118 .B gftodvi
 119 operates silently.  With it, a banner and progress report are printed on
 120 .IR stdout .
 121 .\"=====================================================================
 122 .SH ENVIRONMENT
 123 .B gftodvi
 124 looks for
 125 .I gf_file_name
 126 using the
 127 environment variable GFFONTS.  If that is not set, it uses the variable
 128 TEXFONTS. If that is not set, it uses the system default.
 129 .PP
 130 See
 131 .BR tex (1)
 132 for the details of the searching.
 133 .\"=====================================================================
 134 .SH FILES
 135 .TP
 136 .I {gray.tfm,.\|.\|.}
 137 The default fonts.
 138 .TP
 139 .I {gray.mf,.\|.\|.}
 140 The \*(MF sources.
 141 .\"=====================================================================
 142 .SH "SEE ALSO"
 143 .BR tex (1),
 144 .BR mf (1).
 145 .br
 146 Donald E. Knuth,
 147 .I "The \*(MFbook"
 148 (Volume C of
 149 .IR "Computers and Typesetting" ),
 150 Addison-Wesley, 1986, ISBN 0-201-13445-4.
 151 .br
 152 Donald E. Knuth et al.,
 153 .IR \*(MFware .
 154 .\"=====================================================================
 155 .SH AUTHORS
 156 Donald E. Knuth wrote the program. It was published as part of the
 157 .I \*(MFware
 158 technical report, available from the \*(TX Users Group.
 159 Paul Richards ported it to Unix.