pkfix-helper 1.4 (13jun11)

git-svn-id: svn://tug.org/texlive/trunk@22981 c570f23f-e606-0410-a88d-b1316a301751

2 files changed, 30 insertions, 20 deletions

diff --git a/Master/texmf/doc/man/man1/pkfix-helper.1 b/Master/texmf/doc/man/man1/pkfix-helper.1
index d88b9695aae..c0c170fdbe8 100644
--- a/Master/texmf/doc/man/man1/pkfix-helper.1
+++ b/Master/texmf/doc/man/man1/pkfix-helper.1
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.05)
+.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07)
 .\"
 .\" Standard preamble:
 .\" ========================================================================
@@ -124,7 +124,7 @@
 .\" ========================================================================
 .\"
 .IX Title "PKFIX-HELPER 1"
-.TH PKFIX-HELPER 1 "2010-10-15" "v1.3" " "
+.TH PKFIX-HELPER 1 "2011-06-11" "v1.4" " "
 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 .\" way too many mistakes in technical documents.
 .if n .ad l
@@ -239,7 +239,11 @@ program's internal operations.
 Force \fBpkfix-helper\fR to associate a specific font with a given font
 name appearing the document.  \fIname\fR is a two-character \fBdvips\fR font
 name such as \f(CW\*(C`Fa\*(C'\fR.  \fIfontspec\fR is a font specification such as
-\&\f(CW\*(C`cmsy10\ @\ 1.1X\*(C'\fR.  The \fB\-\-force\fR option can be specified
+\&\f(CW\*(C`cmmi8\*(C'\fR or \f(CW\*(C`cmsy10\ @\ 1.1X\*(C'\fR.  An asterisk used in the name of the
+base font (e.g.,\ \f(CW\*(C`cmti*\*(C'\fR) will automatically try all integral test
+font sizes from 5 to 17 points (\f(CW\*(C`cmti5\*(C'\fR, \f(CW\*(C`cmti6\*(C'\fR,\ ...,
+\&\f(CW\*(C`cmti17\*(C'\fR).  An asterisk used as a scale value (e.g.,\ \f(CW\*(C`cmsy10\ @\ *\*(C'\fR) will be replaced by the scale value that gives the best match to
+the original font's metrics.  The \fB\-\-force\fR option can be specified
 repeatedly on the command line.
 .IP "\fB\-p\fR \fIfilename.ps\fR, \fB\-\-ps\fR=\fIfilename.ps\fR" 4
 .IX Item "-p filename.ps, --ps=filename.ps"
@@ -264,6 +268,14 @@ which \fB\-\-cache\fR=\fIfilename\fR is specified, \fBpkfix-helper\fR reads the
 previously extracted metrics from \fIfilename\fR, going through the
 \&\fItftopl\fR\-based process only for \s-1TFM\s0 files that were not previously
 encountered.
+.IP "\fB\-q\fR, \fB\-\-quiet\fR" 4
+.IX Item "-q, --quiet"
+Instruct \fBpkfix-helper\fR to produce no output during its run except
+for fatal error messages.
+.IP "\fB\-1\fR, \fB\-\-no\-repeats\fR" 4
+.IX Item "-1, --no-repeats"
+Prevent \fBpkfix-helper\fR from associating the same \fIfontspec\fR with
+more than one \fBdvips\fR font name.
 .IP "\fB\-i\fR \fIfontspec\fR, \fB\-\-include\fR=\fIfontspec\fR" 4
 .IX Item "-i fontspec, --include=fontspec"
 Add \fIfontspec\fR to the list of font specifications against which
@@ -286,14 +298,12 @@ as university or corporate logos into a document by converting the
 bitmapped image into a single-character font and using that font in
 LaTeX.  \fB\-\-keep\fR prevents such fonts from being replaced.  The
 \&\fB\-\-keep\fR option can be specified repeatedly on the command line.
-.IP "\fB\-q\fR, \fB\-\-quiet\fR" 4
-.IX Item "-q, --quiet"
-Instruct \fBpkfix-helper\fR to produce no output during its run except
-for fatal error messages.
-.IP "\fB\-1\fR, \fB\-\-no\-repeats\fR" 4
-.IX Item "-1, --no-repeats"
-Prevent \fBpkfix-helper\fR from associating the same \fIfontspec\fR with
-more than one \fBdvips\fR font name.
+.IP "\fB\-a\fR, \fB\-\-any\-scale\fR" 4
+.IX Item "-a, --any-scale"
+Allow any value to be used to scale a font when "\f(CW\*(C`*\*(C'\fR" is specified as
+the scale factor.  Normally, \fBpkfix-helper\fR considers only integer
+multiples of 0.1 that are greater than or equal to 1.0 (i.e.,
+\&\fIfontname\fR\f(CW@1X\fR, \f(CW\*(C`@1.1X\*(C'\fR, \f(CW\*(C`@1.2X\*(C'\fR, \f(CW\*(C`@1.3X\*(C'\fR, etc.).
 .IP "\fB\-s\fR, \fB\-\-spp\fR" 4
 .IX Item "-s, --spp"
 Specify the number of font samples per page to print to the files
@@ -405,7 +415,7 @@ Let's hypothesize that \f(CW\*(C`cmb12\*(C'\fR is a better match than \f(CW\*(C`
 we don't know how much to scale the font.  Fortunately,
 \&\fBpkfix-helper\fR allows \f(CW\*(C`*\*(C'\fR to be used as a scaling factor to tell the
 program to automatically detect an optimal scaling factor, even if
-doing so means choosing a highly nonstandard font size:
+doing so means choosing a nonstandard font size:
 .PP
 .Vb 7
 \&    $ pkfix\-helper oldfile.ps pkfix\-oldfile.ps \-\-force="Ff=cmb12 @ *"
@@ -431,7 +441,7 @@ Let's try scaling up \fIcmb10.tfm\fR instead:
 \&        Processing Fi ... done (cmr10 @ 1X, mismatch=0.11683).
 \&        Processing Fa ... done (cmti10 @ 1X, mismatch=0.08892).
 \&        Processing Fb ... done (cmr8 @ 1X, mismatch=0.07133).
-\&        Processing Ff ... done (cmb10 @ 1.5708X, mismatch=0.00035).
+\&        Processing Ff ... done (cmb10 @ 1.5X, mismatch=0.00035).
 \&        Processing Fh ... done (cmtt10 @ 1X, mismatch=0.06895).
 \&        Processing Fd ... done (cmmi10 @ 1X, mismatch=0.03966).
 \&        Processing Fj ... done (cmbx12 @ 1X, mismatch=0.03972).
@@ -440,12 +450,12 @@ Let's try scaling up \fIcmb10.tfm\fR instead:
 \&        Processing Fc ... done (cmr6 @ 1X, mismatch=0.00284).
 .Ve
 .PP
-The match has definitely improved, although 15.708\ pt. is certainly
-an odd size for a font.  Then again, many documents \fIdo\fR use
-nonstandard sizes so this may in fact be correct.  The best way to
-verify is once again to produce, print, and compare a pair of font
-samples and iterate until all of the fonts look correct.  Use one
-instance of \fB\-\-force\fR for each font you want to alter.
+The match has definitely improved, although 15\ pt. is certainly an
+odd size for a font.  Then again, many documents \fIdo\fR use nonstandard
+sizes so this may in fact be correct.  The best way to verify is once
+again to produce, print, and compare a pair of font samples and
+iterate until all of the fonts look correct.  Use one instance of
+\&\fB\-\-force\fR for each font you want to alter.
 .SH "ENVIRONMENT"
 .IX Header "ENVIRONMENT"
 \&\fBpkfix-helper\fR honors the following environment variables:
@@ -496,7 +506,7 @@ Published by Addison-Wesley, \s-1ISBN\s0 0\-201\-37922\-8,
 Scott Pakin, \fIscott+pkfh@pakin.org\fR
 .SH "COPYRIGHT AND LICENSE"
 .IX Header "COPYRIGHT AND LICENSE"
-Copyright (C) 2010, Scott Pakin
+Copyright (C) 2011, Scott Pakin
 .PP
 This file may be distributed and/or modified under the conditions of
 the LaTeX Project Public License, either version 1.3c of this license
diff --git a/Master/texmf/doc/man/man1/pkfix-helper.man1.pdf b/Master/texmf/doc/man/man1/pkfix-helper.man1.pdf
index 5191b877398..cc8001d7d9c 100644
--- a/Master/texmf/doc/man/man1/pkfix-helper.man1.pdf
+++ b/Master/texmf/doc/man/man1/pkfix-helper.man1.pdf