source/texk/web2c/man/pktogf.man

   1 .TH PKTOGF 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 pktogf \- convert packed font files to generic font files
  18 .SH SYNOPSIS
  19 .B pktogf
  20 .RB [ \-v ]
  21 .I pk_file_name
  22 .RI [ gf_file_name ]
  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 pktogf
  32 program converts a packed font file
  33 .RI ( pk )
  34 to a generic font file
  35 .RI ( gf ).
  36 Packed
  37 font files are much smaller than the corresponding
  38 .I gf
  39 files,
  40 but some DVI readers only understand
  41 .I gf
  42 files.
  43 .PP
  44 The
  45 .I pk_file_name
  46 on the command line must be complete. Because
  47 the resolution is part of the extension, it would not make
  48 sense to append a default extension as is done with \*(TX or
  49 DVI-reading software. The
  50 .I gf_file_name
  51 defaults to the same (stripped) name as
  52 .IR pk_file_name ,
  53 and it is placed in the current
  54 working directory with the
  55 .B gf
  56 suffix replacing
  57 .BR pk .
  58 For example, the input file
  59 .I io.300pk
  60 would become
  61 .IR io.300gf .
  62 .\"=====================================================================
  63 .SH OPTIONS
  64 Unless the
  65 .B \-v
  66 switch is given,
  67 .B pktogf
  68 operates silently.  With
  69 .BR \-v ,
  70 the version number of the program and statistics about the
  71 unpacking are output to
  72 .IR stdout .
  73 .\"=====================================================================
  74 .SH ENVIRONMENT
  75 .B pktogf
  76 looks for
  77 .I pk_file_name
  78 using the
  79 environment variable PKFONTS.  If that is not set, it uses the variable
  80 TEXPKS.  If that is not set, it uses TEXFONTS.  If that is not set, it
  81 uses the system default.
  82 .PP
  83 See
  84 .BR tex (1)
  85 for the details of the searching.
  86 .\"=====================================================================
  87 .SH "SEE ALSO"
  88 .BR gftopk (1),
  89 .BR gftype (1),
  90 .BR pktype (1).
  91 .br
  92 Donald E. Knuth et al.,
  93 .IR \*(MFware .
  94 .\"=====================================================================
  95 .SH AUTHORS
  96 Tomas Rokicki wrote the program.
  97 Pierre MacKay adapted it for compilation with
  98 .BR web2c .