pkfix-helper 1.4

Usage: pkfix-helper [--help] [--verbose] [--force=*name*=*fontspec*] [--ps=*filename.ps*] [--tex=*filename.tex*] [--cache=*filename*] [--include=*fontspec*] [--exclude=*regexp*] [--keep=*fontspec*] [--quiet] [--no-repeats] [--spp=*number*] [*input.ps* [*output.ps*]] Options: pkfix-helper accepts on the command line the filename of a PostScript document to process (with the default being the standard input device) and the filename of a modified PostScript document to create (with the default being the standard output device). The program also accepts the following command-line options: Frequently Used Options: -h, --help Display usage information and exit. The --verbose and --quiet options can be used to increase and decrease the amount of information presented. -v, --verbose Increase the amount of status information that pkfix-helper displays as it runs. Additional instances of --verbose on the command line further increase the program's verbosity. By default, only major operations are displayed. A single --verbose additionally displays information about individual font comparisons. A second --verbose additionally displays details about some of the program's internal operations. -f *name*=*fontspec*, --force=*name*=*fontspec* Force pkfix-helper to associate a specific font with a given font name appearing the document. *name* is a two-character dvips font name such as "Fa". *fontspec* is a font specification such as "cmmi8" or "cmsy10 @ 1.1X". An asterisk used in the name of the base font (e.g., "cmti*") will automatically try all integral test font sizes from 5 to 17 points ("cmti5", "cmti6", ..., "cmti17"). An asterisk used as a scale value (e.g., "cmsy10 @ *") will be replaced by the scale value that gives the best match to the original font's metrics. The --force option can be specified repeatedly on the command line. -p *filename.ps*, --ps=*filename.ps* Create a PostScript file called *filename.ps* that shows the dvips name and a font sample of every font used by the input document. -t *filename.tex*, --tex=*filename.tex* Create a Plain TeX file called *filename.tex* that shows the dvips name and a font sample of every font that pkfix-helper used in the output document. Infrequently Used Options: -C *filename*, --cache=*filename* Speed up TFM file processing by caching character metrics into file *filename*. On some systems it takes a long time to read a TFM file, spawn tftopl to convert it to PL format, and extract from the PL data the metrics for each character. The first time --cache is specified, pkfix-helper proceeds as normal then writes all of the extracted character metrics to *filename*. On subsequent runs in which --cache=*filename* is specified, pkfix-helper reads the previously extracted metrics from *filename*, going through the tftopl-based process only for TFM files that were not previously encountered. -q, --quiet Instruct pkfix-helper to produce no output during its run except for fatal error messages. -1, --no-repeats Prevent pkfix-helper from associating the same *fontspec* with more than one dvips font name. -i *fontspec*, --include=*fontspec* Add *fontspec* to the list of font specifications against which pkfix-helper compares *every* document font. (In contrast, --force designates a font specification to use only for a *specific* document font.) The --include option can be specified repeatedly on the command line. -x *regexp*, --exclude=*regexp* Remove all font specifications matching regular expression *regexp* from pkfix-helper's list of known fonts. The --exclude option can be specified repeatedly on the command line. -k *fontspec*, --keep=*fontspec* Do not substitute a vector font for bitmapped font *fontspec* ("Fa", "Fb", etc.). This is useful when converting documents that use obscure bitmapped fonts for which there is no vector equivalent. For example, it was somewhat common in the past to include graphics such as university or corporate logos into a document by converting the bitmapped image into a single-character font and using that font in LaTeX. --keep prevents such fonts from being replaced. The --keep option can be specified repeatedly on the command line. -a, --any-scale Allow any value to be used to scale a font when ""*"" is specified as the scale factor. Normally, pkfix-helper considers only integer multiples of 0.1 that are greater than or equal to 1.0 (i.e., *fontname*@1X, "@1.1X", "@1.2X", "@1.3X", etc.). -s, --spp Specify the number of font samples per page to print to the files indicated using the --ps and --tex options. The default value, 25, should work well in most circumstances. Report bugs to scott+pkfh@pakin.org.