source/texk/kpathsea/man/mktexpk.man

   1 .TH MKTEXPK 1 "1 March 2011" "Kpathsea @VERSION@"
   2 .\"=====================================================================
   3 .if n .ds MP MetaPost
   4 .if t .ds MP MetaPost
   5 .if n .ds MF Metafont
   6 .if t .ds MF M\s-2ETAFONT\s0
   7 .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
   8 .if n .ds TX TeX
   9 .ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff
  10 .el .ds OX TeX for nroff
  11 .\" the same but obliqued
  12 .\" BX definition must follow TX so BX can use TX
  13 .if t .ds BX \fRB\s-2IB\s0\fP\*(TX
  14 .if n .ds BX BibTeX
  15 .\" LX definition must follow TX so LX can use TX
  16 .if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
  17 .if n .ds LX LaTeX
  18 .\"=====================================================================
  19 .SH NAME
  20 mktexpk \- create a PK file for a font
  21 .SH SYNOPSIS
  22 .B mktexpk
  23 .RI [ options ]
  24 .I font
  25 .RI [ redirect ]
  26 .\"=====================================================================
  27 .SH DESCRIPTION
  28 This manual page is not meant to be exhaustive.  The complete
  29 documentation for this version of \*(TX can be found in the info file
  30 or manual
  31 .IR "Kpathsea: A library for path searching" .
  32 .PP
  33 .B mktexpk
  34 is used to generate a
  35 .I pk
  36 file from the \*(MF source files or type1 sources for
  37 .IR font ,
  38 if possible.
  39 .PP
  40 If
  41 .I redirect
  42 is given, it must be string of the form
  43 .BI >& n
  44 where
  45 .I n
  46 is the number of the file descriptor which is to receive, instead of
  47 standard output, the name of the generated file.
  48 .PP
  49 .B mktexpk
  50 is typically called by other programs, rather than from the command
  51 line.
  52 .\"=====================================================================
  53 .SH OPTIONS
  54 .B mktexpk
  55 accepts the following options:
  56 .TP
  57 .BI --bdpi \ num
  58 Set the base device resolution.
  59 .TP
  60 .BI --dpi \ num
  61 Generate the font at resolution
  62 .IR num .
  63 .TP
  64 .B --help
  65 Print help message and exit.
  66 .TP
  67 .BI --mag \ mag
  68 The \*(MF magnification that corresponds to the combination of
  69 .I bdpi
  70 and
  71 .I dpi
  72 that has been specified.
  73 .TP
  74 .BI --mfmode \ mode
  75 The \*(MF mode to use.
  76 .TP
  77 .BI --destdir \ dir
  78 A directory name. If the directory is absolute, it is used as-is.
  79 Otherwise, it is appended to the root destination directory set in the
  80 script.
  81 .TP
  82 .B --version
  83 Print version information and exit.
  84 .\"=====================================================================
  85 .SH BUGS
  86 If the
  87 .I mode
  88 is not specified,
  89 .B mktexpk
  90 tries to determine it from
  91 .IR bdpi .
  92 The manner in which this is done is primitive.  Since
  93 .I bpdi
  94 doesn't provide sufficient information to uniquely determine a
  95 .I mode
  96 it is strongly recommended that it be specified explicitly.
  97 .PP
  98 If the
  99 .I mode
 100 and
 101 .I bpdi
 102 don't match, the
 103 .I mode
 104 is discarded.
 105 .PP
 106 The
 107 .I dpi
 108 parameter is redundant, but is not checked for consistency.  Worse,
 109 the program will fail if the wrong
 110 .I dpi
 111 is specified.
 112 .\"=====================================================================
 113 .SH "SEE ALSO"
 114 .BR mktexmf (1),
 115 .BR mktextfm (1).