fontools (1feb23)

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

6 files changed, 96 insertions, 82 deletions

diff --git a/Master/texmf-dist/doc/man/man1/afm2afm.1 b/Master/texmf-dist/doc/man/man1/afm2afm.1
index c72f32b3966..01aaf60348b 100644
--- a/Master/texmf-dist/doc/man/man1/afm2afm.1
+++ b/Master/texmf-dist/doc/man/man1/afm2afm.1
@@ -133,7 +133,7 @@
 .\" ========================================================================
 .\"
 .IX Title "AFM2AFM 1"
-.TH AFM2AFM 1 "2022-01-24" "fontools" "Marc Penninga"
+.TH AFM2AFM 1 "2023-02-01" "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
@@ -206,7 +206,7 @@ and option names may be shortened to a unique prefix.
 Marc Penninga <marcpenninga@gmail.com>
 .SH "COPYRIGHT"
 .IX Header "COPYRIGHT"
-Copyright (C) 2005\-2022 Marc Penninga.
+Copyright (C) 2005\-2023 Marc Penninga.
 .SH "LICENSE"
 .IX Header "LICENSE"
 This program is free software; you can redistribute it and/or modify
@@ -223,7 +223,7 @@ but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
 See the \s-1GNU\s0 General Public License for more details.
 .SH "VERSION"
 .IX Header "VERSION"
-This document describes \fBafm2afm\fR version 20220124.
+This document describes \fBafm2afm\fR version 20230201.
 .SH "RECENT CHANGES"
 .IX Header "RECENT CHANGES"
 (See the source code for the rest of the story.)
diff --git a/Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf b/Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf
index 98adb03665b..e049a3a1448 100644
--- a/Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/autoinst.1 b/Master/texmf-dist/doc/man/man1/autoinst.1
index db17053d052..34f29cd546d 100644
--- a/Master/texmf-dist/doc/man/man1/autoinst.1
+++ b/Master/texmf-dist/doc/man/man1/autoinst.1
@@ -133,7 +133,7 @@
 .\" ========================================================================
 .\"
 .IX Title "AUTOINST 1"
