fontools (3jan13)

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

6 files changed, 33 insertions, 25 deletions

diff --git a/Master/texmf/doc/man/man1/afm2afm.1 b/Master/texmf/doc/man/man1/afm2afm.1
index d15c5cb8b21..3f66df9a8bb 100644
--- a/Master/texmf/doc/man/man1/afm2afm.1
+++ b/Master/texmf/doc/man/man1/afm2afm.1
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
+.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.20)
 .\"
 .\" Standard preamble:
 .\" ========================================================================
diff --git a/Master/texmf/doc/man/man1/afm2afm.man1.pdf b/Master/texmf/doc/man/man1/afm2afm.man1.pdf
index ece9326d809..a6e0777d9e0 100644
--- a/Master/texmf/doc/man/man1/afm2afm.man1.pdf
+++ b/Master/texmf/doc/man/man1/afm2afm.man1.pdf
diff --git a/Master/texmf/doc/man/man1/autoinst.1 b/Master/texmf/doc/man/man1/autoinst.1
index d2d7a3e025d..504e9866a23 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.25 (Pod::Simple 3.16)
+.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.20)
 .\"
 .\" Standard preamble:
 .\" ========================================================================
@@ -124,7 +124,7 @@
 .\" ========================================================================
 .\"
 .IX Title "AUTOINST 1"
-.TH AUTOINST 1 "2012-10-25" "fontools" "Marc Penninga"
+.TH AUTOINST 1 "2013-01-03" "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
@@ -149,7 +149,7 @@ 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 "\-" 3
-Four text families (with lining and oldstyle digits, in both tabular 
+Four text families (with lining and oldstyle digits, in both tabular
 and proportional variants), each with the following shapes:
 .RS 3
 .RS 2
@@ -168,8 +168,8 @@ such as ct, sp and st.
 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.
+This shape is generated only for the families with lining digits, 
+since old-style digits make no sense with all-caps text.
 .IP "\fIit\fR" 6
 .IX Item "it"
 Italic (or oblique) text
@@ -315,14 +315,16 @@ 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 is a deliberate feature that allows you to provide your own 
+\&\fI<FontFamily>_orn.enc\fR, 
+but only if that file doesn't yet exist in the current directory.
+This is a deliberate feature that allows you to 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 don't exist, or whose generation has been turned off.
-Please note that these commands are built on top of \fIfontaxes\fR;
+that don't exist, or whose generation has been turned off 
+using command-line options (see below).
+Please also 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.).
@@ -338,15 +340,15 @@ 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 uncommon 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
+\&\fBautoinst\fR would end up with different fonts having the \fIsame\fR values
+for these font parameters, which means that these fonts cannot be used in \s-1NFSS\s0.
+In this case, \fBautoinst\fR will split the font family into multiple subfamilies
 (based on each font file's \*(L"Subfamily\*(R" value) and try again.
-(Since many font families misunderstand the \*(L"Subfamily\*(R" concept 
-and make each font file a separate subfamily, 
+(Since many font vendors misunderstand the \*(L"Subfamily\*(R" concept
+and make each font file a separate subfamily,
 this strategy is only used as a last resort.)
 .PP
-If this proliferation of font families is unwanted,
+If such a proliferation of font families is unwanted,
 either run \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,
@@ -524,12 +526,14 @@ being interpreted as options to \fBautoinst\fR, it should be properly quoted.
 .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).
+This is very probably not what you want 
+(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).
+(but of course 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.
+and the problem only occurs in very few fonts, 
+the default is \fB\-figurekern\fR.
 .IP "\fB\-manual\fR" 4
 .IX Item "-manual"
 Manual mode. By default, \fBautoinst\fR executes all \fIotftotfm\fR
@@ -564,10 +568,10 @@ if no writable directory is found).
 .PD
 These options are equivalent to \fIotftotfm\fR's \fI \-\-vendor\fR and \fI \-\-typeface\fR
 options: they change the \*(L"vendor\*(R" and \*(L"typeface\*(R" parts of the names of the
-subdirectories in the \s-1TEXMF\s0 tree where generated files will be stored. 
+subdirectories in the \s-1TEXMF\s0 tree where generated files will be stored.
 The default values are \*(L"lcdftools\*(R" and the font's FontFamily name.
 .Sp
-Please note that these options change \fIonly\fR directory names, 
+Please note that these options change \fIonly\fR directory names,
 not the names of any generated files.
 .IP "\fB\-updmap\fR" 4
 .IX Item "-updmap"
@@ -587,8 +591,8 @@ on Windows, try ActiveState's ActivePerl
 or Strawberry Perl (\fIhttp://strawberryperl.com\fR).
 .PP
 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.
+are TeX extensions that can use many types of font 
+(including both flavours of OpenType) without TeX-specific support files.
 .PP
 The FontPro project (\fIhttps://github.com/sebschub/FontPro\fR)
 offers very complete support for Adobe's Minion Pro and Myriad Pro
@@ -606,7 +610,7 @@ 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\-2012 Marc Penninga.
+Copyright (C) 2005\-2013 Marc Penninga.
 .SH "LICENSE"
 .IX Header "LICENSE"
 This program is free software; you can redistribute it and/or modify
@@ -624,6 +628,10 @@ but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty
 .SH "RECENT CHANGES"
 .IX Header "RECENT CHANGES"
 (See the source code for the rest of the story.)
+.IP "\fI2013\-01\-03\fR" 12
+.IX Item "2013-01-03"
+Added extra \*(L"ssub\*(R" rules to the \fIfd\fR files that substitute \*(L"b\*(R" for \*(L"bx\*(R".
+Verbose mode now also prints all generated commands before they're executed.
 .IP "\fI2012\-10\-25\fR" 12
 .IX Item "2012-10-25"
 Added extra \*(L"ssub\*(R" rules to the \fIfd\fR files that substitute italic
diff --git a/Master/texmf/doc/man/man1/autoinst.man1.pdf b/Master/texmf/doc/man/man1/autoinst.man1.pdf
index 55c530aebe9..ad26c472c3b 100644
--- a/Master/texmf/doc/man/man1/autoinst.man1.pdf
+++ b/Master/texmf/doc/man/man1/autoinst.man1.pdf
diff --git a/Master/texmf/doc/man/man1/ot2kpx.1 b/Master/texmf/doc/man/man1/ot2kpx.1
index c761d2e9ef4..853982cfffb 100644
--- a/Master/texmf/doc/man/man1/ot2kpx.1
+++ b/Master/texmf/doc/man/man1/ot2kpx.1
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
+.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.20)
 .\"
 .\" Standard preamble:
 .\" ========================================================================
diff --git a/Master/texmf/doc/man/man1/ot2kpx.man1.pdf b/Master/texmf/doc/man/man1/ot2kpx.man1.pdf
index d964f99c7d0..88a5bd8f304 100644
--- a/Master/texmf/doc/man/man1/ot2kpx.man1.pdf
+++ b/Master/texmf/doc/man/man1/ot2kpx.man1.pdf