summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-04-16 23:15:11 +0000
committerKarl Berry <karl@freefriends.org>2012-04-16 23:15:11 +0000
commite8a389a2d60b6ff53118a05f72c266fc3bd725b0 (patch)
treea684b2e593b0f7cede10362be9fe321f733e1acc /Master/texmf/doc/man/man1
parentc3c415e17085b0a75a89e652d576f6a943a41649 (diff)
fontools (6mar12)
git-svn-id: svn://tug.org/texlive/trunk@25995 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc/man/man1')
-rw-r--r--Master/texmf/doc/man/man1/afm2afm.1185
-rw-r--r--Master/texmf/doc/man/man1/afm2afm.man1.pdfbin5765 -> 5398 bytes
-rw-r--r--Master/texmf/doc/man/man1/autoinst.1629
-rw-r--r--Master/texmf/doc/man/man1/autoinst.man1.pdfbin25069 -> 29341 bytes
-rw-r--r--Master/texmf/doc/man/man1/cmap2enc.1450
-rw-r--r--Master/texmf/doc/man/man1/cmap2enc.man1.pdfbin16975 -> 0 bytes
-rw-r--r--Master/texmf/doc/man/man1/font2afm.1196
-rw-r--r--Master/texmf/doc/man/man1/font2afm.man1.pdfbin5311 -> 0 bytes
-rw-r--r--Master/texmf/doc/man/man1/ot2kpx.1186
-rw-r--r--Master/texmf/doc/man/man1/ot2kpx.man1.pdfbin6021 -> 7539 bytes
-rw-r--r--Master/texmf/doc/man/man1/pfm2kpx.1208
-rw-r--r--Master/texmf/doc/man/man1/pfm2kpx.man1.pdfbin6179 -> 0 bytes
-rw-r--r--Master/texmf/doc/man/man1/showglyphs.1185
-rw-r--r--Master/texmf/doc/man/man1/showglyphs.man1.pdfbin4582 -> 0 bytes
14 files changed, 528 insertions, 1511 deletions
diff --git a/Master/texmf/doc/man/man1/afm2afm.1 b/Master/texmf/doc/man/man1/afm2afm.1
index d190f994365..d15c5cb8b21 100644
--- a/Master/texmf/doc/man/man1/afm2afm.1
+++ b/Master/texmf/doc/man/man1/afm2afm.1
@@ -1,26 +1,11 @@
-.\" Automatically generated by Pod::Man version 1.15
-.\" Thu Jan 12 09:06:57 2006
+.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
-.\" ======================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
+.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
.de Vb \" Begin verbatim text
.ft CW
.nf
@@ -28,16 +13,15 @@
..
.de Ve \" End verbatim text
.ft R
-
.fi
..
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. | will give a
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
-.\" to do unbreakable dashes and therefore won't be available. \*(C` and
-.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
-.tr \(*W-|\(bv\*(Tr
+.\" double quote, and \*(R" will give a right double quote. \*(C+ will
+.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
@@ -56,26 +40,28 @@
. ds R" ''
'br\}
.\"
-.\" If the F register is turned on, we'll generate index entries on stderr
-.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
-.\" index entries marked with X<> in POD. Of course, you'll have to process
-.\" the output yourself in some meaningful fashion.
-.if \nF \{\
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\"
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD. Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.ie \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. nr % 0
. rr F
.\}
-.\"
-.\" For nroff, turn off justification. Always turn off hyphenation; it
-.\" makes way too many mistakes in technical documents.
-.hy 0
-.if n .na
+.el \{\
+. de IX
+..
+.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
-.bd B 3
. \" fudge factors for nroff and troff
.if n \{\
. ds #H 0
@@ -135,80 +121,79 @@
. ds Ae AE
.\}
.rm #[ #] #H #V #F C
-.\" ======================================================================
+.\" ========================================================================
.\"
.IX Title "AFM2AFM 1"
-.TH AFM2AFM 1 "fontools" "2006-01-12" "fontools"
-.UC
+.TH AFM2AFM 1 "2012-03-06" "fontools" "Marc Penninga"
+.\" For nroff, turn off justification. Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
.SH "NAME"
-afm2afm \- reencode an \fIafm\fR file
+afm2afm \- reencode an afm file
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
-afm2afm \fB\-e\fR \fIencoding\fR [\fB\-o\fR \fIoutput\fR] \fIafmfile\fR
+.IP "\fBafm2afm\fR" 8
+.IX Item "afm2afm"
+[\fB\-help\fR]
+[\fB\-encoding\fR \fIencodingfile\fR]
+[\fB\-output\fR \fIoutputfile\fR]
+\&\fBafmfile\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
-This program reencodes an \fIafm\fR file. It's mainly intended to be used with
-\&\fIafm\fR files that were extracted from TrueType or OpenType fonts, since these
-are often too big to be handled with tools like \fIfontinst\fR (Adobe's
-CaflischScriptPro-Regular font, for example, contains 1289 glyphs and
-278678 kerning pairs, leading to an \fIafm\fR file of nearly 9MB).
+\&\fBafm2afm\fR re-encodes an \fIafm\fR file.
+.PP
+Metrics (including kerning data) for characters not present in the
+chosen encoding are excluded from the output, which resuls in
+much smaller files.
+.PP
+Note that if you don't specify an encoding file, the \fIafm\fR file
+isn't re-encoded, but the unused data is still pruned.
.PP
-Glyphs that are absent from the chosen encoding aren't written to the output,
-which yields much smaller output files.
+The program also generates an entry for a \fIdvips\fR\-style map file,
+but only if the \fIafm\fR file has been re-encoded and
+the output was written to file
+(i.e., if both the \fI\-encoding\fR and \fI\-output\fR options were specified).
+.SH "OPTIONS AND ARGUMENTS"
+.IX Header "OPTIONS AND ARGUMENTS"
+.IP "\fB\-help\fR" 4
+.IX Item "-help"
+Print a short description of the syntax
+.IP "\fB\-encoding\fR \fIencodingfile\fR" 4
+.IX Item "-encoding encodingfile"
+Re-encode to the enconding in \fIencodingfile\fR
+.IP "\fB\-output\fR \fIoutputfile\fR" 4
+.IX Item "-output outputfile"
+Write the result to \fIoutputfile\fR instead of \f(CW\*(C`stdout\*(C'\fR.
+.IP "\fBafmfile\fR" 4
+.IX Item "afmfile"
+The \fIafm\fR file to be re-encoded.
.PP
-The program also generates an entry for a \fIdvips\fR\-style map file.
-.SH "OPTIONS"
-.IX Header "OPTIONS"
-Option names were chosen to match those of \fIttf2afm\fR.
-.Ip "\fB\-e\fR \fIencoding\fR" 4
-.IX Item "-e encoding"
-Reencode using the encoding given in file \fIencoding\fR.
-.Ip "\fB\-o\fR \fIoutput\fR" 4
-.IX Item "-o output"
-Write the reencoded \fIafm\fR to file \fIoutput\fR instead of \f(CW\*(C`stdout\*(C'\fR.
-The mapfile entry will still be written to \f(CW\*(C`stdout\*(C'\fR.
-.SH "FILES"
-.IX Header "FILES"
-All input files are searched using \fBkpsewhich\fR or \fBfindtexmf\fR when these
-commands are available; otherwise only the current working directory
-is searched.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fIautoinst\fR, \fIcmap2enc\fR, \fIfont2afm\fR, \fIot2kpx\fR, \fIpfm2kpx\fR.
+Option names may be shortened to a unique prefix.
.SH "AUTHOR"
.IX Header "AUTHOR"
-Marc Penninga <marc@penninga.info>
-.SH "HISTORY"
-.IX Header "HISTORY"
-.Ip "\fI2005\-01\-10\fR" 12
-.IX Item "2005-01-10"
-First version
-.Ip "\fI2005\-01\-25\fR" 12
-.IX Item "2005-01-25"
-Added printing of mapfile entry
-.Ip "\fI2005\-02\-18\fR" 12
-.IX Item "2005-02-18"
-Rewrote some of the code
-.Ip "\fI2005\-03\-08\fR" 12
-.IX Item "2005-03-08"
-Input files searched via \fBkpsewhich\fR (where available)
-.Ip "\fI2005\-03\-15\fR" 12
-.IX Item "2005-03-15"
-Input files searched using \fBkpsewhich\fR or \fBfindtexmf\fR (if available)
-.Ip "\fI2005\-04\-15\fR" 12
-.IX Item "2005-04-15"
-Updated creation of mapfile entry; look for font file to deduce the correct
-font file format (pfb, pfa, ttf). If no font file is found,
-pfb is assumed.
-.Ip "\fI2005\-04\-20\fR" 12
-.IX Item "2005-04-20"
-Program quits if the specified output file exists
-.Ip "\fI2005\-04\-29\fR" 12
-.IX Item "2005-04-29"
-Improved the documentation
-.Ip "\fI2005\-07\-29\fR" 12
-.IX Item "2005-07-29"
-Some updates to the documentation
-.Ip "\fI2006\-01\-12\fR" 12
-.IX Item "2006-01-12"
-A few minor changes to the code
+Marc Penninga <marcpenninga@gmail.com>
+.SH "COPYRIGHT"
+.IX Header "COPYRIGHT"
+Copyright (C) 2005\-2012 Marc Penninga.
+.SH "LICENSE"
+.IX Header "LICENSE"
+This program is free software; you can redistribute it and/or modify
+it under the terms of the \s-1GNU\s0 General Public License as published
+by the Free Software Foundation, either version 2 of the License,
+or (at your option) any later version.
+A copy of the \s-1GNU\s0 General Public License is included with \fBautoinst\fR;
+see the file \fIGPLv2.txt\fR.
+.SH "DISCLAIMER"
+.IX Header "DISCLAIMER"
+This program is distributed in the hope that it will be useful,
+but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of
+\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0.
+See the \s-1GNU\s0 General Public License for more details.
+.SH "RECENT CHANGES"
+.IX Header "RECENT CHANGES"
+(See the source code for the rest of the story.)
+.IP "\fI2012\-02\-01\fR" 12
+.IX Item "2012-02-01"
+Refactored the code; added the \*(L"no re-encoding, only pruning\*(R"
+functionality.
diff --git a/Master/texmf/doc/man/man1/afm2afm.man1.pdf b/Master/texmf/doc/man/man1/afm2afm.man1.pdf
index 1c980702799..a4884c93ddf 100644
--- a/Master/texmf/doc/man/man1/afm2afm.man1.pdf
+++ b/Master/texmf/doc/man/man1/afm2afm.man1.pdf
Binary files differ
diff --git a/Master/texmf/doc/man/man1/autoinst.1 b/Master/texmf/doc/man/man1/autoinst.1
index 4f1ed4256ae..2e66e514d3b 100644
--- a/Master/texmf/doc/man/man1/autoinst.1
+++ b/Master/texmf/doc/man/man1/autoinst.1
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07)
+.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -124,96 +124,88 @@
.\" ========================================================================
.\"
.IX Title "AUTOINST 1"
-.TH AUTOINST 1 "2011-06-15" "fontools" "fontools"
+.TH AUTOINST 1 "2012-03-06" "fontools" "Marc Penninga"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
-autoinst \- wrapper script around the \fI\s-1LCDF\s0 TypeTools\fR,
+autoinst \- wrapper around the LCDF TypeTools,
for installing OpenType fonts in LaTeX.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
-autoinst [options] \fIfontfile\fR [\fIfontfile\fR ...]
+\&\fBautoinst\fR [\fIoptions\fR] \fBfont(s)\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
-Eddie Kohler's \fITypeTools\fR, especially \fIotftotfm\fR, are great tools for
-installing OpenType fonts for use with LaTeX, but their use (even in
-automatic mode) is quite complicated because it needs lots of long
-command lines and doesn't generate the \fIfd\fR and \fIsty\fR files LaTeX needs.
-\&\fBautoinst\fR simplifies the font installation
-process by generating and executing all commands for \fIotftotfm\fR
-and by creating all necessary \fIfd\fR and \fIsty\fR files.
+Eddie Kohler's \fITypeTools\fR, especially \fIotftotfm\fR, are superb tools
+for installing OpenType fonts in LaTeX, but their use
+(even in automatic mode) is complicated: they need many long
+command lines and don't generate the \fIfd\fR and \fIsty\fR files LaTeX needs.
+\&\fBautoinst\fR simplifies the font installation process with \fIotftotfm\fR
+by generating and executing all command lines
+and by creating and installing all \fIfd\fR and \fIsty\fR files.
.PP
-All the user then needs
-to do is move these files to a suitable location
-(\fI\f(CI$LOCALTEXMF\fI/tex/latex/<Supplier>/<FontFamily>/\fR is the
-official choice) and update TeX's filename database.
-.PP
-Given a family of font files (in either \fI.ttf\fR or \fI.otf\fR format),
+Given a family of font files (in either \fIotf\fR or \fIttf\fR format),
\&\fBautoinst\fR will create several LaTeX font families:
.RS 2
-.IP "\fB\-\fR" 2
-.IX Item "-"
-Four text families (with lining and oldstyle figures, in tabular and
+.IP "\-" 3
+Four text families (with lining and oldstyle digits, in tabular and
proportional variants), each with the following shapes:
+.RS 3
.RS 2
-.RS 2
-.IP "\fIn\fR" 4
+.IP "\fIn\fR" 6
.IX Item "n"
Roman text
-.IP "\fIsc\fR" 4
+.IP "\fIsc\fR" 6
.IX Item "sc"
Small caps
-.IP "\fInw\fR" 4
+.IP "\fInw\fR" 6
.IX Item "nw"
-`Upright swash'; usually normal text with some extra `oldstyle' ligatures,
+\&\*(L"Upright swash\*(R"; usually normal text with some extra \*(L"oldstyle\*(R" ligatures,
such as ct, sp and st.
-.IP "\fItl\fR" 4
+.IP "\fItl\fR" 6
.IX Item "tl"
-Titling shape. Meant for all-caps text only (even though it sometimes contains
-lowercase glyphs as well), where letterspacing and the positioning of
-punctuation characters have been adjusted to suit all-caps text.
-This shape is generated only for the families with lining figures.
-.IP "\fIit\fR" 4
+Titling shape. Meant for all-caps text only (even though it sometimes contains
+lowercase glyphs as well), where letterspacing and the positioning of
+punctuation characters have been adjusted to suit all-caps text.
+This shape is generated only for the families with lining digits, since
+all-caps text doesn't mix with old-style digits.
+.IP "\fIit\fR" 6
.IX Item "it"
-Italic or oblique text
-.IP "\fIscit\fR" 4
+Italic (or oblique) text
+.IP "\fIscit\fR" 6
.IX Item "scit"
Italic small caps
-.IP "\fIsw\fR" 4
+.IP "\fIsw\fR" 6
.IX Item "sw"
Swash
-.IP "\fItlit\fR" 4
+.IP "\fItlit\fR" 6
.IX Item "tlit"
Italic titling
.RE
.RS 2
.RE
.RE
-.RS 2
+.RS 3
.RE
-.IP "\fB\-\fR" 2
-.IX Item "-"
-For each text family: a family of TS1\-encoded symbol fonts,
+.IP "\-" 3
+For each text family: a family of TS1\-encoded symbol fonts,
in roman and italic shapes.
-.IP "\fB\-\fR" 2
-.IX Item "-"
+.IP "\-" 3
Four families with superiors, inferiors, numerators and denominators,
in roman and italic shapes.
-.IP "\fB\-\fR" 2
-.IX Item "-"
+.IP "\-" 3
An ornament family, in roman and italic shapes.
.RE
.RS 2
.RE
.PP
-Of course, if the font doesn't contain oldstyle figures, small caps etc.,
-the corresponding shapes or families are not created;
-furthermore, the creation of most families and shapes can be controlled by
-command-line options (see below).
+Of course, if the fonts don't contain oldstyle digits, small caps etc.,
+the corresponding shapes and families are not created.
+Furthermore, the creation of most families and shapes can be controlled by
+command-line options (see \*(L"COMMAND-LINE \s-1OPTIONS\s0\*(R" below).
.PP
-The generated font families are named \fI<FontFamily>\-<Suffix>\fR,
+The generated font families are named \fI<FontFamily>\-<Suffix>\fR,
where \fI<Suffix>\fR is one of
.IP "\fI\s-1LF\s0\fR" 8
.IX Item "LF"
@@ -229,12 +221,12 @@ proportional oldstyle figures
tabular oldstyle figures
.IP "\fISup\fR" 8
.IX Item "Sup"
-superior characters (many fonts only have an incomplete set
-of superiors: figures, some punctuation and the letters
-\&\fIabdeilmnorst\fR; normal forms will be used for the other characters)
+superior characters (many fonts have only an incomplete set of superiors:
+digits, punctuation and the letters \fIabdeilmnorst\fR;
+normal forms will be used for the other characters)
.IP "\fIInf\fR" 8
.IX Item "Inf"
-inferior characters; usually only figures and punctuation,
+inferior characters; usually only digits and punctuation,
normal forms for the other characters
.IP "\fIOrn\fR" 8
.IX Item "Orn"
@@ -246,313 +238,363 @@ numerators
.IX Item "Dnom"
denominators
.PP
-The generated fonts are named \fI<FontFile>\-<suffix>\-<shape>\-<enc>\fR,
-where \fI<FontFile>\fR is the name of the OpenType file, \fI<suffix>\fR
-is the same as above (but in lowercase), \fI<shape>\fR is either empty,
-`sc', `swash' or `titling', and \fI<enc>\fR is the encoding.
-A typical name in this scheme is \fIMinionPro\-Regular\-osf\-sc\-ly1\fR.
+The generated fonts are named \fI<FontName>\-<suffix>\-<shape>\-<enc>\fR,
+where \fI<suffix>\fR is the same as above (but in lowercase),
+\&\fI<shape>\fR is either empty, \*(L"sc\*(R", \*(L"swash\*(R" or \*(L"titling\*(R",
+and \fI<enc>\fR is the encoding.
+A typical name in this scheme would be \*(L"MinionPro\-Regular\-osf\-sc\-ly1\*(R".
.SS "On the choice of text encoding"
.IX Subsection "On the choice of text encoding"
-By default, all text families use the \s-1LY1\s0 encoding. This has been chosen
-over T1 (Cork) because many OpenType fonts contain additional ligatures
-such as fj and Th, and \s-1LY1\s0 has a number of empty slots to accommodate these.
-Different encodings can be selected using the \fB \-\-encoding\fR
-command line option (see below).
-.SS "Using the fonts with LaTeX"
-.IX Subsection "Using the fonts with LaTeX"
-\&\fBautoinst\fR generates a style file for using the font in LaTeX documents,
-named `<\fIFontFamily\fR>.sty'. This style file also takes care of loading the
+By default, \fBautoinst\fR generates text fonts with \s-1OT1\s0, T1 and \s-1LY1\s0
+encodings, and the generated style files use \s-1LY1\s0 as the default text encoding.
+\&\s-1LY1\s0 has been chosen over T1 because it has some empty slots to accomodate
+the additional ligatures and alternate glyphs provided by many OpenType fonts.
+Different encodings can be selected using the \fI\-encoding\fR
+command-line option (see \*(L"COMMAND-LINE \s-1OPTIONS\s0\*(R" below).
+.SS "Using the fonts in your LaTeX documents"
+.IX Subsection "Using the fonts in your LaTeX documents"
+\&\fBautoinst\fR generates a style file for using the font in LaTeX documents,
+named \fI<FontFamily>.sty\fR. This style file also takes care of loading the
\&\fIfontenc\fR and \fItextcomp\fR packages, if necessary.
-To use the font, simply put \f(CW\*(C`\eusepackage{MinionPro}\*(C'\fR
-(or whatever the font is called) in the preamble of your document.
+To use the font, simply put \f(CW\*(C`\eusepackage{\f(CI<FontFamily>\f(CW}\*(C'\fR
+in the preamble of your document.
.PP
This style file defines a number of options:
.IP "\fIlining, oldstyle, tabular, proportional\fR" 4
.IX Item "lining, oldstyle, tabular, proportional"
-Choose which figures will be used for the text fonts.
-The defaults are `oldstyle' and `proportional' (if available).
+Choose which digits will be used for the text fonts.
+The defaults are \*(L"oldstyle\*(R" and \*(L"proportional\*(R" (if available).
.IP "\fIultrablack, ultrabold, heavy, extrablack, black, extrabold, demibold, semibold, bold\fR" 4
.IX Item "ultrablack, ultrabold, heavy, extrablack, black, extrabold, demibold, semibold, bold"
-Choose the weight that LaTeX will use for the `bold' weight
+Choose the weight that LaTeX will use for the \*(L"bold\*(R" weight
(i.e., the value of \f(CW\*(C`\ebfdefault\*(C'\fR).
.IP "\fIlight, medium, regular\fR" 4
.IX Item "light, medium, regular"
-Choose the weight that LaTeX will use for the `regular' weight
+Choose the weight that LaTeX will use for the \*(L"regular\*(R" weight
(i.e., the value of \f(CW\*(C`\emddefault\*(C'\fR).
.IP "\fIscaled=<scale>\fR" 4
.IX Item "scaled=<scale>"
-Scale the font by a factor of \fI<scale>\fR.
+Scale the font by a factor of \fI<scale>\fR.
For example: to increase the size of the font by 5%, use the command
-\&\f(CW\*(C`\eusepackage[scaled=1.05]{MyriadPro}\*(C'\fR.
+\&\f(CW\*(C`\eusepackage[scaled=1.05]{\f(CI<FontFamily>\f(CW}\*(C'\fR.
.Sp
This option is only available when the \fIxkeyval\fR package is found
in your TeX installation.
.PP
-The style file will also try to load the \fIfontaxes\fR package (part of
-the MinionPro for LaTeX project), which gives easy access to various font
-shapes and styles. This package can be downloaded from the project's homepage
-(\fIhttp://developer.berlios.de/projects/minionpro\fR) or directly through
-the \s-1CVS\s0 web interface
-(\fIhttp://cvs.berlios.de/cgi\-bin/viewcvs.cgi/minionpro/MinionPro/tex/\fR),
-and is also available from \s-1CTAN\s0 as part of the archive \fImetrics\-base.zip\fR
-(\fIhttp://www.ctan.org/tex\-archive/fonts/minionpro/metrics\-base.zip\fR).
-.PP
-Using the machinery set up by \fIfontaxes\fR, the generated style file
-also defines a few commands (which take the text to be typeset as argument)
-and declarations (which don't take arguments, but affect all text up to
+The style file will also try to load the \fIfontaxes\fR package,
+which gives easy access to various font shapes and styles.
+It is available from \s-1CTAN\s0
+(\fIhttp://www.ctan.org/tex\-archive/macros/latex/contrib/fontaxes\fR).
+Using the machinery set up by \fIfontaxes\fR, the generated style file also
+defines a number of commands (which take the text to be typeset as argument)
+and declarations (which don't take arguments, but affect all text up to
the end of the current group) of its own:
.PP
.Vb 1
\& DECLARATION COMMAND SHORT FORM OF COMMAND
-\&
+\&
\& \etlshape \etexttitling \etexttl
-\& \esufigures \etextsuperior \etextsu
+\& \esufigures \etextsuperior \etextsu
\& \einfigures \etextinferior \etextin
.Ve
.PP
In addition, the \f(CW\*(C`\eswshape\*(C'\fR and \f(CW\*(C`\etextsw\*(C'\fR commands are redefined to place
-swash on the secondary shape axis (\fIfontaxes\fR places it on the primary
-shape axis); this allows the use of `upright swash'.
-Just saying \f(CW\*(C`\eswshape\*(C'\fR will still give normal (italic) swash,
-but \f(CW\*(C`\eswshape\eupshape\*(C'\fR results in upright swash.
+swash on the secondary shape axis (\fIfontaxes\fR places it on the primary
+shape axis); this makes these commands behave properly when nested, so that
+\&\f(CW\*(C`\eswshape\eupshape\*(C'\fR will give upright swash.
.PP
-Note that there is no separate command for accessing the italic titling shape;
-but these commands behave properly when nested, so \f(CW\*(C`\etlshape\eitshape\*(C'\fR gives
-italic titling.
-There are also no commands for accessing the numerator and denominator
-fonts; these can be selected using \fIfontaxes\fR' low-level commands,
+There are no commands for accessing the numerator and denominator
+fonts; these can be selected using \fIfontaxes\fR' standard commands,
e.g., \f(CW\*(C`\efontfigurestyle{numerator}\eselectfont\*(C'\fR.
.PP
-The style file also provides a command \f(CW\*(C`\eornament{\f(CI<number>\f(CW}\*(C'\fR,
-where \f(CW\*(C`\f(CI<number>\f(CW\*(C'\fR is a number from 0 to the total number of
-ornaments minus one. Ornaments are always typeset using the current family,
+The style file also provides a command \f(CW\*(C`\eornament{\f(CI<number>\f(CW}\*(C'\fR,
+where \f(CW\*(C`\f(CI<number>\f(CW\*(C'\fR is a number from 0 to the total number of
+ornaments minus one. Ornaments are always typeset using the current family,
series and shape. A list of all ornaments in a font can be created by
-running LaTeX on the file \fInfssfont.tex\fR (part of a standard
-LaTeX installation) and specifying the ornament font
-(e.g., \fIMinionPro-Regular-orn-u\fR).
+running LaTeX on the file \fInfssfont.tex\fR (part of a standard
+LaTeX installation) and supplying the name of the ornament font.
+.PP
+To access the ornaments, \fBautoinst\fR creates a font-specific encoding file
+\&\fI<FontFamily>_orn.enc\fR, but only if that file doesn't yet exist.
+This means you can provide your own encoding vector,
+e.g. if your fonts use non-standard glyph names for ornaments.
.PP
These commands are only generated for shapes and number styles
-that actually exist; no commands are generated for shapes and styles
+that actually exist; no commands are generated for shapes and styles
that don't exist, or whose generation has been turned off.
-.PP
-This whole machinery builds on \fIfontaxes\fR; if that package cannot be found,
-the style file doesn't provide high-level access to the more `exotic'
-font shapes and styles. In that case, you're limited to using the lower-level
-commands from standard \s-1NFSS\s0.
+Please note that these commands are built on top of \fIfontaxes\fR;
+if that package cannot be found, you're limited to using the
+lower-level commands from standard \s-1NFSS\s0 (\f(CW\*(C`\efontfamily\*(C'\fR, \f(CW\*(C`\efontseries\*(C'\fR,
+\&\f(CW\*(C`\efontshape\*(C'\fR etc.).
.SS "Using multiple font families in one document"
.IX Subsection "Using multiple font families in one document"
-If you want to use several font families in one document, make sure
-all fonts were installed using the same version of \fBautoinst\fR.
-\&\fBautoinst\fR has seen some non-backward-compatible changes in the past,
-and \fI.sty\fR and \fI.fd\fR files that were generated by different versions
-of \fBautoinst\fR may not be able to coexist peacefully.
+If you want to use more than one font family in a document, be aware
+that style files generated by versions of \fBautoinst\fR older dan 2009
+are incompatible with those generated by newer versions.
.SS "\s-1NFSS\s0 codes"
.IX Subsection "NFSS codes"
-In \s-1NFSS\s0, weight and width are concatenated into a single `series' attribute.
-\&\fBautoinst\fR maps widths, weights and shapes to \s-1NFSS\s0 codes using
-the following tables. These are based on the tables in Lehman's
-\&\fIFont Installation Guide\fR, but some changes had to be made to avoid
-name clashes for font families with many different widths and weights
-(such as Helvetica Neue).
+\&\s-1NFSS\s0 identifies fonts by a combination of family, series (weight plus width),
+shape and size.
+\&\fBautoinst\fR parses the output of \f(CW\*(C`otfinfo \-\-info\*(C'\fR to determine
+these parameters. When this fails
+(e.g., because the font family contains unusual widths or weights),
+\&\fBautoinst\fR ends up with different fonts having the \fIsame\fR values
+for the font parameters, which means that these fonts cannot be used in \s-1NFSS\s0.
+\&\fBautoinst\fR will then split the font family into multiple subfamilies
+(based on the font's \*(L"Subfamily\*(R" value) and try again.
+(Since many font families overdo the \*(L"Subfamily\*(R" by making each font
+a separate subfamily, this strategy is only used as a last resort.)
+.PP
+If this proliferation of font families is unwanted,
+either rerun \fBautoinst\fR on a smaller set of fonts (omitting the ones that
+failed to parse correctly)
+or else add the missing widths, weights and shapes to the tables \f(CW%FD_WIDTH\fR,
+\&\f(CW%FD_WEIGHT\fR and \f(CW%FD_SHAPE\fR, near the top of the source code.
+Please also send a bug report (see \s-1AUTHOR\s0 below).
+.PP
+\&\fBautoinst\fR maps widths, weights and shapes to \s-1NFSS\s0 codes using
+the following tables. These are based both on the standard \fIFontname\fR scheme
+and on the tables in Philipp Lehman's \fIFont Installation Guide\fR,
+but some changes had to be made to avoid name clashes in font families
+with many different widths and weights.
.PP
.Vb 1
-\& WEIGHT WIDTH
-\&
-\& Thin t Ultra Condensed uc
-\& Ultra Light ul Extra Condensed ec
-\& Extra Light el Condensed c
-\& Light l Semicondensed sc
-\& Book [1] Regular [1]
-\& Regular [1] Semiextended sx
-\& Medium mb Extended x
-\& Demibold db
-\& Semibold sb
-\& Bold b
-\& Extra Bold eb SHAPES
-\& Black a
-\& Extra Black ea Roman n
-\& Heavy h Italic it
-\& Ultra ub Oblique it [2]
-\& Ultra Bold ub RomanI n [3]
-\& Ultra Black ua RomanII it [3]
+\& WEIGHT WIDTH
+\&
+\& Thin t Ultra Compressed up
+\& Ultra Light ul Extra Compressed ep
+\& Extra Light el Compressed, Compact p
+\& Light l Compact p
+\& Book [1] Ultra Condensed uc
+\& Regular [1] Extra Condensed ec
+\& Medium mb Condensed c
+\& Demibold db Narrow n
+\& Semibold sb Semicondensed sc
+\& Bold b Regular [1]
+\& Extra Bold eb Semiextended sx
+\& Ultra ub Extended x
+\& Ultra Bold ub Expanded e
+\& Black k Wide w
+\& Extra Black ek
+\& Ultra Black uk
+\& Heavy h SHAPE
+\& Poster r
+\& Roman, Upright n [2]
+\& Italic it
+\& Cursive, Kursiv it
+\& Oblique, Slanted it [3]
+\& Incline(d) it [3]
.Ve
+.PP
+\fINotes:\fR
+.IX Subsection "Notes:"
.IP "[1]" 4
.IX Item "[1]"
-When \fIboth\fR weight and width are empty, the `series' attribute becomes `m'.
+When \fIboth\fR weight and width are empty, the \*(L"series\*(R" attribute becomes \*(L"m\*(R".
.IP "[2]" 4
.IX Item "[2]"
-Mapping the `Oblique' shape to `it' instead of the canonical `sl' simplifies
-\&\fBautoinst\fR. Since font families with both `Italic' and `Oblique' shapes
-probably do not exist (apart from Computer Modern),
-this shouldn't cause problems in real life.
+Adobe Silentium Pro contains two \*(L"Roman\*(R" shapes (\*(L"RomanI\*(R" and \*(L"RomanII\*(R");
+the first of these is mapped to \*(L"n\*(R", the second one to \*(L"it\*(R".
.IP "[3]" 4
.IX Item "[3]"
-To the best of my knowledge, the only font family that has two `Roman' shapes
-is Silentium; since this has no `Italic' shape,
-the `it' code is (ab)used for the `RomanII' shape.
-.SS "A note for MikTeX users"
-.IX Subsection "A note for MikTeX users"
-Calling \fIotftotfm\fR with the \fB \-\-automatic\fR option (as \fBautoinst\fR does by
-default) requires a TeX-installation that uses the \fIkpathsea\fR library; with
-TeX-installations that implement their own directory searching
-(such as MiKTeX) \fIotftotfm\fR might complain that it
-cannot find a writable \fItexmf\fR directory and leave all generated \fItfm\fR,
-\&\fIvf\fR, \fIenc\fR and \fImap\fR files in the current working directory.
-In that case, you need to move these to their correct destinations.
-You also need to tell the dvi-driver (\fIdvips\fR, \fIdvipdfm\fR, \fIpdfTeX\fR etc.)
-about the new font map files; see the documentation for how this is done.
+Mapping the \*(L"Slanted\*(R", \*(L"Oblique\*(R" or \*(L"Inclined\*(R" shape to \*(L"it\*(R" instead of \*(L"sl\*(R"
+simplifies \fBautoinst\fR. Since font families with both italic and slanted
+shapes do \- to the best of my knowledge \- not exist
+(apart from Computer Modern, of course),
+this shouldn't cause problems in real life.
+.SS "A note for MiKTeX users"
+.IX Subsection "A note for MiKTeX users"
+Automatically installing the fonts into a suitable \s-1TEXMF\s0 tree
+(as \fBautoinst\fR does by default) requires a TeX-installation that uses
+the \fIkpathsea\fR library; with TeX distributions that implement their
+own directory searching (such as MiKTeX), \fBautoinst\fR will complain that
+it cannot find the \fIkpsewhich\fR program and install all generated files
+into subdirectories of the current directory.
+If you use such a TeX distribution, you should either move these files
+to their correct destinations by hand, or use the \fI\-target\fR option
+(see \*(L"COMMAND-LINE \s-1OPTIONS\s0\*(R" below) to specify a \s-1TEXMF\s0 tree.
.PP
-Also, some OpenType fonts lead to \fIpl\fR and \fIvpl\fR files that are too
-big for MiKTeX's \fIpltotf\fR and \fIvptovf\fR; the versions from TeXLive
-(\fIhttp://tug.org/ftp/texlive/Contents/live/bin/win32/\fR) don't have this
-problem.
+Also, some OpenType fonts lead to \fIpl\fR and \fIvpl\fR files that
+are too big for MiKTeX's \fIpltotf\fR and \fIvptovf\fR;
+the versions that come with W32TeX (\fIhttp://www.w32tex.org\fR)
+and TeXLive (\fIhttp://tug.org/texlive\fR) don't have this problem.
.SH "COMMAND-LINE OPTIONS"
.IX Header "COMMAND-LINE OPTIONS"
-.IP "\fB \-\-encoding\fR=\fIencoding[,encoding]\fR" 4
-.IX Item " --encoding=encoding[,encoding]"
-Use the encoding \fIencoding\fR for the text fonts. The default is `\s-1LY1\s0'.
-A file named `<\fIencoding\fR>.enc' (in all \fIlowercase\fR) should be somewhere
-where \fIotftotfm\fR can find it. Suitable encoding files
-for \s-1LY1\s0, \s-1OT1\s0 and T1/TS1 come with \fIfontools\fR. (Note that these files are
-called \fIfontools_xxx.enc\fR to avoid name clashes with other packages;
-the `fontools_' prefix doesn't need to be specified.)
+You may use either one or two dashes before options,
+and option names may be shortened to a unique prefix
+(e.g., \fB\-enc\fR instead of \fB\-encoding\fR).
+.IP "\fB\-encoding\fR=\fIencoding[,encoding]\fR" 4
+.IX Item "-encoding=encoding[,encoding]"
+Use the specified encodings for the text fonts. The default is \*(L"\s-1OT1\s0,T1,LY1\*(R".
+For each encoding, a file \fI<encoding>.enc\fR (in all \fIlowercase\fR)
+should be somewhere where \fIotftotfm\fR can find it. Suitable encoding files
+for \s-1OT1\s0, T1/TS1 and \s-1LY1\s0 come with \fBautoinst\fR. (Note that these files are
+called \fIfontools_ot1.enc\fR etc. to avoid name clashes with other packages;
+the \*(L"fontools_\*(R" prefix doesn't need to be specified.)
.Sp
-Multiple text encodings can be specified as well: \f(CW\*(C` \-\-encoding=OT1,T1,LY1\*(C'\fR.
-The encodings are passed to \fIfontenc\fR in the order specified,
-so the last one will be the default text encoding.
-.IP "\fB \-\-sanserif\fR" 4
-.IX Item " --sanserif"
-Install the font as a sanserif font, accessed via \f(CW\*(C`\esffamily\*(C'\fR and \f(CW\*(C`\etextsf\*(C'\fR.
-Note that the generated style file redefines \f(CW\*(C`\efamilydefault\*(C'\fR,
-so including it will make this font the default text font.
-.IP "\fB \-\-typewriter\fR" 4
-.IX Item " --typewriter"
-Install the font as a typewriter font, accessed via \f(CW\*(C`\ettfamily\*(C'\fR and
-\&\f(CW\*(C`\etexttt\*(C'\fR.
-Note that the generated style file redefines \f(CW\*(C`\efamilydefault\*(C'\fR,
-so including it will make this font the default text font.
-.IP "\fB \-\-ts1\fR" 4
-.IX Item " --ts1"
+Multiple text encodings can be specified as a comma-separated list:
+\&\f(CW\*(C`\-encoding=OT1,T1\*(C'\fR. The encodings are passed to \fIfontenc\fR in the order
+specified, so the last one will be the default text encoding.
+.IP "\fB\-sanserif\fR" 4
+.IX Item "-sanserif"
+Install the font as a sanserif font, accessed via \f(CW\*(C`\esffamily\*(C'\fR and \f(CW\*(C`\etextsf\*(C'\fR.
+Note that the generated style file redefines \f(CW\*(C`\efamilydefault\*(C'\fR,
+so including it will still make this font the default text font.
+.IP "\fB\-typewriter\fR" 4
+.IX Item "-typewriter"
+Install the font as a typewriter font, accessed via \f(CW\*(C`\ettfamily\*(C'\fR and
+\&\f(CW\*(C`\etexttt\*(C'\fR.
+Note that the generated style file redefines \f(CW\*(C`\efamilydefault\*(C'\fR,
+so including it will still make this font the default text font.
+.IP "\fB\-ts1\fR" 4
+.IX Item "-ts1"
.PD 0
-.IP "\fB \-\-nots1\fR" 4
-.IX Item " --nots1"
+.IP "\fB\-nots1\fR" 4
+.IX Item "-nots1"
.PD
-Turn the creation of TS1\-encoded fonts on or off. The default is \fB \-\-ts1\fR
-if the text encodings (see \fI \-\-encoding\fR above) include T1,
-\&\fB \-\-nots1\fR otherwise.
-.IP "\fB \-\-smallcaps\fR" 4
-.IX Item " --smallcaps"
+Turn the creation of TS1\-encoded fonts on or off. The default is \fB\-ts1\fR
+if the text encodings (see \fI\-encoding\fR above) include T1,
+\&\fB\-nots1\fR otherwise.
+.IP "\fB\-smallcaps\fR" 4
+.IX Item "-smallcaps"
.PD 0
-.IP "\fB \-\-nosmallcaps\fR" 4
-.IX Item " --nosmallcaps"
+.IP "\fB\-nosmallcaps\fR" 4
+.IX Item "-nosmallcaps"
.PD
-Turn the creation of small caps fonts on or off. The default is
-\&\fB \-\-smallcaps\fR.
-.IP "\fB \-\-swash\fR" 4
-.IX Item " --swash"
+Turn the creation of small caps fonts on or off. The default is
+\&\fB\-smallcaps\fR.
+.IP "\fB\-swash\fR" 4
+.IX Item "-swash"
.PD 0
-.IP "\fB \-\-noswash\fR" 4
-.IX Item " --noswash"
+.IP "\fB\-noswash\fR" 4
+.IX Item "-noswash"
.PD
-Turn the creation of swash fonts on or off. The default is \fB \-\-swash\fR.
-.IP "\fB \-\-titling\fR" 4
-.IX Item " --titling"
+Turn the creation of swash fonts on or off. The default is \fB\-swash\fR.
+.IP "\fB\-titling\fR" 4
+.IX Item "-titling"
.PD 0
-.IP "\fB \-\-notitling\fR" 4
-.IX Item " --notitling"
+.IP "\fB\-notitling\fR" 4
+.IX Item "-notitling"
.PD
-Turn the creation of titling fonts on or off. The default is \fB \-\-notitling\fR.
-.IP "\fB \-\-superiors\fR" 4
-.IX Item " --superiors"
+Turn the creation of titling fonts on or off. The default is \fB\-titling\fR.
+.IP "\fB\-superiors\fR" 4
+.IX Item "-superiors"
.PD 0
-.IP "\fB \-\-nosuperiors\fR" 4
-.IX Item " --nosuperiors"
+.IP "\fB\-nosuperiors\fR" 4
+.IX Item "-nosuperiors"
.PD
-Turn the creation of fonts with superior characters on or off.
-The default is \fB \-\-superiors\fR.
-.IP "\fB \-\-inferiors\fR" 4
-.IX Item " --inferiors"
+Turn the creation of fonts with superior characters on or off.
+The default is \fB\-superiors\fR.
+.IP "\fB\-inferiors\fR" 4
+.IX Item "-inferiors"
.PD 0
-.IP "\fB \-\-noinferiors\fR" 4
-.IX Item " --noinferiors"
+.IP "\fB\-noinferiors\fR" 4
+.IX Item "-noinferiors"
.PD
-Turn the creation of fonts with inferior figures on or off.
-The default is \fB \-\-noinferiors\fR.
-.IP "\fB \-\-fractions\fR" 4
-.IX Item " --fractions"
+Turn the creation of fonts with inferior digits on or off.
+The default is \fB\-noinferiors\fR.
+.IP "\fB\-fractions\fR" 4
+.IX Item "-fractions"
.PD 0
-.IP "\fB \-\-nofractions\fR" 4
-.IX Item " --nofractions"
+.IP "\fB\-nofractions\fR" 4
+.IX Item "-nofractions"
.PD
-Turn the creation of fonts with numerators and denominators on or off.
-The default is \fB \-\-nofractions\fR.
-.IP "\fB \-\-ornaments\fR" 4
-.IX Item " --ornaments"
+Turn the creation of fonts with numerators and denominators on or off.
+The default is \fB\-nofractions\fR.
+.IP "\fB\-ornaments\fR" 4
+.IX Item "-ornaments"
.PD 0
-.IP "\fB \-\-noornaments\fR" 4
-.IX Item " --noornaments"
+.IP "\fB\-noornaments\fR" 4
+.IX Item "-noornaments"
.PD
-Turn the creation of ornament fonts on or off. The default is \fB \-\-ornaments\fR.
-.IP "\fB \-\-manual\fR" 4
-.IX Item " --manual"
-Manual mode. By default, \fBautoinst\fR immediately executes all \fIotftotfm\fR
-command lines it generates; with the \fB \-\-manual\fR option, these commands are
-instead written to a batch command file (named `<\fIfont\fR>.bat', to make things
-easier for our friends on Windows). Also, the generated \fIotftotfm\fR command
-lines specify the \fI \-\-pl\fR option and leave out the \fI \-\-automatic\fR option;
-this causes human readable (and editable) \fIpl\fR and \fIvpl\fR files to be created
-instead of the default \fItfm\fR and \fIvf\fR files.
-.IP "\fB \-\-verbose\fR" 4
-.IX Item " --verbose"
+Turn the creation of ornament fonts on or off. The default is \fB\-ornaments\fR.
+.IP "\fB\-target\fR=\fI\s-1DIRECTORY\s0\fR" 4
+.IX Item "-target=DIRECTORY"
+Install all generated files into the \s-1TEXMF\s0 tree at \fI\s-1DIRECTORY\s0\fR.
+.Sp
+By default, \fBautoinst\fR searches your \f(CW$TEXMFLOCAL\fR and \f(CW$TEXMFHOME\fR paths
+and installs all files into subdirectories of the first writable \s-1TEXMF\s0 tree
+it finds (or into subdirectories of the current directory,
+if no writable directory is found).
+.Sp
+\&\fBNote\fR: this option gets overriden by the \fB\-manual\fR option!
+.IP "\fB\-manual\fR" 4
+.IX Item "-manual"
+Manual mode. By default, \fBautoinst\fR immediately executes all \fIotftotfm\fR
+command lines it generates; with the \fB\-manual\fR option, these commands are
+instead written to a file \fIautoinst.bat\fR.
+Also, the generated \fIotftotfm\fR command lines specify the \fI \-\-pl\fR option
+(which tells \fIotftotfm\fR to generate readable/editable \fIpl\fR and \fIvpl\fR files
+instead of the default \fItfm\fR and \fIvf\fR files)
+and leave out the \fI \-\-automatic\fR option (which tells \fIotftotfm\fR to
+leave all generated files in the current directory, rather than install
+them into your \s-1TEXMF\s0 tree).
+.Sp
+When using this option, you should run \fIpltotf\fR and \fIvptovf\fR after
+executing all commands,
+to convert the \fIpl\fR and \fIvf\fR files to \fItfm\fR and \fIvf\fR format.
+.Sp
+\&\fBNote\fR: this option overrides the \fB\-target\fR option!
+.IP "\fB\-verbose\fR" 4
+.IX Item "-verbose"
Verbose mode; print detailed info about what \fBautoinst\fR thinks it's doing.
-.IP "\fB \-\-extra\fR=\fItext\fR" 4
-.IX Item " --extra=text"
-Pass \fItext\fR as options to \fIotftotfm\fR. To prevent \fItext\fR from accidentily
+.IP "\fB\-extra\fR=\fItext\fR" 4
+.IX Item "-extra=text"
+Pass \fItext\fR as options to \fIotftotfm\fR. To prevent \fItext\fR from accidentily
being interpreted as options to \fBautoinst\fR, it should be properly quoted.
+.IP "\fB\-figurekern\fR" 4
+.IX Item "-figurekern"
+.PD 0
+.IP "\fB\-nofigurekern\fR" 4
+.IX Item "-nofigurekern"
+.PD
+Some fonts provide kerning pairs for tabular figures.
+This is probably unwanted (e.g., numbers in tables won't line up exactly).
+The option \fB\-nofigurekern\fR adds extra \fI \-\-ligkern\fR options
+to the command lines for \fIotftotfm\fR to suppress such kerns
+(but only for the \*(L"\s-1TLF\s0\*(R" and \*(L"TOsF\*(R" families).
+Since this leads to very long command lines (it adds one hundred such options)
+and the problem affects only few fonts, the default is \fB\-figurekern\fR.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Eddie Kohler's TypeTools (\fIhttp://www.lcdf.org/type\fR).
.PP
-Perl is usually pre-installed on Linux and Unix systems;
-on Windows, try ActivePerl (available from \fIhttp://www.activestate.com\fR)
+Perl is pre-installed on most Linux and Unix systems;
+on Windows, try ActiveState's ActivePerl
+(available from \fIhttp://www.activestate.com\fR)
or Strawberry Perl (\fIhttp://strawberryperl.com\fR).
.PP
-XeTeX (\fIhttp://www.tug.org/xetex\fR) is an extension of TeX
-that can natively use any font installed in the operating system
-(including both flavours of OpenType fonts)
-without additional support files.
+XeTeX (\fIhttp://www.tug.org/xetex\fR) and LuaTeX (\fIhttp://www.luatex.org\fR)
+are TeX extensions that can use any font (including both flavours of OpenType)
+without TeX-specific support files.
.PP
-John Owens' \fIotfinst\fR (available from \s-1CTAN\s0) is another wrapper
+John Owens' \fIotfinst\fR (available from \s-1CTAN\s0) is another wrapper
around \fIotftotfm\fR, and may work when \fBautoinst\fR doesn't.
.PP
-The MinionPro for LaTeX project
-(\fIhttp://developer.berlios.de/projects/minionpro/\fR, also on \s-1CTAN\s0)
-developed very complete support files for Minion Pro (including math),
+The MinionPro for LaTeX project
+(\fIhttp://developer.berlios.de/projects/minionpro/\fR, also on \s-1CTAN\s0)
+developed very complete support files for Minion Pro (including math),
but the project appears to have been abandoned;
-these files don't work with recent versions of Minion Pro.
+these files don't work with the latest versions of Minion Pro.
.SH "AUTHOR"
.IX Header "AUTHOR"
-Marc Penninga <marc@penninga.info>
-.PP
-When sending a bug report, please give as much relevant information as
-possible; this usually includes (but may not be limited to) the output from
-running \fBautoinst\fR with the \fB \-\-verbose\fR option.
-Please make sure that this output includes all error messages (if any);
-this can be done using the command
+Marc Penninga <marcpenninga@gmail.com>
.PP
-\&\f(CW\*(C`autoinst \f(CI(... all options and files ...)\f(CW >autoinst.log 2>&1\*(C'\fR
+When sending a bug report, please give as much relevant information as
+possible; this includes at least (but may not be limited to) the output
+from running \fBautoinst\fR with the \fI\-verbose\fR option.
+Please make sure that this output includes all (if any) error messages.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (C) 2005, 2006, 2007, 2009, 2010, 2011 Marc Penninga.
+Copyright (C) 2005\-2012 Marc Penninga.
.SH "LICENSE"
.IX Header "LICENSE"
This program is free software; you can redistribute it and/or modify
-it under the terms of the \s-1GNU\s0 General Public License
-as published by the Free Software Foundation,
-either version 2 of the License, or (at your option)
-any later version.
-A copy of the \s-1GNU\s0 General Public License is included with the \fIfontools\fR
-collection; see the file \fIGPLv2.txt\fR.
+it under the terms of the \s-1GNU\s0 General Public License as published
+by the Free Software Foundation, either version 2 of the License,
+or (at your option) any later version.
+A copy of the \s-1GNU\s0 General Public License is included with \fBautoinst\fR;
+see the file \fIGPLv2.txt\fR.
.SH "DISCLAIMER"
.IX Header "DISCLAIMER"
This program is distributed in the hope that it will be useful,
@@ -561,30 +603,51 @@ but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty
\&\s-1GNU\s0 General Public License for more details.
.SH "RECENT CHANGES"
.IX Header "RECENT CHANGES"
-(See the source code for the full story.)
+(See the source code for the rest of the story.)
+.IP "\fI2012\-03\-06\fR" 12
+.IX Item "2012-03-06"
+Implemented the \*(L"splitting the font family into multiple subfamilies\*(R"
+emergency strategy when font info parsing fails.
+Added recognition for a number of unusual widths, weights and shapes.
+.IP "\fI2012\-02\-29\fR" 12
+.IX Item "2012-02-29"
+Fixed a bug in the font parsing code,
+where possible widths, weights and shapes where tested in the wrong order;
+this led to \*(L"ExtraLight\*(R" fonts being recognised as \*(L"Light\*(R".
+Added recognition for \*(L"Narrow\*(R" and \*(L"Wide\*(R" widths.
+Also added the \fI\-(no)figurekern\fR command-line option.
+.IP "\fI2012\-02\-01\fR" 12
+.IX Item "2012-02-01"
+Reorganised the code, and fixed some bugs in the process.
+Added the \fI\-target\fR command-line option.
+Made \fBautoinst\fR install the \fIfd\fR and \fIsty\fR files in
+the same \s-1TEXMF\s0 tree as the other generated files.
+Generate \s-1OT1\s0, T1 and \s-1LY1\s0 encoded text fonts by default.
+Made \fI\-titling\fR a default option (instead of \fI\-notitling\fR).
+Updated the documentation.
.IP "\fI2011\-06\-15\fR" 12
.IX Item "2011-06-15"
Fixed the font info parsing code for some fonts that are
-too lazy to spell out 'Italic' in full.
+too lazy to spell out \*(L"Italic\*(R" in full.
.IP "\fI2010\-04\-29\fR" 12
.IX Item "2010-04-29"
-The \f(CW\*(C` \-\-feature=kern\*(C'\fR option is only used for fonts that
+The \fI \-\-feature=kern\fR option is only used for fonts that
contain either a \fIkern\fR feature or a \fIkern\fR table.
-Font feature selection commands in the \fI.sty\fR file are only
-generated for shapes and figure styles that are supported
+Font feature selection commands in the \fIsty\fR file are only
+generated for shapes and figure styles that are supported
by the current font, and whose generation has not been
-turned off using the command line options.
+turned off using the command-line options.
Fixed the font info parsing to work with the Condensed fonts
in the Minion Pro family.
.IP "\fI2010\-04\-23\fR" 12
.IX Item "2010-04-23"
-Always provide the \f(CW\*(C` \-\-feature=kern\*(C'\fR option to \fIotftotfm\fR,
-even if the font doesn't have a \fIkern\fR feature;
+Always provide the \fI \-\-feature=kern\fR option to \fIotftotfm\fR,
+even if the font doesn't have a \fIkern\fR feature;
this will make \fIotftotfm\fR use the \fIkern\fR table if present.
-For fonts without a \fIliga\fR feature, add \f(CW\*(C` \-\-ligkern\*(C'\fR
+For fonts without a \fIliga\fR feature, add \fI \-\-ligkern\fR
options for the common f\-ligatures to the \fIotftotfm\fR command line,
so that any ligatures present in the font will still be used.
-Bug fix: the generated \fI.sty\fR files now work for font families
+Bug fix: the generated \fIsty\fR files now work for font families
with names containing digits.
.IP "\fI2009\-04\-09\fR" 12
.IX Item "2009-04-09"
@@ -592,6 +655,6 @@ Prefixed the filenames of the included encoding files with
\&\fIfontools_\fR, to prevent name clashes with other packages.
.IP "\fI2009\-04\-06\fR" 12
.IX Item "2009-04-06"
-A small patch to the \f(CW\*(C`make_ornament_encoding\*(C'\fR subroutine;
-it now also recognises the \fIbullet.xxx\fR ornament glyphs
-in Adobe's Kepler Pro.
+A small patch to the \f(CW\*(C`get_orn\*(C'\fR subroutine:
+it now also recognises the \fIbullet.xxx\fR ornament glyphs
+in Adobe Kepler Pro.
diff --git a/Master/texmf/doc/man/man1/autoinst.man1.pdf b/Master/texmf/doc/man/man1/autoinst.man1.pdf
index 1e8719ab7e5..4d9927de987 100644
--- a/Master/texmf/doc/man/man1/autoinst.man1.pdf
+++ b/Master/texmf/doc/man/man1/autoinst.man1.pdf
Binary files differ
diff --git a/Master/texmf/doc/man/man1/cmap2enc.1 b/Master/texmf/doc/man/man1/cmap2enc.1
deleted file mode 100644
index b57fc021fd1..00000000000
--- a/Master/texmf/doc/man/man1/cmap2enc.1
+++ /dev/null
@@ -1,450 +0,0 @@
-.\" Automatically generated by Pod::Man version 1.15
-.\" Thu Feb 8 11:04:39 2007
-.\"
-.\" Standard preamble:
-.\" ======================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.de Vb \" Begin verbatim text
-.ft CW
-.nf
-.ne \\$1
-..
-.de Ve \" End verbatim text
-.ft R
-
-.fi
-..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. | will give a
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
-.\" to do unbreakable dashes and therefore won't be available. \*(C` and
-.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
-.tr \(*W-|\(bv\*(Tr
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
-.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
-. ds C` ""
-. ds C' ""
-'br\}
-.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
-'br\}
-.\"
-.\" If the F register is turned on, we'll generate index entries on stderr
-.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
-.\" index entries marked with X<> in POD. Of course, you'll have to process
-.\" the output yourself in some meaningful fashion.
-.if \nF \{\
-. de IX
-. tm Index:\\$1\t\\n%\t"\\$2"
-..
-. nr % 0
-. rr F
-.\}
-.\"
-.\" For nroff, turn off justification. Always turn off hyphenation; it
-.\" makes way too many mistakes in technical documents.
-.hy 0
-.if n .na
-.\"
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
-.\" Fear. Run. Save yourself. No user-serviceable parts.
-.bd B 3
-. \" fudge factors for nroff and troff
-.if n \{\
-. ds #H 0
-. ds #V .8m
-. ds #F .3m
-. ds #[ \f1
-. ds #] \fP
-.\}
-.if t \{\
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
-. ds #V .6m
-. ds #F 0
-. ds #[ \&
-. ds #] \&
-.\}
-. \" simple accents for nroff and troff
-.if n \{\
-. ds ' \&
-. ds ` \&
-. ds ^ \&
-. ds , \&
-. ds ~ ~
-. ds /
-.\}
-.if t \{\
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
-.\}
-. \" troff and (daisy-wheel) nroff accents
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
-.ds ae a\h'-(\w'a'u*4/10)'e
-.ds Ae A\h'-(\w'A'u*4/10)'E
-. \" corrections for vroff
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
-. \" for low resolution devices (crt and lpr)
-.if \n(.H>23 .if \n(.V>19 \
-\{\
-. ds : e
-. ds 8 ss
-. ds o a
-. ds d- d\h'-1'\(ga
-. ds D- D\h'-1'\(hy
-. ds th \o'bp'
-. ds Th \o'LP'
-. ds ae ae
-. ds Ae AE
-.\}
-.rm #[ #] #H #V #F C
-.\" ======================================================================
-.\"
-.IX Title "CMAP2ENC 1"
-.TH CMAP2ENC 1 "fontools" "2007-02-08" "fontools"
-.UC
-.SH "NAME"
-cmap2enc \- convert glyph indices in a TrueType-flavored OpenType font to
-Adobe glyph names
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-cmap2enc [options] \fIfontfile\fR \fIencoding\fR
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-Many TrueType-flavored OpenType fonts contain no glyph names.
-When creating an \fIafm\fR file with \fIttf2afm\fR, this causes all glyphs to be
-named something
-like \f(CW\*(C`index0x01E7\*(C'\fR, which makes the \fIafm\fR file almost useless for use with
-\&\fIfontinst\fR or \fIafm2tfm\fR.
-.PP
-\&\fBcmap2enc\fR uses the font's `cmap' table to map glyph indices to
-Unicode values, and Adobe's \fIglyphlist.txt\fR file to map these to glyph names.
-.PP
-\&\fBcmap2enc\fR creates a new encoding file (for downloading with the font file)
-and a \fImtx\fR file (for use with \fIfontinst\fR). The encoding file contains the
-same glyphs as the original one, but has all glyph names replaced with
-the corresponding glyph indices; the \fImtx\fR file maps these glyph indices back
-to the original glyph names (it consists of many commands of the form
-\&\f(CW\*(C`\erenameGlyph{index0x01E7}{Euro}\*(C'\fR, plus a definition of that
-\&\f(CW\*(C`\erenameGlyph\*(C'\fR command).
-.PP
-Some of the glyph substitution features of OpenType fonts are supported;
-e.g. when the `smcp' (Small Caps) feature is specified, the glyph names
-of the lowercase glyphs will be mapped to the glyph indices of the
-small capitals.
-.PP
-A list of features supported by the font can be generated using the \fB\-p\fR
-option, see below.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-\&\s-1NOTE:\s0 the \fIexamples/\fR subdirectory in the \fIfontools\fR distribution contains
-several complete examples of the use of \fBcmap2enc\fR and other tools from
-the \fIfontools\fR collection.
-.Ip "\fB-\fR" 2
-.IX Item "-"
-To display all scripts, languages and features supported by Linotype Palatino:
-.Sp
-.Vb 1
-\& cmap2enc -p pala.ttf
-.Ve
-.Ip "\fB-\fR" 2
-.IX Item "-"
-To install Linotype Palatino in T1 encoding, with oldstyle figures:
-.RS 2
-.Ip "\fB1.\fR" 3
-.IX Item "1."
-Generate an encoding file \fIt1\-tosf-pala.enc\fR and a metrics file
-\&\fIresetpala-t1\-osf.mtx\fR:
-.Sp
-.Vb 1
-\& cmap2enc -f onum pala.ttf t1.enc
-.Ve
-.Ip "\fB2.\fR" 3
-.IX Item "2."
-Create an \fIafm\fR file for the font; this is done best using \fIfont2afm\fR
-(also in the \fIfontools\fR collection):
-.Sp
-.Vb 1
-\& font2afm pala.ttf
-.Ve
-.Ip "\fB3.\fR" 3
-.IX Item "3."
-Reencode the \fIafm\fR file using the \fIt1\-tosf-pala.enc\fR encoding to create
-a `raw' font \fIrlplrj9d\fR, with either \fIafm2afm\fR (also in the \fIfontools\fR
-collection) or \fIfontinst\fR (but be warned that \fIfontinst\fR might take a long
-time, and can even crash if the \fIafm\fR is really big):
-.Sp
-.Vb 1
-\& afm2afm -e t1-tosf-pala.enc -o rlplrj9d.afm pala.afm
-.Ve
-or
-.Sp
-.Vb 1
-\& \etransformfont{rlplrj9d}{\ereencodefont{t1-tosf-pala}{\efromafm{pala}}}
-.Ve
-.Ip "\fB4.\fR" 3
-.IX Item "4."
-Create a `value-added' \fIvpl\fR file from this raw font by adding
-ligatures, faking missing glyphs etc. with \fIfontinst\fR:
-.Sp
-.Vb 2
-\& \einstallfont{lplrj9d}{rlplrj9d,resetpala-t1-tosf,newlatin}
-\& {t1}{T1}{lplj}{m}{n}{}
-.Ve
-.RE
-.RS 2
-.RE
-.SH "OPTIONS"
-.IX Header "OPTIONS"
-\&\fBcmap2enc\fR supports the following command-line options:
-.Ip "\fB\-p\fR" 4
-.IX Item "-p"
-Print some info about the font, plus a list of all scripts, languages and
-features contained in this font's \s-1GSUB\s0 table; then exit. (When using
-this option, the \fIencoding\fR need not be specified.)
-.Ip "\fB\-f\fR \fIfeature\fR[,\fIfeature\fR]*" 4
-.IX Item "-f feature[,feature]*"
-Use the specified features when matching glyph indices to glyph names.
-Multiple features can be specified as a comma-separated list,
-\&\fBwithout\fR spaces between the items.
-.Ip "\fB\-x\fR \fIextra\fR" 4
-.IX Item "-x extra"
-Use the user-specified substitutions from \fIextra\fR (see below).
-.Ip "\fB\-l\fR \fIlanguage\fR" 4
-.IX Item "-l language"
-Select the specified language. The default is `\s-1DFLT\s0' (surprise!).
-.Ip "\fB\-s\fR \fIscript\fR" 4
-.IX Item "-s script"
-Select the specified script. The default is `latn'.
-.SH "FILES"
-.IX Header "FILES"
-All input files are searched using \fBkpsewhich\fR or \fBfindtexmf\fR when these
-commands are available; otherwise only the current working directory
-is searched.
-.Ip "\fIfontfile\fR" 4
-.IX Item "fontfile"
-The font file can be any OpenType font, though \fBcmap2enc\fR is probably only
-useful for the TrueType-flavored variant (PostScript-flavored ones always
-contain glyph names in the `\s-1CFF\s0' table).
-.Ip "\fIencoding\fR" 4
-.IX Item "encoding"
-The encoding files read and written by \fBcmap2enc\fR are in standard \fIdvips\fR
-format. The name of the output encoding file is
-\&\f(CW\*(C`<encoding>\-<suffix>\-<font>.enc\*(C'\fR,
-.Sp
-where
-.RS 4
-.Ip "\fBencoding\fR" 10
-.IX Item "encoding"
-is the name of the input encoding file (without the extension `.enc');
-.Ip "\fBsuffix\fR" 10
-.IX Item "suffix"
-names the OpenType features you specified:
-.RS 10
-.Ip "\fItlf\fR" 10
-.IX Item "tlf"
-for tabular lining figures (when neither the `onum' nor the `pnum' features
-have been chosen)
-.Ip "\fIlf\fR" 10
-.IX Item "lf"
-for proportional width lining figures (when you've specified `pnum',
-but not `onum')
-.Ip "\fItosf\fR" 10
-.IX Item "tosf"
-for tabular oldstyle figures (when you've specified `onum', but not `pnum')
-.Ip "\fIosf\fR" 10
-.IX Item "osf"
-for proportional width oldstyle figures (when both `onum' and `pnum' have been
-chosen)
-.Ip "\fIsc\fR" 10
-.IX Item "sc"
-for small caps (`smcp' feature)
-.Ip "\fIswash\fR" 10
-.IX Item "swash"
-for swash (`swsh' feature)
-.Ip "\fItitling\fR" 10
-.IX Item "titling"
-for a titling font (`titl' feature)
-.Ip "\fIsup\fR" 10
-.IX Item "sup"
-for superior figures and (some) letters (`sups' feature)
-.Ip "\fIorn\fR" 10
-.IX Item "orn"
-for ornaments (`ornm' feature)
-.RE
-.RS 10
-.Sp
-When several features have been specified, the \fBsuffix\fR is a combination
-of the appropriate items; e.g., when you specify \-f onum,pnum,swsh (for a
-swash font with proportional oldstyle figures) the \fBsuffix\fR is
-\&\f(CW\*(C`osf\-swash\*(C'\fR.
-.RE
-.Ip "\fBfont\fR" 10
-.IX Item "font"
-is the name of the input font file, without the `.ttf' or `.otf' extension.
-.RE
-.RS 4
-.RE
-.Ip "\fImtx\fR" 4
-.IX Item "mtx"
-The output \fImtx\fR file is in standard \fIfontinst\fR format. The name of this file
-is \f(CW\*(C`reset<font>\-<encoding>\-<suffix>.mtx\*(C'\fR,
-.Sp
-where \fIfont\fR, \fIencoding\fR and \fIsuffix\fR have the same meaning as above.
-.Ip "\fIextra\fR" 4
-.IX Item "extra"
-The option \fB\-x\fR can be used to name a file containing extra substitutions
-that complement or override the ones specified by the selected features.
-It consists of one substitution per line; each is either of the form
-\&\f(CW\*(C`<from>;<to>\*(C'\fR, where \fIfrom\fR and \fIto\fR are both glyph indices
-(specified as four hexadecimal digits), or of the form
-\&\f(CW\*(C`<glyph name>;<glyph index>\*(C'\fR, where \fIglyph name\fR is any glyph name
-and \fIglyph index\fR the glyph index (again, four hex digits) that is to be
-mapped to the specified glyph name. The \fIexamples/\fR subdirectory in the
-\&\fIfontools\fR distribution contains some examples of user-defined
-substitution files.
-.SH "CAVEATS"
-.IX Header "CAVEATS"
-.Ip "\fB-\fR" 2
-.IX Item "-"
-Most OpenType fonts contain several tables in the `cmap' table,
-for different platforms and different encodings.
-\&\fBcmap2enc\fR only reads the first table that implements Unicode, that is,
-the first table with either platformID = 0 and encodingID = 3 or 4
-or platformID = 3 and encodingID = 1 or 10.
-At least one of those will probably always be present, and (afaik) it doesn't
-matter which of these is used.
-.Sp
-The fact that only tableFormat = 4 is supported might be more of a restriction,
-though I haven't yet found any font that used a different tableFormat.
-.Ip "\fB-\fR" 2
-.IX Item "-"
-OpenType fonts implement features using so-called `Lookup Tables'.
-\&\fBcmap2enc\fR supports only features from the `\s-1GSUB\s0' table that have
-LookupType = 1 (single substitution).
-.Sp
-Some features are implemented as a combination of lookups from both
-the `\s-1GSUB\s0' and the `\s-1GPOS\s0' tables; these features are (currently?)
-not supported. An example of this are the `sinf' (Scientific Inferiors) and
-\&'subs' (Subscripts) features of Linotype Palatino; these are implemented
-by first replacing the standard numerals with smaller ones and then
-adjusting their position.
-.Ip "\fB-\fR" 2
-.IX Item "-"
-Some of the font's features may yield surprising results. E.g., Linotype
-Palatino doesn't have small-caps forms of dotlessi, germandbls and the
-standard f-ligatures, so it will give you the lowercase forms of these glyphs
-even when the `smcp' feature is specified.
-(The \fIexamples/palatinox\fR subdirectory contains a file \fIunsetSCaps.mtx\fR
-that deletes these lowercase forms; \fIfontinst\fR's \fInewlatin.mtx\fR file
-will then create fake small-caps forms of these glyphs.)
-.Ip "\fB-\fR" 2
-.IX Item "-"
-If the user-defined substitution file substitutes glyph1 with glyph2,
-\&\fBcmap2enc\fR will also substitute glyph2 with glyph2; this may seem silly,
-but it means that any selected feature that would substitute glyph2 with glyph3
-gets overridden.
-.Ip "\fB-\fR" 2
-.IX Item "-"
-The glyph names are independent of the features selected, e.g., when using
-features like `smcp' or `onum', glyph names still come out as `a' and `zero'
-rather than `Asmall' and `zerooldstyle'. When installing the font with
-\&\fIfontinst\fR, you should therefore always use \fIt1.etx\fR rather than \fIt1c.etx\fR
-or \fIt1j.etx\fR.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-The other programs in the \fIfontools\fR bundle: \fIafm2afm\fR, \fIautoinst\fR,
-\&\fIfont2afm\fR, \fIot2kpx\fR, \fIpfm2kpx\fR, \fIshowglyphs\fR.
-.PP
-A good free (as in beer) Perl-implementation for Windows (and Linux)
-is ActivePerl, available from \fIhttp://www.activestate.com\fR.
-.SH "AUTHOR"
-.IX Header "AUTHOR"
-Marc Penninga <marc@penninga.info>
-.PP
-If you're sending a bug report, please give as much information as possible.
-Also be sure to mention the name \fIfontools\fR somewhere in the subject line,
-or risk being caught by my spam filter.
-.SH "COPYRIGHT"
-.IX Header "COPYRIGHT"
-Copyright (c) 2005, 2006 Marc Penninga.
-.SH "LICENSE"
-.IX Header "LICENSE"
-This program is free software; you can redistribute it and/or modify
-it under the terms of version 2 of the \s-1GNU\s0 General Public License
-as published by the Free Software Foundation.
-.PP
-A copy of the \s-1GNU\s0 General Public License is included with the \fIfontools\fR
-collection; see the file \fIGPLv2.txt\fR.
-.SH "DISCLAIMER"
-.IX Header "DISCLAIMER"
-This program is distributed in the hope that it will be useful,
-but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of
-\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0. See the
-\&\s-1GNU\s0 General Public License for more details.
-.SH "HISTORY"
-.IX Header "HISTORY"
-.Ip "\fI2006\-01\-17\fR" 12
-.IX Item "2006-01-17"
-Changed the names of the generated output files; extended the documentation.
-.Ip "\fI2005\-08\-01\fR" 12
-.IX Item "2005-08-01"
-Removed some warning messages that didn't convey any useful information;
-added contents of \fIglyphlist.txt\fR to the program itself and removed
-the file from the \fIfontools\fR collection;
-expanded the example in the documentation
-.Ip "\fI2005\-04\-29\fR" 12
-.IX Item "2005-04-29"
-Improved the documentation
-.Ip "\fI2005\-03\-21\fR" 12
-.IX Item "2005-03-21"
-Fixed somed bugs; added `titl' feature
-.Ip "\fI2005\-03\-15\fR" 12
-.IX Item "2005-03-15"
-Input files searched using \fBkpsewhich\fR or \fBfindtexmf\fR
-.Ip "\fI2005\-03\-08\fR" 12
-.IX Item "2005-03-08"
-Input files searched via \fBkpsewhich\fR (where available)
-.Ip "\fI2005\-02\-18\fR" 12
-.IX Item "2005-02-18"
-Rewrote some of the code, fixed a few bugs
-.Ip "\fI2005\-01\-10\fR" 12
-.IX Item "2005-01-10"
-First version
diff --git a/Master/texmf/doc/man/man1/cmap2enc.man1.pdf b/Master/texmf/doc/man/man1/cmap2enc.man1.pdf
deleted file mode 100644
index e943fb56c1e..00000000000
--- a/Master/texmf/doc/man/man1/cmap2enc.man1.pdf
+++ /dev/null
Binary files differ
diff --git a/Master/texmf/doc/man/man1/font2afm.1 b/Master/texmf/doc/man/man1/font2afm.1
deleted file mode 100644
index a692930536e..00000000000
--- a/Master/texmf/doc/man/man1/font2afm.1
+++ /dev/null
@@ -1,196 +0,0 @@
-.\" Automatically generated by Pod::Man version 1.15
-.\" Wed Aug 30 11:37:48 2006
-.\"
-.\" Standard preamble:
-.\" ======================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.de Vb \" Begin verbatim text
-.ft CW
-.nf
-.ne \\$1
-..
-.de Ve \" End verbatim text
-.ft R
-
-.fi
-..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. | will give a
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
-.\" to do unbreakable dashes and therefore won't be available. \*(C` and
-.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
-.tr \(*W-|\(bv\*(Tr
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
-.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
-. ds C` ""
-. ds C' ""
-'br\}
-.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
-'br\}
-.\"
-.\" If the F register is turned on, we'll generate index entries on stderr
-.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
-.\" index entries marked with X<> in POD. Of course, you'll have to process
-.\" the output yourself in some meaningful fashion.
-.if \nF \{\
-. de IX
-. tm Index:\\$1\t\\n%\t"\\$2"
-..
-. nr % 0
-. rr F
-.\}
-.\"
-.\" For nroff, turn off justification. Always turn off hyphenation; it
-.\" makes way too many mistakes in technical documents.
-.hy 0
-.if n .na
-.\"
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
-.\" Fear. Run. Save yourself. No user-serviceable parts.
-.bd B 3
-. \" fudge factors for nroff and troff
-.if n \{\
-. ds #H 0
-. ds #V .8m
-. ds #F .3m
-. ds #[ \f1
-. ds #] \fP
-.\}
-.if t \{\
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
-. ds #V .6m
-. ds #F 0
-. ds #[ \&
-. ds #] \&
-.\}
-. \" simple accents for nroff and troff
-.if n \{\
-. ds ' \&
-. ds ` \&
-. ds ^ \&
-. ds , \&
-. ds ~ ~
-. ds /
-.\}
-.if t \{\
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
-.\}
-. \" troff and (daisy-wheel) nroff accents
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
-.ds ae a\h'-(\w'a'u*4/10)'e
-.ds Ae A\h'-(\w'A'u*4/10)'E
-. \" corrections for vroff
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
-. \" for low resolution devices (crt and lpr)
-.if \n(.H>23 .if \n(.V>19 \
-\{\
-. ds : e
-. ds 8 ss
-. ds o a
-. ds d- d\h'-1'\(ga
-. ds D- D\h'-1'\(hy
-. ds th \o'bp'
-. ds Th \o'LP'
-. ds ae ae
-. ds Ae AE
-.\}
-.rm #[ #] #H #V #F C
-.\" ======================================================================
-.\"
-.IX Title "FONT2AFM 1"
-.TH FONT2AFM 1 "fontools" "2006-08-30" "fontools"
-.UC
-.SH "NAME"
-font2afm \- create font metrics (in \fIafm\fR format) for (almost) any font file
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-font2afm [options] \fIfont\fR ...
-.PP
-font2afm [options] @\fIfilelist\fR
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-\&\fBfont2afm\fR generates font metrics (in Adobe's \fIafm\fR format) for Type1,
-TrueType and OpenType fonts.
-.PP
-\&\fBfont2afm\fR is just a wrapper script around several utilities (\fBcfftot1\fR,
-\&\fBpf2afm\fR, \fBttf2afm\fR, \fBpfm2kpx\fR and \fBot2kpx\fR) that do the real work.
-All these utilities need to be available on your system.
-.SH "OPTIONS"
-.IX Header "OPTIONS"
-.Ip "\fB\-f\fR" 4
-.IX Item "-f"
-Force overwriting of existing \fIafm\fR files.
-.SH "FILES"
-.IX Header "FILES"
-.Ip "\fIfont\fR" 4
-.IX Item "font"
-This can be any Type1 (in either \fIpfa\fR or \fIpfb\fR format), TrueType or
-OpenType (both PostScript- and TrueType-flavored) font.
-.Ip "\fIfilelist\fR" 4
-.IX Item "filelist"
-This should contain a newline-separated list of font filenames.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fIpf2afm\fR (part of \fIGhostScript\fR), \fIttf2afm\fR (part of \fIpdfTeX\fR),
-\&\fIafm2afm\fR, \fIautoinst\fR, \fIcmap2enc\fR, \fIot2kpx\fR, \fIpfm2kpx\fR, \fIcfftot1\fR
-(part of Eddie Kohler's \fI\s-1LCDF\s0 TypeTools\fR).
-.SH "AUTHOR"
-.IX Header "AUTHOR"
-Marc Penninga <marc@penninga.info>
-.SH "HISTORY"
-.IX Header "HISTORY"
-.Ip "\fI2005\-04\-15\fR" 12
-.IX Item "2005-04-15"
-First version
-.Ip "\fI2005\-04\-29\fR" 12
-.IX Item "2005-04-29"
-Improved the documentation
-.Ip "\fI2005\-05\-23\fR" 12
-.IX Item "2005-05-23"
-Bugfix.
-.Ip "\fI2005\-07\-29\fR" 12
-.IX Item "2005-07-29"
-Added support for PostScript-flavored (\fIotf\fR) OpenType fonts.
-.Ip "\fI2005\-08\-08\fR" 12
-.IX Item "2005-08-08"
-Bugfix.
diff --git a/Master/texmf/doc/man/man1/font2afm.man1.pdf b/Master/texmf/doc/man/man1/font2afm.man1.pdf
deleted file mode 100644
index d86a61bfbcf..00000000000
--- a/Master/texmf/doc/man/man1/font2afm.man1.pdf
+++ /dev/null
Binary files differ
diff --git a/Master/texmf/doc/man/man1/ot2kpx.1 b/Master/texmf/doc/man/man1/ot2kpx.1
index 1c180d772ea..c761d2e9ef4 100644
--- a/Master/texmf/doc/man/man1/ot2kpx.1
+++ b/Master/texmf/doc/man/man1/ot2kpx.1
@@ -1,26 +1,11 @@
-.\" Automatically generated by Pod::Man version 1.15
-.\" Mon Apr 2 10:44:41 2007
+.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
-.\" ======================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
+.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
.de Vb \" Begin verbatim text
.ft CW
.nf
@@ -28,16 +13,15 @@
..
.de Ve \" End verbatim text
.ft R
-
.fi
..
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. | will give a
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
-.\" to do unbreakable dashes and therefore won't be available. \*(C` and
-.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
-.tr \(*W-|\(bv\*(Tr
+.\" double quote, and \*(R" will give a right double quote. \*(C+ will
+.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
@@ -56,26 +40,28 @@
. ds R" ''
'br\}
.\"
-.\" If the F register is turned on, we'll generate index entries on stderr
-.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
-.\" index entries marked with X<> in POD. Of course, you'll have to process
-.\" the output yourself in some meaningful fashion.
-.if \nF \{\
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\"
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD. Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.ie \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. nr % 0
. rr F
.\}
-.\"
-.\" For nroff, turn off justification. Always turn off hyphenation; it
-.\" makes way too many mistakes in technical documents.
-.hy 0
-.if n .na
+.el \{\
+. de IX
+..
+.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
-.bd B 3
. \" fudge factors for nroff and troff
.if n \{\
. ds #H 0
@@ -135,71 +121,93 @@
. ds Ae AE
.\}
.rm #[ #] #H #V #F C
-.\" ======================================================================
+.\" ========================================================================
.\"
.IX Title "OT2KPX 1"
-.TH OT2KPX 1 "fontools" "2007-04-02" "fontools"
-.UC
+.TH OT2KPX 1 "2012-03-06" "fontools" "Marc Penninga"
+.\" For nroff, turn off justification. Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
.SH "NAME"
-ot2kpx \- extract kerning information from an OpenType font
+ot2kpx \- extract kerning information from OpenType fonts
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
-ot2kpx \fIfont\fR
+.IP "\fBot2kpx\fR" 8
+.IX Item "ot2kpx"
+\&\fBfontfile\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
-In many OpenType fonts, most kerning data is stored in the `\s-1GPOS\s0' table rather
-than in the `kern' table. \fBot2kpx\fR extracts the kerning data from both tables
-and prints it (in \fIafm\fR format) to \f(CW\*(C`stdout\*(C'\fR.
+\&\fBot2kpx\fR extract the kerning data from OpenType fonts (both \fIotf\fR
+and \fIttf\fR formats) and prints it (in \fIafm\fR format) to \f(CW\*(C`stdout\*(C'\fR.
+.SH "OPTIONS AND ARGUMENTS"
+.IX Header "OPTIONS AND ARGUMENTS"
+.IP "\fBfontfile\fR" 4
+.IX Item "fontfile"
+The OpenType font (in either \fIotf\fR or \fIttf\fR format).
.SH "RESTRICTIONS"
.IX Header "RESTRICTIONS"
-.Ip "\fB-\fR" 2
+.IP "\fB\-\fR" 4
.IX Item "-"
-\&\fBot2kpx\fR prints data from all features named `kern', regardless of script
-and language. Maybe it would be better to let the user choose a script
-and language (defaulting to `latn' and `\s-1DFLT\s0') and print only the kerning
-data from features associated with these values.
-.Ip "\fB-\fR" 2
+\&\fBot2kpx\fR doesn't implement all of the OpenType specification.
+Things that are missing include: support for font files containing
+multiple fonts, LookupTables with LookupTypes other than 2,
+\&\*(L"kern\*(R" tables with format other than 0 and ValueRecords with
+other types of data than just XAdvance data.
+.Sp
+Most of these limitations don't really matter, since the missing features
+are rare (the only fonts I know of that use them are the non-western fonts
+that come with Adobe Reader). Furthermore, some of these features concern
+(according to the OpenType specification) \fI\*(L"define subtle, device-dependent
+adjustments at specific font sizes or device resolutions\*(R"\fR.
+Since there's no way to express such adjustments in \fIafm\fR format,
+ignoring them seems to be the only option anyway.
+.IP "\fB\-\fR" 4
.IX Item "-"
-\&\fBot2kpx\fR uses only the XAdvance data associated with the first glyph in any
-kerning pair; all other data in the ValueRecords is ignored. I'm not sure
-whether this is The Right Thing to Do; however, almost always there is
-no other data, so this approach gives correct results (in fact, the only
-font I know of that does contain data other than XAdvance is Linotype
-Palatino; this also contains XAdvDevice data, which is used (according to
-the OpenType specification) to \fI`define subtle, device-dependent adjustments
-at specific font sizes or device resolutions'\fR. Since there is no way to
-express such adjustments in \fIafm\fR format, ignoring them seems to be the
-only option.)
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fIafm2afm\fR, \fIautoinst\fR, \fIcmap2enc\fR, \fIfont2afm\fR, \fIpfm2kpx\fR.
+\&\fBot2kpx\fR collects kerning data first from the \*(L"kern\*(R" table, then from
+all LookupTables associated with the \*(L"kern\*(R" feature; if a kerning pair
+occurs multiple times, the first value seen is chosen.
+There are (or may be) several issues with this approach:
+.RS 4
+.IP "\-" 4
+The OpenType specification says that fonts in \fIotf\fR format shouldn't
+use the \*(L"kern\*(R" table at all, just the lookups from the \*(L"\s-1GPOS\s0\*(R" table.
+Many such fonts do, however, contain a \*(L"kern\*(R" table, but no \*(L"\s-1GPOS\s0\*(R" table;
+so we use the \*(L"kern\*(R" table anyway.
+.IP "\-" 4
+Instead of reading all LookupTables, it might be better to let the user
+specify a script and language and process only the LookupTables for
+those values.
+However, at least in the fonts I checked, all script/language combinations
+eventually point to the \fIsame\fR \*(L"kern\*(R" LookupTables, so this approach
+wouldn't make any difference (apart from further complicating the code).
+.RE
+.RS 4
+.RE
.SH "AUTHOR"
.IX Header "AUTHOR"
-Marc Penninga <marc@penninga.info>
-.SH "HISTORY"
-.IX Header "HISTORY"
-.Ip "\fI2005\-01\-10\fR" 12
-.IX Item "2005-01-10"
-First version
-.Ip "\fI2005\-02\-18\fR" 12
-.IX Item "2005-02-18"
-Rewrote some of the code
-.Ip "\fI2005\-03\-08\fR" 12
-.IX Item "2005-03-08"
-Input files searched via \fBkpsewhich\fR (where available)
-.Ip "\fI2005\-03\-15\fR" 12
-.IX Item "2005-03-15"
-Input files searched using \fBkpsewhich\fR or \fBfindtexmf\fR
-.Ip "\fI2005\-03\-21\fR" 12
-.IX Item "2005-03-21"
-Test if \s-1GPOS\s0 table is present before trying to read it
-.Ip "\fI2005\-04\-29\fR" 12
-.IX Item "2005-04-29"
-Improved the documentation
-.Ip "\fI2005\-05\-25\fR" 12
-.IX Item "2005-05-25"
-Changed warning that's given when the font contains no \s-1GPOS\s0 table, to an
-informational message.
-.Ip "\fI2005\-07\-29\fR" 12
-.IX Item "2005-07-29"
-A few updates to the documentation
+Marc Penninga <marcpenninga@gmail.com>
+.SH "COPYRIGHT"
+.IX Header "COPYRIGHT"
+Copyright (C) 2005\-2012 Marc Penninga.
+.SH "LICENSE"
+.IX Header "LICENSE"
+This program is free software; you can redistribute it and/or modify
+it under the terms of the \s-1GNU\s0 General Public License as published
+by the Free Software Foundation, either version 2 of the License,
+or (at your option) any later version.
+A copy of the \s-1GNU\s0 General Public License is included with \fBautoinst\fR;
+see the file \fIGPLv2.txt\fR.
+.SH "DISCLAIMER"
+.IX Header "DISCLAIMER"
+This program is distributed in the hope that it will be useful,
+but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of
+\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0.
+See the \s-1GNU\s0 General Public License for more details.
+.SH "RECENT CHANGES"
+.IX Header "RECENT CHANGES"
+(See the source code for the rest of the story.)
+.IP "\fI2012\-02\-01\fR" 12
+.IX Item "2012-02-01"
+Refactored the code, and fixed a number of bugs in the process.
+Updated the documentation.
diff --git a/Master/texmf/doc/man/man1/ot2kpx.man1.pdf b/Master/texmf/doc/man/man1/ot2kpx.man1.pdf
index 5c3509f20bf..93a2d785375 100644
--- a/Master/texmf/doc/man/man1/ot2kpx.man1.pdf
+++ b/Master/texmf/doc/man/man1/ot2kpx.man1.pdf
Binary files differ
diff --git a/Master/texmf/doc/man/man1/pfm2kpx.1 b/Master/texmf/doc/man/man1/pfm2kpx.1
deleted file mode 100644
index 0f3f38b6455..00000000000
--- a/Master/texmf/doc/man/man1/pfm2kpx.1
+++ /dev/null
@@ -1,208 +0,0 @@
-.\" Automatically generated by Pod::Man version 1.15
-.\" Fri Jul 29 13:54:23 2005
-.\"
-.\" Standard preamble:
-.\" ======================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.de Vb \" Begin verbatim text
-.ft CW
-.nf
-.ne \\$1
-..
-.de Ve \" End verbatim text
-.ft R
-
-.fi
-..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. | will give a
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
-.\" to do unbreakable dashes and therefore won't be available. \*(C` and
-.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
-.tr \(*W-|\(bv\*(Tr
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
-.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
-. ds C` ""
-. ds C' ""
-'br\}
-.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
-'br\}
-.\"
-.\" If the F register is turned on, we'll generate index entries on stderr
-.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
-.\" index entries marked with X<> in POD. Of course, you'll have to process
-.\" the output yourself in some meaningful fashion.
-.if \nF \{\
-. de IX
-. tm Index:\\$1\t\\n%\t"\\$2"
-..
-. nr % 0
-. rr F
-.\}
-.\"
-.\" For nroff, turn off justification. Always turn off hyphenation; it
-.\" makes way too many mistakes in technical documents.
-.hy 0
-.if n .na
-.\"
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
-.\" Fear. Run. Save yourself. No user-serviceable parts.
-.bd B 3
-. \" fudge factors for nroff and troff
-.if n \{\
-. ds #H 0
-. ds #V .8m
-. ds #F .3m
-. ds #[ \f1
-. ds #] \fP
-.\}
-.if t \{\
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
-. ds #V .6m
-. ds #F 0
-. ds #[ \&
-. ds #] \&
-.\}
-. \" simple accents for nroff and troff
-.if n \{\
-. ds ' \&
-. ds ` \&
-. ds ^ \&
-. ds , \&
-. ds ~ ~
-. ds /
-.\}
-.if t \{\
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
-.\}
-. \" troff and (daisy-wheel) nroff accents
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
-.ds ae a\h'-(\w'a'u*4/10)'e
-.ds Ae A\h'-(\w'A'u*4/10)'E
-. \" corrections for vroff
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
-. \" for low resolution devices (crt and lpr)
-.if \n(.H>23 .if \n(.V>19 \
-\{\
-. ds : e
-. ds 8 ss
-. ds o a
-. ds d- d\h'-1'\(ga
-. ds D- D\h'-1'\(hy
-. ds th \o'bp'
-. ds Th \o'LP'
-. ds ae ae
-. ds Ae AE
-.\}
-.rm #[ #] #H #V #F C
-.\" ======================================================================
-.\"
-.IX Title "PFM2KPX 1"
-.TH PFM2KPX 1 "fontools" "2005-07-29" "fontools"
-.UC
-.SH "NAME"
-pfm2kpx \- extract correct kerning information from \fIpfm\fR
-(Printer Font Metrics) files
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-pfm2kpx [options] \fIpfm\fR
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-Many PostScript Type1 fonts contain only
-\&\fIpfb\fR and \fIpfm\fR files, but no \fIafm\fR (Adobe Font Metrics) files. These can be
-generated with \fIpf2afm\fR (which comes with \fIGhostScript\fR), but
-this might not yield all kerning pairs from the \fIpfm\fR file. The reason
-for this is that \fIpf2afm\fR interprets \f(CW\*(C`dfCharSet = 0x00\*(C'\fR to mean that
-the Adobe StandardEncoding has been used, whereas many fonts (or font
-creation tools) instead use the Windows \s-1ANSI\s0 (aka codepage 1252) encoding.
-(You know you've hit this problem when \fBpf2afm\fR complains "\f(CW\*(C`.notdef
-character ocurred among kern pairs \-\- you'd better check the resulting
-AFM file\*(C'\fR".) In this case, the resulting \fIafm\fR is incomplete and contains
-wrong kerning pairs.
-.PP
-\&\fBpfm2kpx\fR extracts the correct kerning pairs from such \fIpfm\fR files and
-repairs the \fIafm\fR (if necessary creating it first by running \fIpf2afm\fR).
-If for some reason it can't update the \fIafm\fR, it prints the kerning pairs to
-\&\f(CW\*(C`stdout\*(C'\fR instead.
-.PP
-When \fIpf2afm\fR doesn't complain about the kerning pairs, \fBpfm2kpx\fR
-thinks the resulting \fIafm\fR file is fine and quits; this can be
-changed by specifying the \fB\-f\fR option (see below).
-.SH "OPTIONS"
-.IX Header "OPTIONS"
-.Ip "\fB\-f\fR" 4
-.IX Item "-f"
-Force updating of the \fIafm\fR file, even if \fIpf2afm\fR doesn't complain.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fIpf2afm\fR (part of GhostScript), \fIafm2afm\fR, \fIautoinst\fR, \fIcmap2enc\fR,
-\&\fIfont2afm\fR, \fIot2kpx\fR.
-.SH "AUTHOR"
-.IX Header "AUTHOR"
-Marc Penninga <marc@penninga.info>
-.SH "HISTORY"
-.IX Header "HISTORY"
-.Ip "\fI2005\-02\-17\fR" 12
-.IX Item "2005-02-17"
-First version
-.Ip "\fI2005\-02\-18\fR" 12
-.IX Item "2005-02-18"
-Added \f(CW\*(C`binmode PFM\*(C'\fR to make \fBpfm2kpx\fR work on Windows platforms
-.Ip "\fI2005\-03\-08\fR" 12
-.IX Item "2005-03-08"
-Input files searched via \fBkpsewhich\fR (where available)
-.Ip "\fI2005\-03\-14\fR" 12
-.IX Item "2005-03-14"
-Rewrote some of the code to make it more robust, added the \fB\-f\fR option
-.Ip "\fI2005\-03\-15\fR" 12
-.IX Item "2005-03-15"
-Input files searched using \fBkpsewhich\fR or \fBfindtexmf\fR
-.Ip "\fI2005\-04\-29\fR" 12
-.IX Item "2005-04-29"
-Improved the documentation
-.Ip "\fI2005\-05\-24\fR" 12
-.IX Item "2005-05-24"
-Bugfix.
-.Ip "\fI2005\-07\-29\fR" 12
-.IX Item "2005-07-29"
-Some updates to the documentation.
diff --git a/Master/texmf/doc/man/man1/pfm2kpx.man1.pdf b/Master/texmf/doc/man/man1/pfm2kpx.man1.pdf
deleted file mode 100644
index dc4c78121a9..00000000000
--- a/Master/texmf/doc/man/man1/pfm2kpx.man1.pdf
+++ /dev/null
Binary files differ
diff --git a/Master/texmf/doc/man/man1/showglyphs.1 b/Master/texmf/doc/man/man1/showglyphs.1
deleted file mode 100644
index 06165b1be0f..00000000000
--- a/Master/texmf/doc/man/man1/showglyphs.1
+++ /dev/null
@@ -1,185 +0,0 @@
-.\" Automatically generated by Pod::Man version 1.15
-.\" Fri Jul 29 13:54:24 2005
-.\"
-.\" Standard preamble:
-.\" ======================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.de Vb \" Begin verbatim text
-.ft CW
-.nf
-.ne \\$1
-..
-.de Ve \" End verbatim text
-.ft R
-
-.fi
-..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. | will give a
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
-.\" to do unbreakable dashes and therefore won't be available. \*(C` and
-.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
-.tr \(*W-|\(bv\*(Tr
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
-.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
-. ds C` ""
-. ds C' ""
-'br\}
-.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
-'br\}
-.\"
-.\" If the F register is turned on, we'll generate index entries on stderr
-.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
-.\" index entries marked with X<> in POD. Of course, you'll have to process
-.\" the output yourself in some meaningful fashion.
-.if \nF \{\
-. de IX
-. tm Index:\\$1\t\\n%\t"\\$2"
-..
-. nr % 0
-. rr F
-.\}
-.\"
-.\" For nroff, turn off justification. Always turn off hyphenation; it
-.\" makes way too many mistakes in technical documents.
-.hy 0
-.if n .na
-.\"
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
-.\" Fear. Run. Save yourself. No user-serviceable parts.
-.bd B 3
-. \" fudge factors for nroff and troff
-.if n \{\
-. ds #H 0
-. ds #V .8m
-. ds #F .3m
-. ds #[ \f1
-. ds #] \fP
-.\}
-.if t \{\
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
-. ds #V .6m
-. ds #F 0
-. ds #[ \&
-. ds #] \&
-.\}
-. \" simple accents for nroff and troff
-.if n \{\
-. ds ' \&
-. ds ` \&
-. ds ^ \&
-. ds , \&
-. ds ~ ~
-. ds /
-.\}
-.if t \{\
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
-.\}
-. \" troff and (daisy-wheel) nroff accents
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
-.ds ae a\h'-(\w'a'u*4/10)'e
-.ds Ae A\h'-(\w'A'u*4/10)'E
-. \" corrections for vroff
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
-. \" for low resolution devices (crt and lpr)
-.if \n(.H>23 .if \n(.V>19 \
-\{\
-. ds : e
-. ds 8 ss
-. ds o a
-. ds d- d\h'-1'\(ga
-. ds D- D\h'-1'\(hy
-. ds th \o'bp'
-. ds Th \o'LP'
-. ds ae ae
-. ds Ae AE
-.\}
-.rm #[ #] #H #V #F C
-.\" ======================================================================
-.\"
-.IX Title "SHOWGLYPHS 1"
-.TH SHOWGLYPHS 1 "fontools" "2005-07-29" "fontools"
-.UC
-.SH "NAME"
-showglyphs \- create a \fIpdf\fR file that shows all glyphs in a font
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-showglyphs \fIfontfile\fR
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-This program creates a \fIpdf\fR file that shows all glyphs in a given font.
-.SH "FILES"
-.IX Header "FILES"
-.Ip "\fIfont\fR" 4
-.IX Item "font"
-This can be any Type 1 or TrueType font; OpenType fonts are not (yet?)
-supported.
-.SH "RESTRICTIONS"
-.IX Header "RESTRICTIONS"
-.Ip "\fB-\fR" 4
-.IX Item "-"
-\&\fBshowglyphs\fR only works on Unix/Linux systems.
-.Ip "\fB-\fR" 4
-.IX Item "-"
-\&\fBshowglyphs\fR needs a working, TDS-compliant Tex installation
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fIafm2afm\fR, \fIautoinst\fR, \fIcmap2enc\fR, \fIpfm2kpx\fR, \fIenc2etx\fR,
-\&\fIetx2enc\fR, \fIot2kpx\fR.
-.SH "AUTHOR"
-.IX Header "AUTHOR"
-Marc Penninga <marc@penninga.info>
-.SH "HISTORY"
-.IX Header "HISTORY"
-.Ip "\fI2005\-04\-28\fR" 12
-.IX Item "2005-04-28"
-First version
-.Ip "\fI2005\-04\-29\fR" 12
-.IX Item "2005-04-29"
-A few bugfixes; \fBshowglyphs\fR now works with glyphnames containing underscores
-.Ip "\fI2005\-05\-24\fR" 12
-.IX Item "2005-05-24"
-Another bugfix
-.Ip "\fI2005\-07\-29\fR" 12
-.IX Item "2005-07-29"
-A few updates to the documentation
diff --git a/Master/texmf/doc/man/man1/showglyphs.man1.pdf b/Master/texmf/doc/man/man1/showglyphs.man1.pdf
deleted file mode 100644
index 554e6eaea8f..00000000000
--- a/Master/texmf/doc/man/man1/showglyphs.man1.pdf
+++ /dev/null
Binary files differ