summaryrefslogtreecommitdiff
path: root/Master
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-03-26 21:16:09 +0000
committerKarl Berry <karl@freefriends.org>2018-03-26 21:16:09 +0000
commita4fa614c9b8eb6093e949ccf1bcda0fa68b18ac0 (patch)
tree399239693ed2bfa8ab816e379c3e7d1ce800f373 /Master
parentf7c2ef8d6ada39d7ff3a72366dd93e2d5849e9ea (diff)
fontools (26mar18)
git-svn-id: svn://tug.org/texlive/trunk@47134 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r--Master/texmf-dist/doc/man/man1/afm2afm.man1.pdfbin27078 -> 27078 bytes
-rw-r--r--Master/texmf-dist/doc/man/man1/autoinst.1171
-rw-r--r--Master/texmf-dist/doc/man/man1/autoinst.man1.pdfbin59763 -> 61810 bytes
-rw-r--r--Master/texmf-dist/doc/man/man1/ot2kpx.man1.pdfbin26181 -> 26181 bytes
-rw-r--r--Master/texmf-dist/doc/support/fontools/README2
-rwxr-xr-xMaster/texmf-dist/scripts/fontools/autoinst246
6 files changed, 232 insertions, 187 deletions
diff --git a/Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf b/Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf
index 9074a16ee18..f64e33d3979 100644
--- a/Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/man/man1/autoinst.1 b/Master/texmf-dist/doc/man/man1/autoinst.1
index 94b80903be8..76152e54b2d 100644
--- a/Master/texmf-dist/doc/man/man1/autoinst.1
+++ b/Master/texmf-dist/doc/man/man1/autoinst.1
@@ -129,7 +129,7 @@
.\" ========================================================================
.\"
.IX Title "AUTOINST 1"
-.TH AUTOINST 1 "2018-01-09" "fontools" "Marc Penninga"
+.TH AUTOINST 1 "2018-03-26" "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
@@ -160,7 +160,7 @@ and proportional variants), all with the following shapes:
.RS 2
.IP "\fIn\fR" 8
.IX Item "n"
-Roman text
+Roman (i.e., upright) text
.IP "\fIit\fR, \fIsl\fR" 8
.IX Item "it, sl"
Italic and slanted (sometimes called oblique) text
@@ -172,8 +172,7 @@ Small caps
Swash
.IP "\fItl\fR" 8
.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
+Titling shape. Meant for all-caps text; letterspacing and the positioning of
punctuation characters have been adjusted to suit all-caps text.
(This shape is only generated for the families with lining digits,
since old-style digits make no sense with all-caps text.)
@@ -200,15 +199,15 @@ in roman, italic and slanted shapes.
Families with superiors, inferiors, numerators and denominators,
in roman, italic and slanted shapes.
.IP "\-" 3
-An ornament family, in roman, italic and slanted shapes.
+An ornament family, also in roman, italic and slanted shapes.
.RE
.RS 2
.RE
.PP
-Of course, if the fonts don't contain italics, oldstyle digits, small caps
+Of course, if your fonts don't contain italics, oldstyle digits, small caps
etc., the corresponding shapes and families are not created.
In addition, the creation of most families and shapes can be controlled
-by options (see \*(L"COMMAND-LINE \s-1OPTIONS\*(R"\s0 below).
+by the user (see \*(L"COMMAND-LINE \s-1OPTIONS\*(R"\s0 below).
.PP
These families use the \fIFontPro\fR project's naming scheme:
\&\fI<FontFamily>\-<Suffix>\fR, where \fI<Suffix>\fR is:
@@ -243,7 +242,7 @@ numerators
.IX Item "Dnom"
denominators
.PP
-The generated fonts are named \fI<FontName>\-<suffix>\-<shape>\-<enc>\fR,
+The individual 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 (also in lowercase).
@@ -253,16 +252,16 @@ A typical name in this scheme would be \*(L"FiraSans\-Light\-osf\-sc\-ly1\*(R".
By default, \fBautoinst\fR generates text fonts with \s-1OT1, T1\s0 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 accommodate
-the additional ligatures provided by many OpenType fonts.
+the additional ligatures found in many OpenType fonts.
Other encodings can be chosen using the \fI\-encoding\fR option
(see \*(L"COMMAND-LINE \s-1OPTIONS\*(R"\s0 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,
+\&\fBautoinst\fR generates a style file for using the fonts in LaTeX documents,
named \fI<FontFamily>.sty\fR. This style file also takes care of loading the
\&\fIfontenc\fR and \fItextcomp\fR packages.
-To use the font, put the command \f(CW\*(C`\eusepackage{\f(CI<FontFamily>\f(CW}\*(C'\fR
-in the preamble of your document.
+To use the fonts, add the command \f(CW\*(C`\eusepackage{\f(CI<FontFamily>\f(CW}\*(C'\fR
+to the preamble of your document.
.PP
This style file defines a number of options:
.ie n .IP """lining"", ""oldstyle"", ""tabular"", ""proportional""" 4
@@ -279,14 +278,14 @@ E.g., to increase the size of the font by 5%, use
May also be spelled \f(CW\*(C`scaled\*(C'\fR.
.Sp
This option is only available when you have the \fIxkeyval\fR package installed.
-.ie n .IP """light"", ""medium"", ""regular""" 4
-.el .IP "\f(CWlight\fR, \f(CWmedium\fR, \f(CWregular\fR" 4
-.IX Item "light, medium, regular"
+.ie n .IP """light"", ""medium"", ""book"", ""text"", ""regular""" 4
+.el .IP "\f(CWlight\fR, \f(CWmedium\fR, \f(CWbook\fR, \f(CWtext\fR, \f(CWregular\fR" 4
+.IX Item "light, medium, book, text, regular"
Select the weight that LaTeX will use as the \*(L"regular\*(R" weight;
the default is \f(CW\*(C`regular\*(C'\fR.
-.ie n .IP """ultrablack"", ""ultrabold"", ""heavy"", ""extrablack"", ""black"", ""extrabold"", ""demibold"", ""semibold"", ""bold""" 4
-.el .IP "\f(CWultrablack\fR, \f(CWultrabold\fR, \f(CWheavy\fR, \f(CWextrablack\fR, \f(CWblack\fR, \f(CWextrabold\fR, \f(CWdemibold\fR, \f(CWsemibold\fR, \f(CWbold\fR" 4
-.IX Item "ultrablack, ultrabold, heavy, extrablack, black, extrabold, demibold, semibold, bold"
+.ie n .IP """heavy"", ""ultrablack"", ""extrablack"", ""black"", ""ultrabold"", ""extrabold"", ""demibold"", ""semibold"", ""bold""" 4
+.el .IP "\f(CWheavy\fR, \f(CWultrablack\fR, \f(CWextrablack\fR, \f(CWblack\fR, \f(CWultrabold\fR, \f(CWextrabold\fR, \f(CWdemibold\fR, \f(CWsemibold\fR, \f(CWbold\fR" 4
+.IX Item "heavy, ultrablack, extrablack, black, ultrabold, extrabold, demibold, semibold, bold"
Select the weight that LaTeX will use as the \*(L"bold\*(R" weight;
the default is \f(CW\*(C`bold\*(C'\fR.
.PP
@@ -310,7 +309,7 @@ characters:
.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
+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
@@ -325,7 +324,7 @@ 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 supplying the name of the ornament font.
.PP
-To access the ornaments, \fBautoinst\fR creates a font-specific encoding file
+To access ornament glyphs, \fBautoinst\fR creates a font-specific encoding file
\&\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
@@ -345,75 +344,65 @@ standard \s-1NFSS\s0 (\f(CW\*(C`\efontfamily\*(C'\fR, \f(CW\*(C`\efontseries\*(C
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 these font parameters, which means that these fonts cannot be used in \s-1NFSS.\s0
+for these font parameters, and so cannot be used in \s-1NFSS.\s0
In that 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 vendors misunderstand the \*(L"Subfamily\*(R" concept
and make each font file its own separate subfamily,
this strategy is only used as a last resort.)
.PP
-If such a proliferation of font families is unwanted,
-either run \fBautoinst\fR on a smaller set of fonts or
-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, at the beginning of the source code.
-Please also send a bug report (see \s-1AUTHOR\s0 below).
+If a proliferation of font families is unwanted, either run \fBautoinst\fR
+on a smaller set of fonts or 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, at the beginning
+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 on the standard \fIFontname\fR scheme
-and Philipp Lehman's \fIFont Installation Guide\fR, but some changes were made
-to avoid name clashes in font families with many different widths and weights,
+and Philipp Lehman's \fIFont Installation Guide\fR, but some changes had to be made
+to avoid name clashes in font families with many widths and weights,
such as Helvetica Neue and Fira Sans.
.PP
-.Vb 1
+.Vb 10
\& WEIGHT WIDTH
-\&
-\&
-\& Two 2 [1] Ultra Compressed up
-\& Four 4 [1] Extra Compressed ep
-\& Eight 8 [1] Compressed p
+\& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
+\& Two 2 Ultra Compressed up
+\& Four 4 Extra Compressed ep
+\& Eight 8 Compressed p
\& Hair a Compact p
-\& Thin t Ultra Condensed uc
+\& Thin i Ultra Condensed uc
\& Ultra Light ul Extra Condensed ec
\& Extra Light el Condensed c
\& Light l Narrow n
-\& Book sl [2] Semicondensed sc
-\& Regular [3] Regular [3]
-\& Medium mb Semiextended sx
-\& Demibold db Extended x
-\& Semibold sb Expanded e
-\& Bold b Wide w
-\& Extra Bold eb
-\& Ultra ub
-\& Ultra Bold ub SHAPE
-\& Black k
-\& Extra Black ek Roman, Upright n [4]
-\& Ultra Black uk Italic it
-\& Heavy h Cursive, Kursiv it
-\& Poster r Oblique sl [5]
-\& Slanted sl [5]
-\& Incline(d) sl [5]
+\& Regular \- [1] Semicondensed sc
+\& Text t [2] Regular \- [1]
+\& Book o [2] Semiextended sx
+\& Medium mb Extended x
+\& Demibold db Expanded e
+\& Semibold sb Wide w
+\& Bold b
+\& Extra Bold eb SHAPE
+\& Ultra (Bold) ub \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
+\& Black k Roman, Upright n [3]
+\& Extra Black ek Italic, Cursive,
+\& Ultra Black uk Kursiv it
+\& Heavy h Oblique, Slanted,
+\& Poster r Incline(d) sl
.Ve
-.PP
-\fINotes\fR
-.IX Subsection "Notes"
.IP "[1]" 4
.IX Item "[1]"
-These weights only occur (as far as I know) in Fira Sans.
+When \fIboth\fR weight and width are empty, the \s-1NFSS\s0 \*(L"series\*(R" attribute becomes \*(L"m\*(R".
.IP "[2]" 4
.IX Item "[2]"
-Since release 2018\-01\-09, \fBautoinst\fR adds \*(L"ssub\*(R" rules to the \fIfd\fR files
-to substitute \*(L"Book\*(R" weight for \*(L"Regular\*(R" when the latter is missing.
-Before that, \*(L"Book\*(R" was treated as a synonym for \*(L"Regular\*(R".
+Until release 2017\-06\-16, \*(L"Text\*(R" and \*(L"Book\*(R" were treated as synonyms for
+\&\*(L"Regular\*(R". As there are some fonts (\s-1IBM\s0 Plex, Fira Sans) that contain
+separate \*(L"Text\*(R" or \*(L"Book\*(R" in addition to \*(L"Regular\*(R" weights,
+I decided to give them their own codes.
+When there is no \*(L"Regular\*(R" weight, \fBautoinst\fR will generate \fIssub\fR rules
+to substitute either the \*(L"Text\*(R" or the \*(L"Book\*(R" font in its place.
.IP "[3]" 4
.IX Item "[3]"
-When \fIboth\fR weight and width are empty, the \*(L"series\*(R" attribute becomes \*(L"m\*(R".
-.IP "[4]" 4
-.IX Item "[4]"
-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 "[5]" 4
-.IX Item "[5]"
-Since release 2014\-01\-21; before that, slanted shapes were mapped to \*(L"it\*(R".
+Adobe Silentium Pro contains two roman shapes;
+\&\*(L"Roman I\*(R" is mapped to \*(L"n\*(R", \*(L"Roman \s-1II\*(R"\s0 to \*(L"it\*(R".
.SS "A note for MiKTeX users"
.IX Subsection "A note for MiKTeX users"
Automatically installing the fonts into a suitable \s-1TEXMF\s0 tree
@@ -433,7 +422,7 @@ and TeXLive (\fIhttp://tug.org/texlive\fR) don't seem to have this problem.
.SH "COMMAND-LINE OPTIONS"
.IX Header "COMMAND-LINE OPTIONS"
\&\fBautoinst\fR tries hard to do The Right Thing (\s-1TM\s0) by default,
-so in many cases you won't need these options;
+so you usually won't really need these options;
but most aspects of its operation can be fine-tuned if you want to.
.PP
You may use either one or two dashes before options,
@@ -442,8 +431,8 @@ and option names may be shortened to a unique prefix
but \fB\-e\fR is ambiguous (it may mean either \fB\-encoding\fR or \fB\-extra\fR)).
.IP "\fB\-dryrun\fR" 4
.IX Item "-dryrun"
-Don't actually do anything, only create the logfile \fIautoinst.log\fR
-showing which fonts would have been generated.
+Don't generate any output files; only parse the input fonts and create
+\&\fIautoinst.log\fR showing which fonts would have been generated.
.IP "\fB\-encoding\fR=\fIencoding[,encoding]\fR" 4
.IX Item "-encoding=encoding[,encoding]"
Generate the specified encoding(s) for the text fonts. The default is
@@ -513,11 +502,11 @@ This option allows the user to determine which of these styles \fBautoinst\fR
should use for the inferior characters. The default is not to create fonts
with inferior characters.
.Sp
-Note that many fonts contain only one (or even none) of these types
+\&\fINote that many fonts contain only one (or even none) of these types
of inferior characters. If you specify a style of inferiors that isn't
-actually present in the font, \fBautoinst\fR silently falls back to its default
+actually present in the font, \f(BIautoinst\fI silently falls back to its default
of not creating fonts with inferiors; it doesn't try to substitute one of
-the other features.
+the other features.\fR
.IP "\fB\-fractions\fR / \fB\-nofractions\fR" 4
.IX Item "-fractions / -nofractions"
Control the creation of fonts with numerators and denominators.
@@ -548,6 +537,11 @@ This option adds extra \fI \-\-ligkern\fR options
to the commands for \fIotftotfm\fR to suppress such kerns.
Note that this option leads to very long commands (it adds
one hundred \fI \-\-ligkern\fR options), which may cause problems on some systems.
+.IP "\fB\-mergewidths\fR / \fB\-nomergewidths\fR" 4
+.IX Item "-mergewidths / -nomergewidths"
+Some font families put Condensed and Extended fonts in separate families;
+this option tells \fBautoinst\fR to merge those separate families into the \*(L"main\*(R" font family.
+The default is \fB\-nomergewidths\fR.
.IP "\fB\-extra\fR=\fItext\fR" 4
.IX Item "-extra=text"
Append \fItext\fR as extra options to the command lines for \fIotftotfm\fR.
@@ -575,10 +569,10 @@ and hence ignored in manual mode:
.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,
+This option allows the user to override \fBautoinst\fR's default behaviour,
+which is to search the \f(CW$TEXMFLOCAL\fR and \f(CW$TEXMFHOME\fR paths and install 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).
.IP "\fB\-vendor\fR=\fI\s-1VENDOR\s0\fR" 4
.IX Item "-vendor=VENDOR"
@@ -602,29 +596,25 @@ The default is \fB\-updmap\fR.
Eddie Kohler's \fBTypeTools\fR (\fIhttp://www.lcdf.org/type\fR).
.PP
\&\fBPerl\fR can be obtained from \fIhttp://www.perl.org\fR;
-it is a standard part of many Linux distributions.
+it is included in most Linux distributions.
For Windows, try ActivePerl (\fIhttp://www.activestate.com\fR)
or Strawberry Perl (\fIhttp://strawberryperl.com\fR).
.PP
\&\fBXeTeX\fR (\fIhttp://www.tug.org/xetex\fR) and \fBLuaTeX\fR (\fIhttp://www.luatex.org\fR)
are Unicode-aware TeX engines that can use OpenType fonts directly,
-without the need for any (La)TeX\-specific support files.
+without any (La)TeX\-specific support files.
.PP
The \fBFontPro\fR project (\fIhttps://github.com/sebschub/FontPro\fR)
-offers very complete LaTeX support (including math) for Adobe's Minion Pro,
-Myriad Pro and Cronos Pro font families.
-.PP
-John Owens' \fBotfinst\fR (available from \s-1CTAN\s0) is another wrapper
-around \fIotftotfm\fR.
+offers very complete LaTeX support (even for typesetting maths) for Adobe's
+Minion Pro, Myriad Pro and Cronos Pro font families.
.SH "AUTHOR"
.IX Header "AUTHOR"
-Marc Penninga <marcpenninga@gmail.com>
+Marc Penninga (\fImarcpenninga@gmail.com\fR)
.PP
When sending a bug report, please give as much relevant information as
-possible; this includes at least (but may not be limited to)
-the log file \fIautoinst.log\fR.
+possible.
If you see any error messages (either from \fBautoinst\fR itself, from the \fI\s-1LCDF\s0 TypeTools\fR,
-from Perl or from the \s-1OS\s0), please include these \fIverbatim\fR as well; don't paraphrase them.
+from Perl or from the \s-1OS\s0), include these \fIverbatim\fR; don't paraphrase.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2005\-2018 Marc Penninga.
@@ -645,11 +635,16 @@ but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
.SH "RECENT CHANGES"
.IX Header "RECENT CHANGES"
(See the source for the full story, all the way back to 2005.)
+.IP "\fI2018\-03\-26\fR" 12
+.IX Item "2018-03-26"
+Added the \*(L"Text\*(R" weight and the \fI\-(no)mergewidths\fR option.
+Changed the \s-1NFSS\s0 codes for \*(L"Thin\*(R" and \*(L"Book\*(R" to \*(L"i\*(R" and \*(L"o\*(R", respectively.
+Tried to improve the documentation.
.IP "\fI2018\-01\-09\fR" 12
.IX Item "2018-01-09"
Added the \*(L"sl\*(R" weight for font families (such as Fira Sans) that contain both
\&\*(L"Book\*(R" and \*(L"Regular\*(R" weights (reported by Bob Tennent).
-Added the \*(L"Two\*(R", \*(L"Four\*(R", \*(L"Eight\*(R" and \*(L"Hair\*(R" weights.
+Added the \*(L"Two\*(R", \*(L"Four\*(R", \*(L"Eight\*(R" and \*(L"Hair\*(R" weights (for Fira Sans).
.IP "\fI2017\-06\-16\fR" 12
.IX Item "2017-06-16"
Changed the \fI\-inferiors\fR option from a binary yes-or-no choice to allow
diff --git a/Master/texmf-dist/doc/man/man1/autoinst.man1.pdf b/Master/texmf-dist/doc/man/man1/autoinst.man1.pdf
index 4a84556458a..c31b17f9246 100644
--- a/Master/texmf-dist/doc/man/man1/autoinst.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/autoinst.man1.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/man/man1/ot2kpx.man1.pdf b/Master/texmf-dist/doc/man/man1/ot2kpx.man1.pdf
index f1f2a80e92a..f29529b5028 100644
--- a/Master/texmf-dist/doc/man/man1/ot2kpx.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/ot2kpx.man1.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/fontools/README b/Master/texmf-dist/doc/support/fontools/README
index edef4b0c661..93d3cbba3c7 100644
--- a/Master/texmf-dist/doc/support/fontools/README
+++ b/Master/texmf-dist/doc/support/fontools/README
@@ -65,4 +65,4 @@ the terms of the GNU General Public Licence; see the file GPLv2.txt for
the license conditions.
- Marc Penninga, 2018/01/09
+ Marc Penninga, 2018/03/26
diff --git a/Master/texmf-dist/scripts/fontools/autoinst b/Master/texmf-dist/scripts/fontools/autoinst
index 3a5b6cdf3a1..8fd70fa592a 100755
--- a/Master/texmf-dist/scripts/fontools/autoinst
+++ b/Master/texmf-dist/scripts/fontools/autoinst
@@ -48,29 +48,39 @@ my $TODAY = sprintf "%04d/%02d/%02d", $y + 1900, $m + 1, $d;
all lowercase. Also make sure that the NFSS 'series' attribute
(the concatenation of weight and width) is unique!
- The 'book' and 'regular' weights and the 'regular' width are mapped
- to an empty string rather than 'm', because the 'm' disappears when
- weight and width are combined into the NFSS series (unless *both* are
- 'regular', but we deal with that case separately).
+ The 'regular' weight and width are mapped to an empty string
+ rather than 'm', because the 'm' disappears when weight and width
+ are combined into the NFSS series (unless *both* are 'regular',
+ but we deal with that case separately).
+
+ 'Text' and 'book' are often used instead of 'regular', hence
+ we want to create substitution rules in the .fd files that
+ substitute 'text' or 'book' for the missing 'regular' fonts.
+ Therefore we define these weights via variables, so we can access
+ their values later on when we create the .fd files.
=end Comment
=cut
+my $nfss_text = 't';
+my $nfss_book = 'o';
+
my %FD_WEIGHT = (
two => '2',
four => '4',
eight => '8',
hair => 'a',
- thin => 't',
+ thin => 'i',
ultralight => 'ul',
extralight => 'el',
light => 'l',
- book => 'sl',
regular => '',
+ text => $nfss_text,
+ book => $nfss_book,
medium => 'mb',
- demibold => 'db',
demi => 'db',
+ demibold => 'db',
semibold => 'sb',
bold => 'b',
extrabold => 'eb',
@@ -102,6 +112,7 @@ my %FD_WIDTH = (
expanded => 'e',
wide => 'w',
);
+my @FD_WIDTH = uniq(values %FD_WIDTH);
my %FD_SHAPE = (
roman => 'n',
@@ -397,6 +408,14 @@ sub main {
}
#-----------------------------------------------------------------------
+# Return a list of unique entries from the input
+#-----------------------------------------------------------------------
+sub uniq {
+ my %tmp = map { ($_ => 1) } @_;
+ return keys %tmp;
+}
+
+#-----------------------------------------------------------------------
# Determine which figure styles to create for each font;
# return a list of (font, style) tuples
#-----------------------------------------------------------------------
@@ -561,6 +580,7 @@ I'm using the following options:
extra: @{[ $ARGV{extra} || '<empty>' ]}
figurekern: @{[ $ARGV{figurekern} ? 'no action' : 'remove' ]}
+ mergewidths: @{[ $ARGV{mergewidths} ? 'yes' : 'no' ]}
font files:
@@ -760,6 +780,7 @@ Possible options:
-manual Manual mode (see documentation)
-(no)figurekern Keep or remove kerns between tabular figures
+ -(no)mergewidths Merge Condended/Extended subfamilies with main family
-help Print this text and exit
-doc Print the complete documentation and exit
@@ -797,6 +818,7 @@ END_USAGE
dryrun => '0', # 0 = no, 1 = yes
logfile => 'autoinst.log',
figurekern => '1', # 0 = no, 1 = yes
+ mergewidths => '0', # 0 = no, 1 = yes
);
#-----------------------------------------------------------------------
@@ -835,6 +857,7 @@ sub parse_options {
'dryrun' => \$ARGV{dryrun},
'manual' => \$ARGV{manual},
'figurekern!' => \$ARGV{figurekern},
+ 'mergewidths!' => \$ARGV{mergewidths},
'verbose+' => sub {},
)
or die "$USAGE";
@@ -1017,6 +1040,18 @@ sub parse_basicinfo {
$info->{family} = $data{family};
$info->{subfamily} = $data{subfamily};
+ # Some font families put Condensed or Extended fonts into separate
+ # families; we provide an option to merge these with the 'main'
+ # font family.
+ if ($ARGV{mergewidths}) {
+ if ($info->{width} eq 'regular'
+ && $info->{family} =~ m/(.+?) [ ]* (condensed|extended)$/xmsi)
+ {
+ $info->{family} = $1;
+ $info->{width} = lc $2;
+ }
+ }
+
$info->{basicshape} = $FD_SHAPE{$info->{shape}};
$info->{fdseries}
= ($FD_WEIGHT{$info->{weight}} . $FD_WIDTH{$info->{width}}) || 'm';
@@ -1386,7 +1421,7 @@ END_STY_XKEYVAL
: die "[ERROR] Internal bug, please report!";
my $default_bold;
- for my $series (qw(ultrablack ultrabold heavy extrablack black
+ for my $series (qw(heavy ultrablack extrablack black ultrabold
extrabold demibold semibold bold))
{
if ($seen{$FD_WEIGHT{$series}}) {
@@ -1399,7 +1434,7 @@ END_STY_XKEYVAL
$defaults .= ",$default_bold" if $default_bold;
my $default_regular;
- for my $series (qw(light medium book regular)) {
+ for my $series (qw(light medium book text regular)) {
if ($seen{$FD_WEIGHT{$series} || 'm'}) {
print {$STY}
"\\DeclareOptionX{$series}{\\edef\\mdseries\@$ARGV{nfss}",
@@ -1498,14 +1533,33 @@ END_FD_SSUB
}
}
- for my $shape (keys %{$data->{sl}}) {
- if (!exists $data->{m}{$shape}) {
- print {$FD} <<"END_FD_SSUB_SL";
-\\DeclareFontShape{$enc}{${fam}-${sty}}{m}{$shape}{
- <-> ssub * ${fam}-${sty}/sl/${shape}
+ # We treat "Text" and "Book" as different from "Regular" (see docs below).
+ # For fonts that have no separate "Regular" weight, we add ssub rules
+ # to substitute "Text" (preferably) or "Book" in its place.
+ for my $width (@FD_WIDTH) {
+ my $regular_series = $width || 'm';
+ my $text_series = $nfss_text . $width;
+ my $book_series = $nfss_book . $width;
+ my @shapes = main::uniq( keys %{$data->{$text_series}},
+ keys %{$data->{$book_series}} );
+ for my $shape (@shapes) {
+ next if exists $data->{$regular_series}{$shape};
+ if (exists $data->{$text_series}{$shape}) {
+ print {$FD} <<"END_FD_SSUB_TEXT";
+\\DeclareFontShape{$enc}{${fam}-${sty}}{$regular_series}{$shape}{
+ <-> ssub * ${fam}-${sty}/$text_series/${shape}
+}{}
+
+END_FD_SSUB_TEXT
+ }
+ elsif (exists $data->{$book_series}{$shape}) {
+ print {$FD} <<"END_FD_SSUB_BOOK";
+\\DeclareFontShape{$enc}{${fam}-${sty}}{$regular_series}{$shape}{
+ <-> ssub * ${fam}-${sty}/$book_series/${shape}
}{}
-END_FD_SSUB_SL
+END_FD_SSUB_BOOK
+ }
}
}
@@ -1588,7 +1642,7 @@ and proportional variants), all with the following shapes:
=item I<n>
-Roman text
+Roman (i.e., upright) text
=item I<it>, I<sl>
@@ -1604,8 +1658,7 @@ Swash
=item I<tl>
-Titling shape. Meant for all-caps text only (even though it sometimes contains
-lowercase glyphs as well), where letterspacing and the positioning of
+Titling shape. Meant for all-caps text; letterspacing and the positioning of
punctuation characters have been adjusted to suit all-caps text.
(This shape is only generated for the families with lining digits,
since old-style digits make no sense with all-caps text.)
@@ -1639,16 +1692,16 @@ in roman, italic and slanted shapes.
=item -
-An ornament family, in roman, italic and slanted shapes.
+An ornament family, also in roman, italic and slanted shapes.
=back
=back
-Of course, if the fonts don't contain italics, oldstyle digits, small caps
+Of course, if your fonts don't contain italics, oldstyle digits, small caps
etc., the corresponding shapes and families are not created.
In addition, the creation of most families and shapes can be controlled
-by options (see L</"COMMAND-LINE OPTIONS"> below).
+by the user (see L</"COMMAND-LINE OPTIONS"> below).
These families use the I<FontPro> project's naming scheme:
I<< <FontFamily>-<Suffix> >>, where I<< <Suffix> >> is:
@@ -1696,7 +1749,7 @@ denominators
=back
-The generated fonts are named I<< <FontName>-<suffix>-<shape>-<enc> >>,
+The individual fonts are named I<< <FontName>-<suffix>-<shape>-<enc> >>,
where I<< <suffix> >> is the same as above (but in lowercase),
I<< <shape> >> is either empty, "sc", "swash" or "titling",
and I<< <enc> >> is the encoding (also in lowercase).
@@ -1708,18 +1761,18 @@ A typical name in this scheme would be "FiraSans-Light-osf-sc-ly1".
By default, B<autoinst> generates text fonts with OT1, T1 and LY1
encodings, and the generated style files use LY1 as the default text encoding.
LY1 has been chosen over T1 because it has some empty slots to accommodate
-the additional ligatures provided by many OpenType fonts.
+the additional ligatures found in many OpenType fonts.
Other encodings can be chosen using the I<-encoding> option
(see L</"COMMAND-LINE OPTIONS"> below).
=head2 Using the fonts in your LaTeX documents
-B<autoinst> generates a style file for using the font in LaTeX documents,
+B<autoinst> generates a style file for using the fonts in LaTeX documents,
named F<< <FontFamily>.sty >>. This style file also takes care of loading the
F<fontenc> and F<textcomp> packages.
-To use the font, put the command C<<< \usepackage{I<< <FontFamily> >>} >>>
-in the preamble of your document.
+To use the fonts, add the command C<<< \usepackage{I<< <FontFamily> >>} >>>
+to the preamble of your document.
This style file defines a number of options:
@@ -1739,12 +1792,12 @@ May also be spelled C<scaled>.
This option is only available when you have the F<xkeyval> package installed.
-=item C<light>, C<medium>, C<regular>
+=item C<light>, C<medium>, C<book>, C<text>, C<regular>
Select the weight that LaTeX will use as the "regular" weight;
the default is C<regular>.
-=item C<ultrablack>, C<ultrabold>, C<heavy>, C<extrablack>, C<black>,
+=item C<heavy>, C<ultrablack>, C<extrablack>, C<black>, C<ultrabold>,
C<extrabold>, C<demibold>, C<semibold>, C<bold>
Select the weight that LaTeX will use as the "bold" weight;
@@ -1772,7 +1825,7 @@ characters:
In addition, the C<\swshape> and C<\textsw> commands are redefined to place
-swash on the secondary shape axis (F<fontaxes> places it on the primary
+swash on F<fontaxes>' secondary shape axis (F<fontaxes> places it on the primary
shape axis) to make them behave properly when nested, so that
C<\swshape\upshape> will give upright swash.
@@ -1787,7 +1840,7 @@ series and shape. A list of all ornaments in a font can be created by
running LaTeX on the file F<nfssfont.tex> (part of a standard
LaTeX installation) and supplying the name of the ornament font.
-To access the ornaments, B<autoinst> creates a font-specific encoding file
+To access ornament glyphs, B<autoinst> creates a font-specific encoding file
F<< <FontFamily>_orn.enc >>,
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
@@ -1809,81 +1862,70 @@ B<autoinst> parses the output of C<otfinfo --info> to determine
these parameters. When this fails
(e.g., because the font family contains uncommon widths or weights),
B<autoinst> ends up with different fonts having the I<same> values
-for these font parameters, which means that these fonts cannot be used in NFSS.
+for these font parameters, and so cannot be used in NFSS.
In that case, B<autoinst> will split the font family into multiple subfamilies
(based on each font file's "Subfamily" value) and try again.
(Since many font vendors misunderstand the "Subfamily" concept
and make each font file its own separate subfamily,
this strategy is only used as a last resort.)
-If such a proliferation of font families is unwanted,
-either run B<autoinst> on a smaller set of fonts or
-add the missing widths, weights and shapes to the tables C<%FD_WIDTH>,
-C<%FD_WEIGHT> and C<%FD_SHAPE>, at the beginning of the source code.
-Please also send a bug report (see L<AUTHOR> below).
+If a proliferation of font families is unwanted, either run B<autoinst>
+on a smaller set of fonts or add the missing widths, weights and shapes to
+the tables C<%FD_WIDTH>, C<%FD_WEIGHT> and C<%FD_SHAPE>, at the beginning
+of the source code. Please also send a bug report (see L<AUTHOR> below).
B<autoinst> maps widths, weights and shapes to NFSS codes using
the following tables. These are based on the standard I<Fontname> scheme
-and Philipp Lehman's F<Font Installation Guide>, but some changes were made
-to avoid name clashes in font families with many different widths and weights,
+and Philipp Lehman's F<Font Installation Guide>, but some changes had to be made
+to avoid name clashes in font families with many widths and weights,
such as Helvetica Neue and Fira Sans.
WEIGHT WIDTH
-
-
- Two 2 [1] Ultra Compressed up
- Four 4 [1] Extra Compressed ep
- Eight 8 [1] Compressed p
+ ------------------------ -------------------------------
+ Two 2 Ultra Compressed up
+ Four 4 Extra Compressed ep
+ Eight 8 Compressed p
Hair a Compact p
- Thin t Ultra Condensed uc
+ Thin i Ultra Condensed uc
Ultra Light ul Extra Condensed ec
Extra Light el Condensed c
Light l Narrow n
- Book sl [2] Semicondensed sc
- Regular [3] Regular [3]
- Medium mb Semiextended sx
- Demibold db Extended x
- Semibold sb Expanded e
- Bold b Wide w
- Extra Bold eb
- Ultra ub
- Ultra Bold ub SHAPE
- Black k
- Extra Black ek Roman, Upright n [4]
- Ultra Black uk Italic it
- Heavy h Cursive, Kursiv it
- Poster r Oblique sl [5]
- Slanted sl [5]
- Incline(d) sl [5]
-
-
-=head3 Notes
+ Regular - [1] Semicondensed sc
+ Text t [2] Regular - [1]
+ Book o [2] Semiextended sx
+ Medium mb Extended x
+ Demibold db Expanded e
+ Semibold sb Wide w
+ Bold b
+ Extra Bold eb SHAPE
+ Ultra (Bold) ub -------------------------------
+ Black k Roman, Upright n [3]
+ Extra Black ek Italic, Cursive,
+ Ultra Black uk Kursiv it
+ Heavy h Oblique, Slanted,
+ Poster r Incline(d) sl
+
=over 4
=item [1]
-These weights only occur (as far as I know) in Fira Sans.
+When I<both> weight and width are empty, the NFSS "series" attribute becomes "m".
=item [2]
-Since release 2018-01-09, B<autoinst> adds "ssub" rules to the F<fd> files
-to substitute "Book" weight for "Regular" when the latter is missing.
-Before that, "Book" was treated as a synonym for "Regular".
+Until release 2017-06-16, "Text" and "Book" were treated as synonyms for
+"Regular". As there are some fonts (IBM Plex, Fira Sans) that contain
+separate "Text" or "Book" in addition to "Regular" weights,
+I decided to give them their own codes.
+When there is no "Regular" weight, B<autoinst> will generate I<ssub> rules
+to substitute either the "Text" or the "Book" font in its place.
=item [3]
-When I<both> weight and width are empty, the "series" attribute becomes "m".
-
-=item [4]
-
-Adobe Silentium Pro contains two "Roman" shapes ("RomanI" and "RomanII");
-the first of these is mapped to "n", the second one to "it".
-
-=item [5]
-
-Since release 2014-01-21; before that, slanted shapes were mapped to "it".
+Adobe Silentium Pro contains two roman shapes;
+"Roman I" is mapped to "n", "Roman II" to "it".
=back
@@ -1909,7 +1951,7 @@ and TeXLive (F<http://tug.org/texlive>) don't seem to have this problem.
=head1 COMMAND-LINE OPTIONS
B<autoinst> tries hard to do The Right Thing (TM) by default,
-so in many cases you won't need these options;
+so you usually won't really need these options;
but most aspects of its operation can be fine-tuned if you want to.
You may use either one or two dashes before options,
@@ -1921,8 +1963,8 @@ but B<-e> is ambiguous (it may mean either B<-encoding> or B<-extra>)).
=item B<-dryrun>
-Don't actually do anything, only create the logfile F<autoinst.log>
-showing which fonts would have been generated.
+Don't generate any output files; only parse the input fonts and create
+F<autoinst.log> showing which fonts would have been generated.
=item B<-encoding>=I<encoding[,encoding]>
@@ -2005,11 +2047,11 @@ This option allows the user to determine which of these styles B<autoinst>
should use for the inferior characters. The default is not to create fonts
with inferior characters.
-Note that many fonts contain only one (or even none) of these types
+I<< Note that many fonts contain only one (or even none) of these types
of inferior characters. If you specify a style of inferiors that isn't
actually present in the font, B<autoinst> silently falls back to its default
of not creating fonts with inferiors; it doesn't try to substitute one of
-the other features.
+the other features. >>
=item B<-fractions> / B<-nofractions>
@@ -2043,6 +2085,12 @@ to the commands for I<otftotfm> to suppress such kerns.
Note that this option leads to very long commands (it adds
one hundred I< --ligkern> options), which may cause problems on some systems.
+=item B<-mergewidths> / B<-nomergewidths>
+
+Some font families put Condensed and Extended fonts in separate families;
+this option tells B<autoinst> to merge those separate families into the "main" font family.
+The default is B<-nomergewidths>.
+
=item B<-extra>=I<text>
Append I<text> as extra options to the command lines for I<otftotfm>.
@@ -2076,10 +2124,10 @@ and hence ignored in manual mode:
=item B<-target>=I<DIRECTORY>
Install all generated files into the TEXMF tree at I<DIRECTORY>.
-
-By default, B<autoinst> searches your $TEXMFLOCAL and $TEXMFHOME paths
-and installs all files into subdirectories of the first writable TEXMF tree
-it finds (or into subdirectories of the current directory,
+This option allows the user to override B<autoinst>'s default behaviour,
+which is to search the $TEXMFLOCAL and $TEXMFHOME paths and install all files
+into subdirectories of the first writable TEXMF tree it finds
+(or into subdirectories of the current directory,
if no writable directory is found).
=item B<-vendor>=I<VENDOR>
@@ -2107,31 +2155,27 @@ The default is B<-updmap>.
Eddie Kohler's B<TypeTools> (F<http://www.lcdf.org/type>).
B<Perl> can be obtained from F<http://www.perl.org>;
-it is a standard part of many Linux distributions.
+it is included in most Linux distributions.
For Windows, try ActivePerl (F<http://www.activestate.com>)
or Strawberry Perl (F<http://strawberryperl.com>).
B<XeTeX> (F<http://www.tug.org/xetex>) and B<LuaTeX> (F<http://www.luatex.org>)
are Unicode-aware TeX engines that can use OpenType fonts directly,
-without the need for any (La)TeX-specific support files.
+without any (La)TeX-specific support files.
The B<FontPro> project (F<https://github.com/sebschub/FontPro>)
-offers very complete LaTeX support (including math) for Adobe's Minion Pro,
-Myriad Pro and Cronos Pro font families.
-
-John Owens' B<otfinst> (available from CTAN) is another wrapper
-around F<otftotfm>.
+offers very complete LaTeX support (even for typesetting maths) for Adobe's
+Minion Pro, Myriad Pro and Cronos Pro font families.
=head1 AUTHOR
-Marc Penninga <marcpenninga@gmail.com>
+Marc Penninga (F<marcpenninga@gmail.com>)
When sending a bug report, please give as much relevant information as
-possible; this includes at least (but may not be limited to)
-the log file F<autoinst.log>.
+possible.
If you see any error messages (either from B<autoinst> itself, from the I<LCDF TypeTools>,
-from Perl or from the OS), please include these I<verbatim> as well; don't paraphrase them.
+from Perl or from the OS), include these I<verbatim>; don't paraphrase.
=head1 COPYRIGHT
@@ -2164,11 +2208,17 @@ GNU General Public License for more details.
=over 12
+=item I<2018-03-26>
+
+Added the "Text" weight and the I<-(no)mergewidths> option.
+Changed the NFSS codes for "Thin" and "Book" to "i" and "o", respectively.
+Tried to improve the documentation.
+
=item I<2018-01-09>
Added the "sl" weight for font families (such as Fira Sans) that contain both
"Book" and "Regular" weights (reported by Bob Tennent).
-Added the "Two", "Four", "Eight" and "Hair" weights.
+Added the "Two", "Four", "Eight" and "Hair" weights (for Fira Sans).
=item I<2017-06-16>