Debian Codegraph @

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

raw
1 .TH GFTOPK 1 "25 January 2026" "Web2C 2026"
2 .\"=====================================================================
3 .if n .ds MF Metafont
4 .if t .ds MF Metafont
5 .if t .ds TX \fRT\\h'-0.10m'\\v'0.17v'E\\v'-0.17v'\\h'-0.06m'X\fP
6 .if n .ds TX TeX
7 .\"=====================================================================
8 .SH NAME
9 gftopk \- convert generic font (gf) bitmap files to packed font (pk) files
10 .SH SYNOPSIS
11 .B gftopk
12 .RB [ -v ]
13 .IR gf_file [gf]
14 .RI [ pk_file ]
15 .\"=====================================================================
16 .SH DESCRIPTION
17 The
18 .B gftopk
19 program converts a generic font
20 .RI ( gf )
21 bitmap file output by, typically,
22 .BR mf (1),
23 to a
24 packed font bitmap file for use by DVI-reading programs; notably,
25 .BR dvips (1)
26 only supports \fIpk\fP files.
27 Packed font files
28 .RI ( pk " files)"
29 are much smaller than the corresponding
30 .I gf
31 files.
32 .PP
33 The
34 .I gf_file
35 on the command line must include the resolution, but can omit the suffix
36 "gf". The
37 .I pk_file
38 defaults to the same (stripped) name as
39 .IR gf_file ,
40 and it is placed in the current
41 working directory with the
42 .B pk
43 suffix replacing
44 .BR gf .
45 For example, the input file
46 .I /some/directory/cmr10.300gf
47 would become
48 .IR cmr10.300pk .
49 .\"=====================================================================
50 .SH OPTIONS
51 See
52 .BR tex (1)
53 for details of command-line parsing.
54 .PP
55 By default,
56 .B gftodvi
57 operates silently. With the \fB-v\fP (a.k.a\&. \fB-verbose\fP) option,
58 some reports are printed on stdout.
59 .PP
60 The standard
61 .B -help
62 and
63 .B -version
64 options are also supported.
65 .\"=====================================================================
66 .SH ENVIRONMENT
67 The program looks for
68 .I gf_file
69 using the environment variables GFFONTS, GLYPHFONTS, and TEXFONTS, in
70 that order. If none are set, it uses the system default. See the
71 Kpathsea manual at https://tug.org/kpathsea for the details of the
72 searching.
73 .\"=====================================================================
74 .SH "SEE ALSO"
75 .BR dvips (1),
76 .BR gftype (1),
77 .BR pktogf (1),
78 .BR pktype (1).
79 .br
80 Donald E. Knuth et al.,
81 .IR \*(MFware .
82 .PP
83 Package page on CTAN: https://ctan.org/pkg/gftopk
84 .br
85 Section in the Web2c manual:
86 https://tug.org/texinfohtml/web2c.html#gftopk-invocation
87 .br
88 Typeset source code, including file format descriptions:
89 https://ctan.org/pkg/knuth-pdf
90 .\"=====================================================================
91 .SH AUTHORS
92 Tomas Rokicki wrote the program. It was published as
93 part of the
94 .I \*(MFware
95 technical report. Paul Richards originally ported it to Unix.
96 .PP
97 Public discussion list and bug reports: https://lists.tug.org/tex-k