← Back to branch summary

~ubuntu-branches/ubuntu/jaunty/texlive-bin/jaunty

« back to all changes in this revision

Viewing changes to build/source/texk/web2c/man/tftopl.man

  • Committer: Bazaar Package Importer
  • Author(s): Norbert Preining
  • Date: 2008-06-26 23:14:59 UTC
  • mfrom: (2.1.30 intrepid)
  • Revision ID: james.westby@ubuntu.com-20080626231459-y02rjsrgtafu83yr
Tags: 2007.dfsg.2-3
http://bugs.debian.org/482915
add missing source roadmap.fig of roadmap.eps in fontinst documentation
(Closes: #482915) (urgency medium due to RC bug)
(new patch add-missing-fontinst-source)

Show diffs side-by-side

added added

removed removed

Lines of Context:
build/source/texk/web2c/man/tftopl.man
 
1
.TH TFTOPL 1 "17 December 1994" "Web2C @VERSION@"
 
2
.\"=====================================================================
 
3
.if n .ds MF Metafont
 
4
.if t .ds MF M\s-2ETAFONT\s0
 
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 for troff
 
8
.el .ds OX TeX for nroff
 
9
.\" the same but obliqued
 
10
.\" BX definition must follow TX so BX can use TX
 
11
.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
 
12
.if n .ds BX BibTeX
 
13
.\" LX definition must follow TX so LX can use TX
 
14
.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
 
15
.if n .ds LX LaTeX
 
16
.\"=====================================================================
 
17
.SH NAME
 
18
tftopl \- convert TeX font metric (tfm) files to property lists
 
19
.SH SYNOPSIS
 
20
.B tftopl
 
21
[
 
22
.BI \-charcode-format =format
 
23
]
 
24
[
 
25
.B \-verbose
 
26
]
 
27
.I tfm_name[.tfm]
 
28
[
 
29
.I pl_name[.pl]
 
30
]
 
31
.\"=====================================================================
 
32
.SH DESCRIPTION
 
33
This manual page is not meant to be exhaustive.  The complete
 
34
documentation for this version of \*(TX can be found in the info file
 
35
or manual
 
36
.IR "Web2C: A TeX implementation" .
 
37
.PP
 
38
The
 
39
.B tftopl
 
40
program translates a (program-oriented) font metric file to a
 
41
(human-oriented) property list file.  Thus, you can edit the contents of
 
42
the TFM files, if the font designer has not done his or her job
 
43
properly, or if you're encountering strange difficulties, or if you're
 
44
just curious.  It also serves as a TFM-file validating program, i.e., if
 
45
no error messages are given, the input file is correct.
 
46
.PP
 
47
The
 
48
.I pl_name
 
49
is extended with
 
50
.I .pl
 
51
if it lacks a suffix.
 
52
If
 
53
.I pl_name
 
54
is not given, standard output is used. Likewise, 
 
55
.I tfm_name
 
56
is extended with
 
57
.I .tfm
 
58
if it lacks a suffix.  Also, path searching is done for the
 
59
.I .tfm
 
60
file
 
61
using the environment variable TEXFONTS.  If that is not set, 
 
62
.B tftopl
 
63
uses the system default.
 
64
.PP
 
65
See
 
66
.BR tex (1)
 
67
for the details of the searching.
 
68
.\"=====================================================================
 
69
.SH OPTIONS
 
70
The argument
 
71
.I format
 
72
to
 
73
.B \-charcode-format
 
74
specifies how character codes are output in the PL file.  By
 
75
default, only letters and digits are output using the
 
76
.B C
 
77
integer code (i.e., in ASCII); the others are output in octal.  (Unless
 
78
the font's coding scheme starts with
 
79
.B "TeX math sy"
 
80
or
 
81
.BR "TeX math ex" ,
 
82
in which case all character codes are output in octal.)  If
 
83
.I format
 
84
is
 
85
.BR ascii ,
 
86
all character codes that correspond to graphic characters, besides the
 
87
left and right parentheses, are output in ASCII.  Finally, if
 
88
.I format
 
89
is
 
90
.BR octal ,
 
91
all character codes are output in octal.
 
92
.PP
 
93
Without the
 
94
.B \-verbose
 
95
option,
 
96
.B tftopl
 
97
operates silently.  With it, a banner and progress report are printed on
 
98
.IR stdout .
 
99
.\"=====================================================================
 
100
.SH "SEE ALSO"
 
101
.BR pltotf (1),
 
102
.br
 
103
Donald E. Knuth,
 
104
.IR "\*(OXware" .
 
105
.br
 
106
Donald E. Knuth,
 
107
.I "The \*(MFbook"
 
108
(Volume C of
 
109
.IR "Computers and Typesetting" ),
 
110
Addison-Wesley, 1986, ISBN 0-201-13445-4.
 
111
.\"=====================================================================
 
112
.SH AUTHORS
 
113
Donald E. Knuth wrote the program. It was published as
 
114
part of the
 
115
.I \*(OXware
 
116
technical report, available from the \*(TX Users Group.
 
117
Howard Trickey and Pavel Curtis originally ported it to Unix.