-.TH AUTOINST 1 "2022-01-24" "fontools" "Marc Penninga"
+.TH AUTOINST 1 "2023-02-01" "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
@@ -197,10 +197,10 @@ Families with superiors, inferiors, numerators and denominators,
 in roman, italic and slanted shapes.
 .IP "\-" 3
 Families with \*(L"Titling\*(R" characters;
-these \*(L"... replace the default glyphs
+these \fI\*(L"... replace the default glyphs
 with corresponding forms designed specifically for titling.
 These may be all-capital and/or larger on the body,
-and adjusted for viewing at larger sizes\*(R"
+and adjusted for viewing at larger sizes\*(R"\fR
 (according to the OpenType Specification).
 .IP "\-" 3
 An ornament family; also in roman, italic and slanted shapes.
@@ -274,17 +274,17 @@ yourself.
 .IX Item "lining, oldstyle, tabular, proportional"
 Choose which figure style to use.
 The defaults are \*(L"oldstyle\*(R" and \*(L"proportional\*(R" (if available).
-.ie n .IP """scale=\fI<number>\fP"", ""scale=MatchLowercase""" 4
-.el .IP "\f(CWscale=\f(CI<number>\f(CW\fR, \f(CWscale=MatchLowercase\fR" 4
-.IX Item "scale=<number>, scale=MatchLowercase"
-Scale the font by a factor of \fI<number>\fR.
-E.g., to increase the size of the font by 5%, use
-\&\f(CW\*(C`\eusepackage[scale=1.05]{\f(CI<FontFamily>\f(CW}\*(C'\fR.
+.ie n .IP """scale=\fI<factor>\fP"", ""scale=MatchLowercase""" 4
+.el .IP "\f(CWscale=\f(CI<factor>\f(CW\fR, \f(CWscale=MatchLowercase\fR" 4
+.IX Item "scale=<factor>, scale=MatchLowercase"
+Scale the font by \fI<factor>\fR;
+as an example, \f(CW\*(C`\eusepackage[scale=1.05]{\f(CI<FontFamily>\f(CW}\*(C'\fR
+will increase the font's size by 5%.
 The special value \f(CW\*(C`MatchLowercase\*(C'\fR may be used to scale the font
 so that its x\-height matches that of the current main font
 (which is usually Computer Modern Roman, unless you have loaded
 another font package before this one).
-The name \f(CW\*(C`scaled\*(C'\fR may be used as a synonym for \f(CW\*(C`scale\*(C'\fR.
+The word \*(L"scale\*(R" may also be spelled as \*(L"scaled\*(R".
 .ie n .IP """medium"", ""book"", ""text"", ""normal"", ""regular""" 4
 .el .IP "\f(CWmedium\fR, \f(CWbook\fR, \f(CWtext\fR, \f(CWnormal\fR, \f(CWregular\fR" 4
 .IX Item "medium, book, text, normal, regular"
@@ -320,15 +320,21 @@ to place swash on \fIfontaxes\fR' secondary shape axis (\fIfontaxes\fR places it
 on the primary shape axis) to make them behave properly when nested, so that
 \&\f(CW\*(C`\eswshape\eupshape\*(C'\fR will give upright swash.
 .PP
+Finally, the style file redefines Latex's \f(CW\*(C`\etextsuperscript\*(C'\fR and
+\&\f(CW\*(C`\etextsubscript\*(C'\fR commands to use the fonts' superior and inferior figures,
+and modifies Latex's footnote mechanism to use \f(CW\*(C`\etextsuperscript\*(C'\fR
+instead of reduced-size numerals from the regular text font.
+The old versions of these commands are still available as
+\&\f(CW\*(C`\etextsuperscript*\*(C'\fR and \f(CW\*(C`\etextsubscript*\*(C'\fR.
+.PP
 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
-These commands are only generated for existing shapes and number styles;
-no commands are generated for shapes and styles that are missing from
-your fonts.
-Also these commands are built on top of \fIfontaxes\fR, so if that package
-cannot be found, you're limited to using the lower-level commands from
+Once again: all these commands are only generated for existing shapes and number styles;
+no commands are generated for shapes and styles that are missing from your fonts.
+Note that all these commands are built on top of \fIfontaxes\fR; if that package
+cannot be found, you're limited to using 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.).
 .PP
 By default, \fBautoinst\fR generates text fonts with \s-1OT1, LY1\s0 and T1
@@ -349,15 +355,15 @@ to access these math fonts:
 .el .IP "\f(CWmath\fR" 4
 .IX Item "math"
 Use these fonts for the maths in your document.
-.ie n .IP """mathlining"", ""matholdstyle""" 4
-.el .IP "\f(CWmathlining\fR, \f(CWmatholdstyle\fR" 4
-.IX Item "mathlining, matholdstyle"
-Choose which figure style to use in maths.
-The default is \*(L"mathlining\*(R".
+.ie n .IP """mathlining"", ""matholdstyle"", ""mathtabular"", ""mathproportional""" 4
+.el .IP "\f(CWmathlining\fR, \f(CWmatholdstyle\fR, \f(CWmathtabular\fR, \f(CWmathproportional\fR" 4
+.IX Item "mathlining, matholdstyle, mathtabular, mathproportional"
+Choose which figure style and alignment to use in maths.
+The defaults are \*(L"mathlining\*(R" and \*(L"mathtabular\*(R".
 .ie n .IP """mathcal""" 4
 .el .IP "\f(CWmathcal\fR" 4
 .IX Item "mathcal"
-Use the swash characters from your fonts as the \f(CW\*(C`\emathcal\*(C'\fR alphabet.
+Use the swash characters from these fonts as the \f(CW\*(C`\emathcal\*(C'\fR alphabet.
 (This option will only exist if your fonts actually contain swash characters,
 plus a \f(CW\*(C`swsh\*(C'\fR feature to access them).
 .ie n .IP """nomathgreek""" 4
@@ -383,7 +389,7 @@ before loading the \fBautoinst\fR\-generated style file.
 Finally, note that \fBautoinst\fR doesn't check if your fonts actually contains
 all of the required characters;
 it just assumes that they do and sets up the style file accordingly.
-Even if your fonts contain greek, characters such as \f(CW\*(C`\evarepsilon\*(C'\fR
+Even if your fonts do contain greek, characters such as \f(CW\*(C`\evarepsilon\*(C'\fR
 may be missing.
 You may also find that some glyphs \fIare\fR present in your fonts,
 but don't work well in equations or don't match with other symbols;
@@ -478,23 +484,31 @@ are not compatible with files generated by newer versions.
 Since \fIpdfTeX\fR cannot subset otf-flavoured OpenType fonts,
 \&\fIotftotfm\fR will convert such fonts to Type1 (pfb) format.
 However, many fonts (at least those licensed under the \s-1SIL\s0 Open Font License)
-do not allow distributing such converted versions under their original name.
+do not allow redistributing such converted versions under their original name.
 .PP
-To meet these licensing requirements, \fBautoinst\fR provides
-a \fI\-t1suffix\fR command-line option that appends
-a user-defined suffix to the names
+In order to try to meet such licensing requirements, \fBautoinst\fR provides
+a \fI\-t1suffix\fR command-line option that appends a suffix to the names
 (both the filename and the internal font name)
 of all generated Type1 fonts; see \*(L"COMMAND-LINE \s-1OPTIONS\*(R"\s0 below.
+.PP
+Please note that I am not a lawyer and do not guarantee that
+this suffix is sufficient to meet the license's requirements.
+When in doubt, consult a real lawyer!
 .SS "Sorry, \s-1LIGTABLE\s0 too long for me to handle"
 .IX Subsection "Sorry, LIGTABLE too long for me to handle"
 The \s-1LIGTABLE\s0 in TeX's \fItfm\fR files, which contains a font's ligatures
 and kerning pairs, is limited to about 32,500 entries (2^15 \- 256).
 If the number of ligatures plus kerns in a font is higher than that limit,
 \&\fIpltotf\fR and \fIvptovf\fR will complain loudly and ignore the excess entries.
-This happens at least with Adobe's Source Serif 4 and Minion 3.
+This happens at least with Adobe's Source Serif 4 and Minion 3 font families.
+Even when \fIpltotf\fR and \fIvptovf\fR don't warn about the \s-1LIGTABLE\s0's size,
+you may still find that \fIpdftex\fR crashes with a
+\&\f(CW\*(C`Bad metric (TFM) file\*(C'\fR error.
 The best way to handle this situation is to use \fBautoinst\fR's \f(CW\*(C`\-extra\*(C'\fR option
 to raise \fIotftotfm\fR's value for the \f(CW\*(C`\-\-min\-kern\*(C'\fR parameter, which causes it
-to ignore small kerning pairs: \f(CW\*(C`\-extra=\*(Aq\-\-min\-kern=5.0\*(Aq\*(C'\fR.
+to ignore small kerning pairs: \f(CW\*(C`\-extra=\*(Aq\-\-min\-kern=6.0\*(Aq\*(C'\fR.
+Finding the correct value for the \f(CW\*(C`\-\-min\-kern\*(C'\fR parameter may require some
+trial and error.
 .SS "A note for MiKTeX users"
 .IX Subsection "A note for MiKTeX users"
 Automatically installing the fonts into a suitable \s-1TEXMF\s0 tree
@@ -561,8 +575,8 @@ For each encoding argument, \fBautoinst\fR will first check if it is
 the filename of an encoding file, and if found it will use that;
 otherwise the argument is assumed to be the name of one of
 the built-in encodings.
-Currently \fBautoinst\fR comes with built-in support for the \s-1OT1, T1/TS1, LY1, LGR,
-T2A/B/C\s0 and T3/TS3 encodings.
+Currently \fBautoinst\fR comes with built-in support for the \s-1OT1, T1/TS1, LY1,
+T2A/B/C, T3/TS3, T4, T5, LGR, CS, L7X\s0 and \s-1QX\s0 encodings.
 (These files are called \fIfontools_ot1.enc\fR etc. to avoid name clashes
 with other packages; the \fIfontools_\fR prefix may be omitted.)
 .IP "\fB\-ts1\fR/\fB\-nots1\fR" 4
@@ -742,6 +756,37 @@ use \f(CW\*(C`\-nfssweight=ul=\*(C'\fR.
 Pass \fIextra options\fR to the commands for \fIotftotfm\fR.
 To prevent \fIextra options\fR from accidentily being interpreted as
 options to \fBautoinst\fR, they should be properly quoted.
+.IP "\fB\-manual\fR" 4
+.IX Item "-manual"
+Manual mode; for users who want to post-process the generated files
+and commands. By default, \fBautoinst\fR immediately executes all
+\&\fIotftotfm\fR commands it generates;
+in manual mode, these are instead written to a file \fIautoinst.bat\fR.
+Furthermore it tells \fIotftotfm\fR to generate human readable (and editable)
+\&\fIpl/vpl\fR files instead of the default \fItfm/vf\fR ones,
+and to place all generated files in a subdirectory \f(CW\*(C`./autoinst_output/\*(C'\fR
+of the current directory, rather than install them into your TeX installation.
+.Sp
+When using this option, you need to execute the following manual steps after
+\&\fBautoinst\fR has finished:
+.RS 4
+.IP "\- run \fIpltotf\fR and \fIvptovf\fR on the generated \fIpl\fR and \fIvf\fR files, to convert them to \fItfm/vf\fR format;" 2
+.IX Item "- run pltotf and vptovf on the generated pl and vf files, to convert them to tfm/vf format;"
+.PD 0
+.IP "\- move all generated files to a proper \s-1TEXMF\s0 tree, and, if necessary, update the filename database;" 2
+.IX Item "- move all generated files to a proper TEXMF tree, and, if necessary, update the filename database;"
+.ie n .IP "\- tell TeX about the new \fImap\fR file (usually by running ""updmap"" or similar)." 2
+.el .IP "\- tell TeX about the new \fImap\fR file (usually by running \f(CWupdmap\fR or similar)." 2
+.IX Item "- tell TeX about the new map file (usually by running updmap or similar)."
+.RE
+.RS 4
+.PD
+.Sp
+Note that some options (\fI\-target\fR, \fI\-vendor\fR and \fI\-typeface\fR)
+are meaningless, and hence ignored, in manual mode.
+.Sp
+Also note that font name modification doesn't happen in manual mode.
+.RE
 .IP "\fB\-nofigurekern\fR" 4
 .IX Item "-nofigurekern"
 Some fonts provide kerning pairs for tabular figures.
@@ -780,7 +825,7 @@ If you see any error messages, please include these \fIverbatim\fR;
 don't paraphase.
 .SH "COPYRIGHT"
 .IX Header "COPYRIGHT"
-Copyright (C) 2005\-2022 Marc Penninga.
+Copyright (C) 2005\-2023 Marc Penninga.
 .SH "LICENSE"
 .IX Header "LICENSE"
 This program is free software; you can redistribute it and/or modify
@@ -797,10 +842,23 @@ but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
 \&\s-1GNU\s0 General Public License for more details.
 .SH "VERSION"
 .IX Header "VERSION"
-This document describes \fBautoinst\fR version 20220124.
+This document describes \fBautoinst\fR version 20230201.
 .SH "RECENT CHANGES"
 .IX Header "RECENT CHANGES"
 (See the source for the full story, all the way back to 2005.)
+.IP "\fI2023\-02\-01\fR" 12
+.IX Item "2023-02-01"
+Added support for the T4, T5, \s-1CS, L7X\s0 and \s-1QX\s0 encodings.
+.IP "\fI2023\-01\-31\fR" 12
+.IX Item "2023-01-31"
+If the fonts contain superior and/or inferior figures,
+the generated style file now redefines the \f(CW\*(C`\etextsuperscript\*(C'\fR
+and \f(CW\*(C`\etextsubscript\*(C'\fR commands, and patches Latex's footnote
+mechanism to use these figures
+(inspired by the \fIrealscripts\fR package).
+Fixed a few bugs in metadata parsing, style file generation
+and the \f(CW\*(C`\-t1suffix\*(C'\fR option, so that the latter also works
+for dvips and dvipdfmx.
 .IP "\fI2021\-11\-15\fR" 12
 .IX Item "2021-11-15"
 Bugfix: font info parsing now works for Adobe Source Serif 4.
@@ -822,47 +880,3 @@ Font info parsing failed for Microsoft Sitka and LucasFonts Thesis.
 The \fI\-encoding\fR option now also accepts filenames of encoding files
 in directories other than the current directory.
 Directory names containing spaces do (or at least should) also work.
-.IP "\fI2020\-12\-18\fR" 12
-.IX Item "2020-12-18"
-Fixed a problem with files not being found on Windows.
-Added extra \f(CW\*(C`\-\-unicoding\*(C'\fR options to prevent getting
-lowercase f\-ligatures in smallcaps for some buggy fonts.
-Optimized font info parsing for \s-1DTL\s0 and TypeBy font families.
-Cleaned up the code for better maintainability.
-.IP "\fI2020\-07\-29\fR" 12
-.IX Item "2020-07-29"
-Some changes in the generated \fIsty\fR and \fIfd\fR files,
-to improve compatibility with the \fImicrotype\fR package.
-Made sure that \fIpfb\fR fonts are always generated whenever
-the input fonts are in \fIotf\fR format.
-Added the \fI\-t1suffix\fR command-line option,
-to modify the font and file names of those generated Type1 fonts.
-.IP "\fI2020\-06\-19\fR" 12
-.IX Item "2020-06-19"
-Added the \f(CW\*(C`nomathgreek\*(C'\fR option to generated style files.
-Reorganized the generated style files to make them more
-standards-conforming.
-.IP "\fI2020\-05\-27\fR" 12
-.IX Item "2020-05-27"
-Added basic (and still somewhat experimental) math support.
-Implemented the \f(CW\*(C`scale=MatchLowercase\*(C'\fR option value
-in the generated style files.
-\&\*(L"Wide\*(R" fonts are mapped to the \f(CW\*(C`sx\*(C'\fR \s-1NFSS\s0 code instead of \f(CW\*(C`x\*(C'\fR,
-to cater for League Mono Variable's Wide and Extended widths.
-The generated style files now use \f(CW\*(C`\etextsup\*(C'\fR and \f(CW\*(C`\etextinf\*(C'\fR
-instead of the more cryptic \f(CW\*(C`\etextsu\*(C'\fR and \f(CW\*(C`\etextin\*(C'\fR to access
-superior and inferior characters
-(though the old forms are retained for backwards compatibility).
-.IP "\fI2020\-05\-11\fR" 12
-.IX Item "2020-05-11"
-When present, use encoding files in the current working directory
-in preference of the ones that come with \fBautoinst\fR.
-Changed the way ornament fonts are created; ornament glyphs are now
-always included in the position chosen by the font's designer.
-.IP "\fI2020\-04\-28\fR" 12
-.IX Item "2020-04-28"
-Fix a bug where the first font argument would be mistaken for
-an argument to \fI\-inferiors\fR.
-.IP "\fI2020\-01\-29\fR" 12
-.IX Item "2020-01-29"
-Don't create empty subdirectories in the target \s-1TEXMF\s0 tree.
diff --git a/Master/texmf-dist/doc/man/man1/autoinst.man1.pdf b/Master/texmf-dist/doc/man/man1/autoinst.man1.pdf
index 4e8d05a820e..2b9a5cb12ab 100644
--- a/Master/texmf-dist/doc/man/man1/autoinst.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/autoinst.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/ot2kpx.1 b/Master/texmf-dist/doc/man/man1/ot2kpx.1
index a6a63c31495..76747ebe16d 100644
--- a/Master/texmf-dist/doc/man/man1/ot2kpx.1
+++ b/Master/texmf-dist/doc/man/man1/ot2kpx.1
@@ -133,7 +133,7 @@
 .\" ========================================================================
 .\"
 .IX Title "OT2KPX 1"
-.TH OT2KPX 1 "2022-01-24" "fontools" "Marc Penninga"
+.TH OT2KPX 1 "2023-02-01" "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
@@ -211,7 +211,7 @@ wouldn't make any difference (apart from further complicating the code).
 Marc Penninga <marcpenninga@gmail.com>
 .SH "COPYRIGHT"
 .IX Header "COPYRIGHT"
-Copyright (C) 2005\-2022 Marc Penninga.
+Copyright (C) 2005\-2023 Marc Penninga.
 .SH "LICENSE"
 .IX Header "LICENSE"
 This program is free software; you can redistribute it and/or modify
@@ -228,7 +228,7 @@ but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
 See the \s-1GNU\s0 General Public License for more details.
 .SH "VERSION"
 .IX Header "VERSION"
-This document describes \fBot2kpx\fR version 20220124.
+This document describes \fBot2kpx\fR version 20230201.
 .SH "RECENT CHANGES"
 .IX Header "RECENT CHANGES"
 (See the source code for the rest of the story.)
diff --git a/Master/texmf-dist/doc/man/man1/ot2kpx.man1.pdf b/Master/texmf-dist/doc/man/man1/ot2kpx.man1.pdf
index d23f5b0990d..05079380b91 100644
--- a/Master/texmf-dist/doc/man/man1/ot2kpx.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/ot2kpx.man1.pdf