source/texk/web2c/man/tftopl.man

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