summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-08-14 23:58:45 +0000
committerKarl Berry <karl@freefriends.org>2009-08-14 23:58:45 +0000
commit24cae3b11af39b5af7f57341569b1ec045d2db99 (patch)
treeff10c141d5a6957b606a62de7ed486462c7304d9 /Master/texmf/doc/man
parent30d401dbe76f4a5e3e7d6edf4d8af9a5a279e836 (diff)
pkfix-helper 1.2 (9aug09)
git-svn-id: svn://tug.org/texlive/trunk@14682 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc/man')
-rw-r--r--Master/texmf/doc/man/man1/pkfix-helper.131
-rw-r--r--Master/texmf/doc/man/man1/pkfix-helper.pdfbin20837 -> 21536 bytes
2 files changed, 22 insertions, 9 deletions
diff --git a/Master/texmf/doc/man/man1/pkfix-helper.1 b/Master/texmf/doc/man/man1/pkfix-helper.1
index 98b05b9fdc9..cd7f205f472 100644
--- a/Master/texmf/doc/man/man1/pkfix-helper.1
+++ b/Master/texmf/doc/man/man1/pkfix-helper.1
@@ -124,7 +124,7 @@
.\" ========================================================================
.\"
.IX Title "PKFIX-HELPER 1"
-.TH PKFIX-HELPER 1 "2009-04-11" "v1.1" " "
+.TH PKFIX-HELPER 1 "2009-08-03" "v1.2" " "
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -139,6 +139,7 @@ pkfix-helper
[\fB\-\-force\fR=\fIname\fR=\fIfontspec\fR]
[\fB\-\-ps\fR=\fIfilename.ps\fR]
[\fB\-\-tex\fR=\fIfilename.tex\fR]
+[\fB\-\-cache\fR=\fIfilename\fR]
[\fB\-\-include\fR=\fIfontspec\fR]
[\fB\-\-exclude\fR=\fIregexp\fR]
[\fB\-\-quiet\fR]
@@ -250,6 +251,18 @@ name and a font sample of every font that \fBpkfix-helper\fR used in the
output document.
.SS "Infrequently Used Options"
.IX Subsection "Infrequently Used Options"
+.IP "\fB\-C\fR \fIfilename\fR, \fB\-\-cache\fR=\fIfilename\fR" 4
+.IX Item "-C filename, --cache=filename"
+Speed up \s-1TFM\s0 file processing by caching character metrics into file
+\&\fIfilename\fR. On some systems it takes a long time to read a \s-1TFM\s0 file,
+spawn \fItftopl\fR to convert it to \s-1PL\s0 format, and extract from the \s-1PL\s0
+data the metrics for each character. The first time \fB\-\-cache\fR is
+specified, \fBpkfix-helper\fR proceeds as normal then writes all of the
+extracted character metrics to \fIfilename\fR. On subsequent runs in
+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\-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
@@ -294,7 +307,7 @@ is the name of a PostScript file produced by an old version of
verifying that \fBpkfix\fR can't convert the file on its own:
.PP
.Vb 3
-\& % pkfix oldfile.ps newfile.ps
+\& $ pkfix oldfile.ps newfile.ps
\& PKFIX 1.3, 2005/02/25 \- Copyright (c) 2001, 2005 by Heiko Oberdiek.
\& ==> no fonts converted
.Ve
@@ -308,7 +321,7 @@ In its simplest form, \fBpkfix-helper\fR takes the name of an input file
file but serve as suitable input for \fBpkfix\fR:
.PP
.Vb 10
-\& % pkfix\-helper oldfile.ps pkfix\-oldfile.ps
+\& $ pkfix\-helper oldfile.ps pkfix\-oldfile.ps
\& Reading netpipe.ps ... done.
\& Number of Type 3 fonts encountered: 10
\& Bitmapped fonts are typeset at 600 DPI.
@@ -326,7 +339,7 @@ file but serve as suitable input for \fBpkfix\fR:
\& Processing Fg ... done (cmsy10 @ 1X, mismatch=0.00875).
\& Processing Fc ... done (cmr6 @ 1X, mismatch=0.00284).
\&
-\& % pkfix pkfix\-oldfile.ps newfile.ps
+\& $ pkfix pkfix\-oldfile.ps newfile.ps
\& PKFIX 1.3, 2005/02/25 \- Copyright (c) 2001, 2005 by Heiko Oberdiek.
\& *** Font conversion: \`cmti10\*(Aq \-> \`CMTI10\*(Aq.
\& *** Font conversion: \`cmr8\*(Aq \-> \`CMR8\*(Aq.
@@ -352,16 +365,16 @@ strongly recommended that the user produce \*(L"before\*(R" and \*(L"after\*(R"
sheets:
.PP
.Vb 2
-\& % pkfix\-helper \-q oldfile.ps pkfix\-oldfile.ps \e
+\& $ pkfix\-helper \-q oldfile.ps pkfix\-oldfile.ps \e
\& \-\-ps=oldfonts.ps \-\-tex=newfonts.tex
\&
-\& % tex newfonts.tex
+\& $ tex newfonts.tex
\& This is TeX, Version 3.14159 (Web2C 7.4.5)
\& (./newfonts.tex [1] )
\& Output written on newfonts.dvi (1 page, 1292 bytes).
\& Transcript written on newfonts.log.
\&
-\& % dvips newfonts.dvi \-o newfonts.ps
+\& $ dvips newfonts.dvi \-o newfonts.ps
\& This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com)
\& \*(Aq TeX output 2006.06.11:1636\*(Aq \-> newfonts.ps
\& <texc.pro><8r.enc><texps.pro>. <cmr6.pfb><cmsy10.pfb><cmbx10.pfb><cmbx12.pfb>
@@ -384,7 +397,7 @@ program to automatically detect an optimal scaling factor, even if
doing so means choosing a highly nonstandard font size:
.PP
.Vb 7
-\& % pkfix\-helper oldfile.ps pkfix\-oldfile.ps \-\-force="Ff=cmb12 @ *"
+\& $ pkfix\-helper oldfile.ps pkfix\-oldfile.ps \-\-force="Ff=cmb12 @ *"
\& Reading netpipe.ps ... done.
\& Number of Type 3 fonts encountered: 10
\& Bitmapped fonts are typeset at 600 DPI.
@@ -397,7 +410,7 @@ Oops, it looks like we don't have a \fIcmb12.tfm\fR file on our system.
Let's try scaling up \fIcmb10.tfm\fR instead:
.PP
.Vb 10
-\& % pkfix\-helper oldfile.ps pkfix\-oldfile.ps \-\-force="Ff=cmb10 @ *"
+\& $ pkfix\-helper oldfile.ps pkfix\-oldfile.ps \-\-force="Ff=cmb10 @ *"
\& Reading netpipe.ps ... done.
\& Number of Type 3 fonts encountered: 10
\& Bitmapped fonts are typeset at 600 DPI.
diff --git a/Master/texmf/doc/man/man1/pkfix-helper.pdf b/Master/texmf/doc/man/man1/pkfix-helper.pdf
index b735bd99b0f..4c1f54c3d45 100644
--- a/Master/texmf/doc/man/man1/pkfix-helper.pdf
+++ b/Master/texmf/doc/man/man1/pkfix-helper.pdf
Binary files differ