Debian Codegraph @

texmf-dist/doc/man/man1/gftype.1

raw
1 .TH GFTYPE 1 "25 January 2026" "Web2C 2026"
2 .\"=====================================================================
3 .if n .ds MF Metafont
4 .if t .ds MF Metafont
5 .\"=====================================================================
6 .SH NAME
7 gftype \- verify and translate a generic font (gf) bitmap file to plain text
8 .SH SYNOPSIS
9 .B gftype
10 .RB [ -i ]
11 .RB [ -m ]
12 .IR gf_file [gf]
13 .RI [ output_file ]
14 .\"=====================================================================
15 .SH DESCRIPTION
16 The
17 .B gftype
18 program
19 translates a
20 .I gf
21 (generic font) bitmap file output by, typically,
22 .BR mf (1),
23 to a file that humans can read.
24 It also serves as a
25 .I gf
26 file-validating
27 program (i.e., if
28 .B gftype
29 can read it, it's correct) and as an example of a
30 .IR gf -reading
31 program for other software that wants to read
32 .I gf
33 files.
34 .PP
35 The
36 .I gf_file
37 on the command line must include the resolution, but can omit the suffix
38 "gf". If no
39 .I output_file
40 is specified, the output goes to stdout.
41 .\"=====================================================================
42 .SH OPTIONS
43 See
44 .BR tex (1)
45 for details of command-line parsing.
46 .PP
47 .TP
48 .B -images
49 Includes ASCII art images of the characters in the output.
50 .TP
51 .B -mnemonics
52 Include a symbolic listing of the
53 .I gf
54 commands in the output.
55 .PP
56 The standard
57 .B -help
58 and
59 .B -version
60 options are also supported.
61 .\"=====================================================================
62 .SH ENVIRONMENT
63 The program looks for
64 .I gf_file
65 using the environment variables GFFONTS, GLYPHFONTS, and TEXFONTS, in
66 that order. If none are set, it uses the system default. See the
67 Kpathsea manual at https://tug.org/kpathsea for the details of the
68 searching.
69 .\"=====================================================================
70 .SH "SEE ALSO"
71 .BR dvitype (1),
72 .BR pktype (1).
73 .br
74 Donald E. Knuth et al.,
75 .IR \*(MFware .
76 .PP
77 Package page on CTAN: https://ctan.org/pkg/gftype
78 .br
79 Section in the Web2c manual:
80 https://tug.org/texinfohtml/web2c.html#gftype-invocation
81 .br
82 Typeset source code, including file format descriptions:
83 https://ctan.org/pkg/knuth-pdf
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. Paul Richards originally ported it to Unix.
90 .PP
91 Public discussion list and bug reports: https://lists.tug.org/tex-k