source/texk/web2c/man/gftype.man

   1 .TH GFTYPE 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 gftype \- translate a generic font file for humans to read
  18 .SH SYNOPSIS
  19 .B gftype
  20 .RB [ \-i ]
  21 .RB [ \-m ]
  22 .I gf_file_name
  23 .RI [ output_file_name ]
  24 .\"=====================================================================
  25 .SH DESCRIPTION
  26 This manual page is not meant to be exhaustive.  The complete
  27 documentation for this version of \*(TX can be found in the info file
  28 or manual
  29 .IR "Web2C: A TeX implementation" .
  30 .PP
  31 The
  32 .B gftype
  33 program
  34 translates a
  35 .I gf
  36 (generic font) file output by, for example,
  37 .BR mf (1),
  38 to a file that humans can read.
  39 It also serves as a
  40 .I gf
  41 file-validating
  42 program (i.e., if
  43 .B gftype
  44 can read it, it's correct) and as an example of a
  45 .IR gf -reading
  46 program for other software that wants to read
  47 .I gf
  48 files.
  49 .PP
  50 The
  51 .I gf_file_name
  52 on the command line must be complete. Because
  53 the resolution is part of the extension, it would not make
  54 sense to append a default extension as is done with \*(TX or
  55 DVI-reading software. If no
  56 .I output_file_name
  57 is specified, the output goes to
  58 .IR stdout .
  59 .\"=====================================================================
  60 .SH OPTIONS
  61 The output file includes
  62 bitmap images of the characters, if
  63 .B \-i
  64 is given on the command line, and a symbolic listing of the
  65 .I gf
  66 commands, if
  67 .B \-m
  68 is specified.
  69 .\"=====================================================================
  70 .SH ENVIRONMENT
  71 .B gftype
  72 looks for
  73 .I gf_file_name
  74 using the
  75 environment variable GFFONTS.  If that is not set, it uses the variable
  76 TEXFONTS.  If that is not set, it uses the system default.
  77 .\"=====================================================================
  78 .SH "SEE ALSO"
  79 .BR dvitype (1),
  80 .BR pktype (1).
  81 .br
  82 Donald E. Knuth et al.,
  83 .IR \*(MFware .
  84 .\"=====================================================================
  85 .SH AUTHORS
  86 David Fuchs and Don Knuth wrote the program.  It was published as
  87 part of the
  88 .I \*(MFware
  89 technical report, available from the \*(TX Users Group.
  90 Paul Richards originally ported it to Unix.