Debian Codegraph @

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

raw
1 .TH TFTOPL 1 "30 January 2026" "Web2C 2026"
2 .\"=====================================================================
3 .if t .ds TX \fRT\\h'-0.10m'\\v'0.17v'E\\v'-0.17v'\\h'-0.06m'X\fP
4 .if n .ds TX TeX
5 .ie t .ds OX \fIT\h'-0.17m'\v'+0.21m'E\v'-0.21m'\h'-0.04m'X\fP
6 .el .ds OX TeX
7 .\"=====================================================================
8 .SH NAME
9 tftopl \- convert a TeX font metric (tfm) file to property list (pl) format
10 .SH SYNOPSIS
11 .B tftopl
12 .RI [ options ]
13 .IR tfm_file [ \fB.tfm\fP ]
14 .RI [ pl_file [ \fB.pl\fP ]]
15 .\"=====================================================================
16 .SH DESCRIPTION
17 The
18 .B tftopl
19 program translates a (binary) \*(TX font metric file to a (plain text)
20 property list file. Then you can view or edit the contents of the tfm
21 file. It also serves as a tfm-file validating program, i.e., if no error
22 messages are given, the input file is correct.
23 .PP
24 The
25 .I pl_file
26 is extended with
27 .B .pl
28 if necessary.
29 If
30 .I pl_file
31 is not given, standard output is used. Likewise,
32 .I tfm_file
33 is extended with
34 .B .tfm
35 if it lacks a suffix.
36 .\"=====================================================================
37 .SH OPTIONS
38 See
39 .BR tex (1)
40 for details of command-line parsing.
41 .TP
42 .BI -charcode-format= format
43 The argument
44 .I format
45 specifies how character codes are output in the pl file. By default (the
46 historical behavior), ASCII letters and digits are output using the "C"
47 code (i.e., as themselves), and other characters are output in octal;
48 unless the font's coding scheme starts with "TeX math sy" or "TeX math
49 ex", in which case all character codes are output in octal.
50 .IP
51 If
52 .I format
53 is
54 .BR ascii ,
55 all character codes that correspond to graphic characters, besides the
56 left and right parentheses, are output in ASCII.
57 .IP
58 Finally, if
59 .I format
60 is
61 .BR octal ,
62 all character codes are output in octal.
63 (This option is the same as in
64 \fBvftovp\fP.)
65 .TP
66 .B -verbose
67 By default, the program operates silently. With this option, some
68 reports are printed on stdout.
69 .PP
70 The standard
71 .B -help
72 and
73 .B -version
74 options are also supported.
75 .\"=====================================================================
76 .SH ENVIRONMENT
77 The program looks for
78 .I tfm_file
79 using the environment variables TFMFONTS and TEXFONTS, in that order. If
80 neither are set, it uses the system default.
81 .\"=====================================================================
82 .SH "SEE ALSO"
83 .BR pltotf (1),
84 .br
85 Donald E. Knuth,
86 .IR "\*(OXware" .
87 .PP
88 Font utility topic on CTAN: https://ctan.org/topic/font-util
89 .br
90 Package page on CTAN: https://ctan.org/pkg/tftopl
91 .br
92 Section in the Web2c manual (with an example and summary of the pl format):
93 https://tug.org/texinfohtml/web2c.html#tftopl-invocation
94 .br
95 Typeset source code, including the tfm file format description:
96 https://ctan.org/pkg/knuth-pdf
97 .\"=====================================================================
98 .SH AUTHORS
99 Donald E. Knuth wrote the program. It was published as
100 part of the
101 .I \*(OXware
102 technical report from Stanford. Howard Trickey and Pavel Curtis
103 originally ported it to Unix.
104 .PP
105 Public discussion list and bug reports: https://lists.tug.org/tex-k