source/texk/web2c/man/vftovp.man

   1 .TH VFTOVP 1 "16 June 2015" "Web2C @VERSION@"
   2 .\"=====================================================================
   3 .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
   4 .if n .ds TX TeX
   5 .ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP
   6 .el .ds OX TeX
   7 .\" BX definition must follow TX so BX can use TX
   8 .if t .ds BX \fRB\s-2IB\s0\fP\*(TX
   9 .if n .ds BX BibTeX
  10 .\" LX definition must follow TX so LX can use TX
  11 .if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
  12 .if n .ds LX LaTeX
  13 .\"=====================================================================
  14 .SH NAME
  15 vftovp \- convert virtual font (vf) files to virtual property lists (vpl)
  16 .SH SYNOPSIS
  17 .B vftovp
  18 .RI [ OPTIONS ]
  19 .IR vf_name [ \fB.vf\fP ]
  20 .RI [ tfm_name [ \fB.tfm\fP ]
  21 .RI [ vpl_name [ \fB.vpl\fP ]]]
  22 .\"=====================================================================
  23 .SH DESCRIPTION
  24 This manual page is not meant to be exhaustive.  The complete
  25 documentation for this version of \*(TX can be found in the info file
  26 or manual
  27 .IR "Web2C: A TeX implementation" .
  28 .PP
  29 The
  30 .B vftovp
  31 program translates a (program-oriented) virtual font file and its
  32 accompanying \*(TX font metric file to a (human-oriented) property list file.
  33 Thus, the virtual font can be edited, and its exact contents can be
  34 displayed mnemonically.  It also serves as a VF-file validating program;
  35 if no error messages are given, the input files are correct.
  36 .PP
  37 The filenames are extended with the appropriate extension if necessary.
  38 .\"=====================================================================
  39 .SH OPTIONS
  40 .TP
  41 .BI \-charcode-format= format
  42 The argument
  43 .I format
  44 specifies how character codes are output in the VPL file.  By
  45 default, only letters and digits are output using the
  46 .B C
  47 integer code (i.e., in ASCII); the others are output in octal.  (Unless
  48 the font's coding scheme starts with
  49 .B "TeX math sy"
  50 or
  51 .BR "TeX math ex" ,
  52 when all are output in octal.)  If
  53 .I format
  54 is
  55 .BR ascii ,
  56 all character codes that correspond to graphic characters, besides the
  57 left and right parentheses, are output in ASCII.  On the other hand, if
  58 .I format
  59 is
  60 .BR octal ,
  61 all character codes are output in octal.
  62 .PP
  63 .TP
  64 .B \-verbose
  65 Without this option,
  66 .B vftovp
  67 operates silently.  With it, a banner and progress report are printed on
  68 .IR stdout .
  69 .\"=====================================================================
  70 .SH ENVIRONMENT
  71 .B vftovp
  72 looks for
  73 .I vf_name
  74 using the
  75 environment variable VFFONTS.  If that is not set, it uses the variable
  76 TEXFONTS.  If that is not set, it uses the system default.
  77 .PP
  78 See
  79 .BR tex (1)
  80 for the details of the searching.
  81 .\"=====================================================================
  82 .SH "SEE ALSO"
  83 .BR pltotf (1),
  84 .BR tftopl (1),
  85 .BR vptovf (1).
  86 .\"=====================================================================
  87 .SH AUTHORS
  88 Donald E. Knuth wrote the program, based in part on an idea of David Fuchs,
  89 starting with the code for
  90 .BR tftopl (1).
  91 Karl Berry adapted it for compilation with
  92 .BR web2c .