source/texk/web2c/man/pktype.man

   1 .TH PKTYPE 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 pktype \- verify and translate a packed font bitmap file to plain text
  18 .SH SYNOPSIS
  19 .B pktype
  20 .IR pk_file [pk]
  21 .\"=====================================================================
  22 .SH DESCRIPTION
  23 This manual page is not meant to be exhaustive.  The complete
  24 documentation for this version of \*(TX can be found in the info file
  25 or manual
  26 .IR "Web2C: A TeX implementation" .
  27 .PP
  28 The
  29 .B pktype
  30 program translates a packed font file
  31 .RI ( pk )
  32 (output by, for example,
  33 .BR gftopk (1)
  34 to a file that humans can read. It also serves as a
  35 .I pk
  36 file-validating program (i.e., if
  37 .B pktype
  38 can read it, it's correct) and as an example of a
  39 .IR pk -reading
  40 program for other software that wants to read
  41 .I pk
  42 files.
  43 .PP
  44 The input
  45 .I pk_file
  46 on the command line may omit the suffix `pk.
  47 The plain text translation is always written to standard output.
  48 .PP
  49 The output file gives a compact encoding of the packed encoding, using
  50 conventions described in the source code. Run lengths of black pixels
  51 alternate with parenthesized run lengths of white pixels, and brackets
  52 are used to indicate when a row should be repeated.
  53 .\"=====================================================================
  54 .SH ENVIRONMENT
  55 .B pktype
  56 looks for
  57 .I pk_file
  58 in the usual places according to Kpathsea.
  59 .PP
  60 See
  61 .BR tex (1)
  62 for the details of the searching.
  63 .\"=====================================================================
  64 .SH "SEE ALSO"
  65 .BR dvitype (1),
  66 .BR gftopk (1),
  67 .BR gftype (1).
  68 .br
  69 Donald E. Knuth et al.,
  70 .IR \*(MFware .
  71 .\"=====================================================================
  72 .SH AUTHORS
  73 Tomas Rokicki wrote the program,
  74 Donald E. Knuth originally ported it to Unix,
  75 Pierre MacKay originally adapted it for compilation with Web2c.