1AUTOINST(1) Marc Penninga AUTOINST(1)
2
6 autoinst - wrapper around the LCDF TypeTools, for installing and using
7 OpenType fonts in LaTeX.
8
10 autoinst [options] font(s)
11
13 Eddie Kohler's LCDF TypeTools are superb tools for installing OpenType
14 fonts in LaTeX, but they can be hard to use: they need many, often
15 long, command lines and don't generate the fd and sty files LaTeX
16 needs. autoinst simplifies the use of the TypeTools for font
17 installation by generating and executing all commands for otftotfm and
18 by creating and installing all necessary fd and sty files.
19 Given a family of font files (in otf or ttf format), autoinst will
21 create several LaTeX font families:
22 - Four text families (with lining and oldstyle digits, each in both
24 tabular and proportional variants), all with the following shapes:
25 n Roman (i.e., upright) text
27 it, sl Italic and slanted (sometimes called oblique) text
29 sc Small caps
31 scit, scsl
33 Italic and slanted small caps
34 sw Swash
36 nw "Upright swash"
38 - For each T1-encoded text family: a family of TS1-encoded symbol
40 fonts, in roman, italic and slanted shapes.
41 - Families with superiors, inferiors, numerators and denominators,
43 in roman, italic and slanted shapes.
44 - Families with "Titling" characters; these "... replace the default
46 glyphs with corresponding forms designed specifically for titling.
47 These may be all-capital and/or larger on the body, and adjusted
48 for viewing at larger sizes" (according to the OpenType
49 Specification).
50 - An ornament family, also in roman, italic and slanted shapes.
52 Of course, if your fonts don't contain italics, oldstyle digits, small
54 caps etc., the corresponding shapes and families are not created. In
55 addition, the creation of most families and shapes can be controlled by
56 the user (see "COMMAND-LINE OPTIONS" below).
57 These families use the FontPro project's naming scheme:
59 <FontFamily>-<Suffix>, where <Suffix> is:
60 LF proportional (i.e., figures have varying widths) lining figures
62 TLF tabular (i.e., all figures have the same width) lining figures
64 OsF proportional oldstyle figures
66 TOsF tabular oldstyle figures
68 Sup superior characters (note that most fonts have only an
70 incomplete set of superior characters: digits, some punctuation
71 and the letters abdeilmnorst; normal forms are used for other
72 characters)
73 Inf inferior characters; usually only digits and some punctuation,
75 normal forms for other characters
76 Titl Titling characters; see above.
78 Orn ornaments
80 Numr numerators
82 Dnom denominators
84 The individual fonts are named <FontName>-<suffix>-<shape>-<enc>, where
86 <suffix> is the same as above (but in lowercase), <shape> is either
87 empty, "sc" or "swash", and <enc> is the encoding (also in lowercase).
88 A typical name in this scheme would be "FiraSans-Light-osf-sc-ly1".
89 About the log file
91 autoinst writes some info about what it thinks it's doing to a log
92 file. By default this is called <fontfamily>.log, but this choice can
93 be overridden by the user; see the -logfile command-line option in
94 "COMMAND-LINE OPTIONS" below. If this log file already exists,
95 autoinst will append its data to the end rather than overwrite it. Use
96 the -verbose command-line option to ask for more detailed info.
97 A note for MiKTeX users
99 Automatically installing the fonts into a suitable TEXMF tree (as
100 autoinst tries to do by default) only works for TeX-installations that
101 use the kpathsea library; with TeX distributions that implement their
102 own directory searching (such as MiKTeX), autoinst will complain that
103 it cannot find the kpsewhich program and move all generated files into
104 a subdirectory "./autoinst_output/" of the current directory. If you
105 use such a TeX distribution, you should either move these files to
106 their correct destinations by hand, or use the -target option (see
107 "COMMAND-LINE OPTIONS" below) to manually specify a TEXMF tree.
108 Also, some OpenType fonts contain so many kerning pairs that the
110 resulting pl and vpl files are too big for MiKTeX's pltotf and vptovf;
111 the versions that come with W32TeX (http://www.w32tex.org) and TeXLive
112 (http://tug.org/texlive) don't seem to have this problem.
113 A note for MacTeX users
115 By default, autoinst will try to install all generated files into the
116 $TEXMFLOCAL tree; when this directory isn't user-writable, it will use
117 the $TEXMFHOME tree instead. Unfortunately, MacTeX's version of
118 "updmap-sys" (which is called behind the scenes) doesn't search in
119 $TEXMFHOME, and hence MacTeX will not find the new fonts.
120 To remedy this, either run autoinst as root (so that it can install
122 everything into $TEXMFLOCAL) or manually run "updmap -user" to tell TeX
123 about the files in $TEXMFHOME. The latter option does, however, have
124 some caveats; see https://tug.org/texlive/scripts-sys-user.html.
125 Using the fonts in your LaTeX documents
127 autoinst generates a style file for using the fonts in LaTeX documents,
128 named <FontFamily>.sty. This style file also takes care of loading the
129 fontenc and textcomp packages. To use the fonts, add the command
130 "\usepackage{<FontFamily>}" to the preamble of your document.
131 This style file defines a number of options:
133 "mainfont"
135 Redefine "\familydefault" to make this font the main font for the
136 document. This is a no-op if the font is installed as a serif
137 font; but if the font is installed as a sanserif or typewriter
138 font, this option saves you from having to redefine
139 "\familydefault" yourself.
140 "lining", "oldstyle", "tabular", "proportional"
142 Choose which figure style to use. The defaults are "oldstyle" and
143 "proportional" (if available).
144 "scale=<number>"
146 Scale the font by a factor of <number>. E.g., to increase the size
147 of the font by 5%, use "\usepackage[scale=1.05]{<FontFamily>}".
148 May also be spelled "scaled".
149 This option is only available when you have the xkeyval package
151 installed.
152 "medium", "book", "text", "regular"
154 Select the weight that LaTeX will use as the "regular" weight; the
155 default is "regular".
156 "heavy", "black", "extrabold", "demibold", "semibold", "bold"
158 Select the weight that LaTeX will use as the "bold" weight; the
159 default is "bold".
160 The previous two groups of options will only work if you have the
162 mweights package installed.
163 The style file will also try to load the fontaxes package (on CTAN),
165 which gives easy access to various font shapes and styles. Using the
166 machinery set up by fontaxes, the generated style file defines a number
167 of commands (which take the text to be typeset as argument) and
168 declarations (which don't take arguments, but affect all text up to the
169 end of the current group) to access titling, superior and inferior
170 characters:
171 DECLARATION COMMAND SHORT FORM OF COMMAND
173 \tlshape \texttitling \texttl
175 \sufigures \textsuperior \textsu
176 \infigures \textinferior \textin
177 In addition, the "\swshape" and "\textsw" commands are redefined to
179 place swash on fontaxes' secondary shape axis (fontaxes places it on
180 the primary shape axis) to make them behave properly when nested, so
181 that "\swshape\upshape" will give upright swash.
182 There are no commands for accessing the numerator and denominator
184 fonts; these can be selected using fontaxes' standard commands, e.g.,
185 "\fontfigurestyle{numerator}\selectfont".
186 These commands are only generated for existing shapes and number
188 styles; no commands are generated for shapes and styles that don't
189 exist, or whose generation was turned off by the user. Also these
190 commands are built on top of fontaxes, so if that package cannot be
191 found, you're limited to using the lower-level commands from standard
192 NFSS ("\fontfamily", "\fontseries", "\fontshape" etc.).
193 By default, autoinst generates text fonts with OT1, LY1 and T1
195 encodings, and the generated style files use T1 as the default text
196 encoding. Other encodings can be chosen using the -encoding option
197 (see "COMMAND-LINE OPTIONS" below).
198 Ornaments
200 Ornament fonts are regular LY1-encoded fonts, with a number of
202 'regular' characters replaced by ornament glyphs. The OpenType
203 specification says that fonts should only put their ornaments in place
204 of the lowercase ASCII letters or the 'bullet' character, but some
205 fonts put them in other positions (such as those of the digits) as
206 well.
207 Ornament glyphs can be accessed like "{\ornaments abc}" and
209 "{\ornaments\char"61}", or equivalently "\textornaments{abc}" and
210 "\textornaments{\char"61}". To see which ornaments a font contains
211 (and at which positions), run LaTeX on the file nfssfont.tex (which is
212 included in any standard LaTeX installation), supply the name of the
213 ornament font (i.e., "GaramondLibre-Regular-orn-u") and say
214 "\table\bye"; this will create a table of all glyphs in that font.
215 Note that versions of autoinst up to 20200428 handled ornaments
217 differently, and fonts and style files generated by those versions are
218 not compatible with files generated by newer versions.
219 NFSS codes
221 LaTeX's New Font Selection System (NFSS) identifies fonts by a
222 combination of family, series (the concatenation of weight and width),
223 shape and size. autoinst parses the font's metadata (more precisely:
224 the output of "otfinfo --info") to determine these parameters. When
225 this fails (usually because the font family contains uncommon weights,
226 widths or shapes), autoinst ends up with different fonts having the
227 same values for these font parameters; such fonts cannot be used in
228 NFSS, since there's no way distinguish them. When autoinst detects
229 such a situation, it will print an error message and abort. If that
230 happens, either rerun autoinst on a smaller set of fonts, or add the
231 missing widths, weights and shapes to the tables "WIDTH", "WEIGHT" and
232 "SHAPE" in the source code. Please also send a bug report (see AUTHOR
233 below).
234 The mapping of shapes to NFSS codes is done using the following table:
236 SHAPE CODE
238 -------------------------------- ----
239 Roman, Upright n
240 Italic it
241 Oblique, Slant(ed), Incline(d) sl
242 (Exception: Adobe Silentium Pro contains two Roman shapes; we map the
244 first of these to "n", for the second one we (ab)use the "it" code as
245 this family doesn't contain an Italic shape.)
246 The mapping of weights and widths to NFSS codes is a more complex, two-
248 step proces. In the first step, all fonts are assigned a "series" name
249 that is simply the concatenation of its weight and width (after
250 expanding any abbreviations and converting to lowercase). A font with
251 "Cond" width and "Ultra" weight will then be known as
252 "ultrablackcondensed".
253 In the second step, autoinst tries to map all combinations of NFSS
255 codes (ul, el, l, sl, m, sb, b, eb and ub for weights; uc, ec, c, sc,
256 m, sx, x, ex and ux for widths) to actual fonts. Of course, not all 81
257 combinations of these NFSS weights and widths will map to existing
258 fonts; and conversely it may not be possible to assign every existing
259 font a unique code in a sane way (especially for the weights, some font
260 families offer more choices or finer granularity than NFSS's codes can
261 handle; e.g., Fira Sans contains fifteen(!) different weights,
262 including an additional "Medium" weight between Regular and Semibold).
263 autoinst tries hard to ensure that the most common NFSS codes (and
265 high-level commands such as "\bfseries", which are built on top of
266 those codes) will "just work".
267 To see exactly which NFSS codes map to which fonts, see the log file
269 (pro tip: run autoinst with the -dryrun option to check the chosen
270 mapping beforehand). The -nfssweight and -nfsswidth command-line
271 options can be used to finetune the mapping between NFSS codes and
272 fonts.
273 To access specific weights or widths, one can always use the
275 "\fontseries" command with the full series name (i.e.,
276 "\fontseries{demibold}\selectfont").
277
279 autoinst tries hard to do The Right Thing (TM) by default, so you
280 usually won't need these options; but most aspects of its operation can
281 be fine-tuned if you want to.
282 You may use either one or two dashes before options, and option names
284 may be shortened to a unique prefix (e.g., -encoding may be abbreviated
285 to -enc or even -en, but -e is ambiguous (it may mean either -encoding
286 or -extra)).
287 -version
289 Print autoinst's version number and exit.
290 -help
292 Print a (relatively) short help text and exit.
293 -dryrun
295 Don't generate output; just parse input fonts and write a log file
296 saying what autoinst would have done.
297 -logfile=filename
299 Write log data to filename instead of the default <fontfamily>.log.
300 If the file already exists, autoinst appends to it; it doesn't
301 overwrite an existing file.
302 -verbose
304 Add more details to the log file.
305 -encoding=encoding[,encoding]
307 Generate the specified encoding(s) for the text fonts. Multiple
308 encodings may be specified as a comma-separated list (without
309 spaces!); the default choice of encodings is "OT1,LY1,T1".
310 For each specified encoding XYZ, autoinst will first see if there
312 is an encoding file XYZ.enc in the current directory, and if found
313 it will use that; otherwise it will use one of its built-in
314 encoding files. Currently autoinst comes with support for the OT1,
315 T1/TS1, LY1, LGR, T2A/B/C and T3/TS3 encodings. (These files are
316 called fontools_ot1.enc etc. to avoid name clashes with other
317 packages; the "fontools_" prefix may be omitted.)
318 -ts1/-nots1
320 Control the creation of TS1-encoded fonts. The default is -ts1 if
321 the text encodings (see -encoding above) include T1, -nots1
322 otherwise.
323 -serif/-sanserif/-typewriter
325 Install the font as a serif, sanserif or typewriter font,
326 respectively. This changes how you access the font in LaTeX: with
327 "\rmfamily"/"\textrm", "\sffamily"/"\textsf" or
328 "\ttfamily"/"\texttt".
329 Installing the font as a typewriter font will cause two further
331 changes: it will - by default - turn off the use of f-ligatures
332 (though this can be overridden with the -ligatures option), and it
333 will disable hyphenation for this font. This latter effect cannot
334 be disabled in autoinst; if you want typewriter text to be
335 hyphenated, use the hyphenat package.
336 If none of these options is specified, autoinst tries to guess: if
338 the font's filename contains the string "mono" or if the field
339 "isFixedPitch" in the font's post table is True, it will select
340 -typewriter; else if the filename contains "sans" it selects
341 -sanserif; and otherwise it will opt for -serif.
342 -lining/-nolining
344 Control the creation of fonts with lining figures. The default is
345 -lining.
346 -oldstyle/-nooldstyle
348 Control the creation of fonts with oldstyle figures. The default is
349 -oldstyle.
350 -proportional/-noproportional
352 Control the creation of fonts with proportional figures. The
353 default is -proportional.
354 -tabular/-notabular
356 Control the creation of fonts with tabular figures. The default is
357 -tabular.
358 -smallcaps/-nosmallcaps
360 Control the creation of small caps fonts. The default is
361 -smallcaps.
362 -swash/-noswash
364 Control the creation of swash fonts. The default is -swash.
365 -titling/-notitling
367 Control the creation of titling families. The default is -titling.
368 -superiors/-nosuperiors
370 Control the creation of fonts with superior characters. The
371 default is -superiors.
372 -noinferiors
374 -inferiors [= none | auto | subs | sinf | dnom ]
375 The OpenType standard defines several kinds of digits that might be
376 used as inferiors or subscripts: "Subscripts" (OpenType feature
377 "subs"), "Scientific Inferiors" ("sinf"), and "Denominators"
378 ("dnom"). This option allows the user to determine which of these
379 styles autoinst should use for the inferior characters.
380 Alternatively, the value "auto" tells autoinst to use the first
381 value in "sinf", "subs" or "dnom" that is supported by the font.
382 Saying just -inferiors is equivalent to -inferiors=auto; otherwise
383 the default is -noinferiors.
384 If you specify a style of inferiors that isn't present in the font,
386 autoinst will fall back to its default behaviour of not creating
387 fonts with inferiors at all; it won't try to substitute one of the
388 other styles.
389 -fractions/-nofractions
391 Control the creation of fonts with numerators and denominators.
392 The default is -nofractions.
393 -ornaments/-noornaments
395 Control the creation of ornament fonts. The default is -ornaments.
396 -ligatures/-noligatures
398 Some fonts create glyphs for the standard f-ligatures (ff, fi, fl,
399 ffi, ffl), but don't provide a "liga" feature to access these.
400 This option tells autoinst to add extra "LIGKERN" rules to the
401 generated fonts to enable the use of these ligatures. The default
402 is -ligatures, unless the user specified the -typewriter option.
403 Specify -noligatures to disable the generation of ligatures even
405 for fonts that do contain a "liga" feature.
406 -defaultlining/-defaultoldstyle
408 -defaulttabular/-defaultproportional
409 Tell autoinst which figure style is the current font family's
410 default (i.e., which figures you get when you don't specify any
411 OpenType features).
412 Don't use these options unless you are certain you need them! They
414 are only needed for fonts that don't provide OpenType features for
415 their default figure style; and even in that case, autoinst's
416 default values (-defaultlining and -defaulttabular) are usually
417 correct.
418 -nofigurekern
420 Some fonts provide kerning pairs for tabular figures. This is very
421 probably not what you want (e.g., numbers in tables won't line up
422 exactly). This option adds extra --ligkern options to the
423 commands for otftotfm to suppress such kerns. Note that this
424 option leads to very long commands (it adds one hundred --ligkern
425 options), which may cause problems on some systems.
426 -nfssweight=code=weight, -nfsswidth=code=width
428 Map the NFSS code code to the given weight or width, overriding the
429 built-in tables. Each of these options may be given multiple
430 times, to override more than one NFSS code. Example: to map the
431 "ul" code to the "Thin" weight, use "-nfssweight=ul=thin". To
432 inhibit the use of the "ul" code completely, use "-nfssweight=ul=".
433 -extra=text
435 Append text as extra options to the command lines for otftotfm. To
436 prevent text from accidentily being interpreted as options to
437 autoinst, it should be properly quoted.
438 -manual
440 Manual mode; for users who want to post-process the generated files
441 and commands. By default, autoinst immediately executes all
442 otftotfm commands it generates; in manual mode, these are instead
443 written to a file autoinst.bat. Furthermore it tells otftotfm to
444 generate human readable (and editable) pl/vpl files instead of the
445 default tfm/vf ones, and to place all generated files in a
446 subdirectory "./autoinst_output/" of the current directory, rather
447 than install them into your TeX installation.
448 When using this option, you need to execute the following manual
450 steps after autoinst has finished:
451 - run pltotf and vptovf on the generated pl and vf files, to
453 convert them to tfm/vf format;
454 - move all generated files to a proper TEXMF tree, and, if
455 necessary, update the filename database;
456 - tell TeX about the new map file (usually by running "updmap" or
457 similar).
458 Note that some options (-target, -vendor and -typeface,
460 -[no]updmap) are meaningless, and hence ignored, in manual mode.
461 -target=DIRECTORY
463 Install all generated files into the TEXMF tree at DIRECTORY.
464 By default, autoinst searches the $TEXMFLOCAL and $TEXMFHOME trees
466 and installs all files into the first user-writable TEXMF tree it
467 finds. If autoinst cannot find such a user-writable directory
468 (which shouldn't happen, since $TEXMFHOME is supposed to be user-
469 writable) it will print a warning message and put all files into
470 the subdirectory "./autoinst_output/" of the current directory.
471 It's then up to the user to move the generated files to a better
472 location and update all relevant databases (usually by calling
473 texhash and updmap).
474 WARNING: using this option may interfere with kpathsea and updmap
476 (especially when the chosen directory is outside the standard TEXMF
477 trees), so using -target will disable the automatic call to updmap
478 (as if -noupdmap had been given). It is up to the user to manually
479 update all databases (i.e., by calling texhash and updmap or
480 similar).
481 -vendor=VENDOR
483 -typeface=TYPEFACE
484 These options are equivalent to otftotfm's --vendor and
485 --typeface options: they change the "vendor" and "typeface" parts
486 of the names of the subdirectories in the TEXMF tree where
487 generated files will be stored. The default values are "lcdftools"
488 and the font's FontFamily name.
489 Note that these options change only directory names, not the names
491 of any generated files.
492 -updmap/-noupdmap
494 Control whether or not updmap is called after the last call to
495 otftotfm. The default is -updmap.
496
498 Eddie Kohler's TypeTools (http://www.lcdf.org/type).
499 Perl can be obtained from http://www.perl.org; it is included in most
501 Linux distributions. For Windows, try ActivePerl
502 (http://www.activestate.com) or Strawberry Perl
503 (http://strawberryperl.com).
504 XeTeX (http://www.tug.org/xetex) and LuaTeX (http://www.luatex.org) are
506 Unicode-aware TeX engines that can use OpenType fonts directly, without
507 any (La)TeX-specific support files.
508 The FontPro project (https://github.com/sebschub/FontPro) offers very
510 complete LaTeX support (even for typesetting maths) for Adobe's Minion
511 Pro, Myriad Pro and Cronos Pro font families.
512
514 Marc Penninga (marcpenninga@gmail.com)
515 When sending a bug report, please give as much relevant information as
517 possible; this usually includes (but may not be limited to) the log
518 file (please add the -verbose command-line option, for extra info). If
519 you see any error messages, please include these verbatim; don't
520 paraphase.
521
523 Copyright (C) 2005-2020 Marc Penninga.
524
526 This program is free software; you can redistribute it and/or modify it
527 under the terms of the GNU General Public License as published by the
528 Free Software Foundation, either version 2 of the License, or (at your
529 option) any later version. A copy of the text of the GNU General
530 Public License is included in the fontools distribution; see the file
531 GPLv2.txt.
532
534 This program is distributed in the hope that it will be useful, but
535 WITHOUT ANY WARRANTY; without even the implied warranty of
536 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
537 General Public License for more details.
538
540 This document describes autoinst version 20200511.
541
543 (See the source for the full story, all the way back to 2005.)
544 2020-05-11 When present, use encoding files in the current working
546 directory in preference of the ones that come with
547 autoinst. Changed the way ornament fonts are created;
548 ornament glyphs are now always included in the position
549 chosen by the font's designer.
550 2020-04-28 Fix a bug where the first font argument would be mistaken
552 for an argument to -inferiors.
553 2020-01-29 Don't create empty subdirectories in the target TEXMF tree.
555 2019-11-18 Fine-tuned calling of kpsewhich on Windows (patch by Akira
557 Kakuto). The font info parsing now also recognises
558 numerical weights, e.g. in Museo.
559 2019-10-29 The generated style files now use T1 as the default text
561 encoding.
562 2019-10-27 The mapping in fd files between font series and standard
564 NFSS attributes now uses the new alias function instead of
565 ssub (based on code by Frank Mittelbach). The way otftotfm
566 is called was changed to work around a Perl/Windows bug;
567 the old way might cause the process to hang. Using the
568 -target option now implies -noupdmap, since choosing a non-
569 standard target directory interferes with kpathsea/texhash
570 and updmap.
571 2019-10-01 Handle -target directories with spaces in their path names.
573 Tweaked messages and logs to make them more useful to the
574 user.
575 2019-07-12 Replaced single quotes in calls to otfinfo with double
577 quotes, as they caused problems on Windows 10.
578 2019-06-25
580 - Added the -mergeweights and -mergeshapes options, and
581 improved -mergewidths.
582 - Improved the parsing of fonts' widths and weights.
584 - Improved the mapping of widths and weights to NFSS
586 codes.
587 - Changed logging code so that that results of font info
589 parsing are always logged, even (especially!) when
590 parsing fails.
591 - Added a warning when installing fonts from multiple
593 families.
594 - Added simple recognition for sanserif and typewriter
596 fonts.
597 - Fixed error checking after calls to otfinfo (autoinst
599 previously only checked whether "fork()" was successful,
600 not whether the actual call to otfinfo worked).
601 - Fixed a bug in the -inferiors option; when used without
603 a (supposedly optional) value, it would silently gobble
604 the next option instead.
605 2019-05-22 Added the mainfont option to the generated sty files.
607 Prevented hyphenation for typewriter fonts (added
608 "\hyphenchar\font=-1" to the "\DeclareFontFamily"
609 declarations). Added the -version option.
610 2019-05-17 Changed the way the -ligatures option works: -ligatures
612 enables f-ligatures (even without a "liga" feature),
613 -noligatures now disables f-ligatures (overriding a "liga"
614 feature).
615 2019-05-11 Separate small caps families are now also recognised when
617 the family name ends with "SC" (previously autoinst only
618 looked for "SmallCaps").
619 2019-04-22 Fixed a bug in the generation of swash shapes.
621 2019-04-19 Fixed a bug that affected -mergesmallcaps with multiple
623 encodings.
624 2019-04-16 Added the <-mergesmallcaps> option, to handle cases where
626 the small caps fonts are in separate font families.
627 Titling shape is now treated as a separate family instead
628 of a distinct shape; it is generated only for fonts with
629 the 'titl' feature. Only add f-ligatures to fonts when
630 explicitly asked to (-ligatures).
631 2019-04-11 Tried to make the log file more relevant. Added the
633 -nfssweight and -nfsswidth options, and finetuned the
634 automatic mapping between fonts and NFSS codes. Changed
635 the name of the generated log file to <fontfamily>.log, and
636 revived the -logfile option to allow overriding this
637 choice. Made -mergewidths the default (instead of
638 -nomergewidths).
639 2019-04-01 Fine-tuned the decision where to put generated files; in
641 particular, create $TEXMFHOME if it doesn't already exist
642 and $TEXMFLOCAL isn't user-writable.
643 In manual mode, or when we can't find a user-writable TEXMF
645 tree, put all generated files into a subdirectory
646 "./autoinst_output/" instead of all over the current
647 working directory.
648 Added "auto" value to the inferiors option, to tell
650 autoinst to use whatever inferior characters are available.
651 2019-03-14 Overhauled the mapping of fonts (more specifically of
653 weights and widths; the mapping of shapes didn't change) to
654 NFSS codes. Instead of inventing our own codes to deal
655 with every possible weight and width out there, we now
656 create "long" codes based on the names in the font
657 metadata. Then we add "ssub" rules to the fd files to map
658 the standard NFSS codes to our fancy names (see the section
659 NFSS codes; based on discussions with Frank Mittelbach and
660 Bob Tennent).
661fontools 2020-05-11 AUTOINST(1)