1AUTOINST(1) Marc Penninga AUTOINST(1)
2
3
4
6 autoinst - wrapper around the LCDF TypeTools, for installing and using
7 OpenType fonts in LaTeX.
8
10 autoinst -help
11
12 autoinst [options] font(s)
13
15 Eddie Kohler's LCDF TypeTools are superb tools for installing OpenType
16 fonts in LaTeX, but they can be hard to use: they need many, often
17 long, command lines and don't generate the fd and sty files LaTeX
18 needs. autoinst simplifies the use of the TypeTools for font
19 installation by generating and executing all commands for otftotfm, and
20 by creating and installing all necessary fd and sty files.
21
22 Given a family of font files (in otf or ttf format), autoinst will
23 create several LaTeX font families:
24
25 - Four text families (with lining and oldstyle digits, each in both
26 tabular and proportional variants), all with the following shapes:
27
28 n Roman (i.e., upright) text
29
30 it, sl Italic and slanted (sometimes called oblique) text
31
32 sc Small caps
33
34 scit, scsl
35 Italic and slanted small caps
36
37 sw Swash
38
39 nw "Upright swash"
40
41 - For each T1-encoded text family: a family of TS1-encoded symbol
42 fonts, in roman, italic and slanted shapes.
43
44 - Families with superiors, inferiors, numerators and denominators,
45 in roman, italic and slanted shapes.
46
47 - Families with "Titling" characters; these "... replace the default
48 glyphs with corresponding forms designed specifically for titling.
49 These may be all-capital and/or larger on the body, and adjusted
50 for viewing at larger sizes" (according to the OpenType
51 Specification).
52
53 - An ornament family; also in roman, italic and slanted shapes.
54
55 Of course, if your fonts don't contain italics, oldstyle digits, small
56 caps etc., the corresponding shapes and families are not created. In
57 addition, the creation of most families and shapes can be controlled by
58 the user (see "COMMAND-LINE OPTIONS" below).
59
60 These families use the FontPro project's naming scheme:
61 <FontFamily>-<Suffix>, where <Suffix> is:
62
63 LF proportional (i.e., figures have varying widths) lining figures
64
65 TLF tabular (i.e., all figures have the same width) lining figures
66
67 OsF proportional oldstyle figures
68
69 TOsF tabular oldstyle figures
70
71 Sup superior characters (note that most fonts have only an
72 incomplete set of superior characters: digits, some punctuation
73 and the letters abdeilmnorst; normal forms are used for other
74 characters)
75
76 Inf inferior characters; usually only digits and some punctuation,
77 normal forms for other characters
78
79 Titl Titling characters; see above
80
81 Orn ornaments
82
83 Numr, Dnom
84 numerators and denominators
85
86 The individual fonts are named <FontName>-<suffix>-<shape>-<enc>, where
87 <suffix> is the same as above (but in lowercase), <shape> is either
88 empty, "sc" or "swash", and <enc> is the encoding (also in lowercase).
89 A typical name in this scheme would be FiraSans-Light-osf-sc-ly1.
90
91 Using the fonts in your LaTeX documents
92 autoinst generates a style file for using the fonts in LaTeX documents,
93 named <FontFamily>.sty. This style file also loads the fontenc and
94 textcomp packages, if necessary. To use the fonts, add the command
95 "\usepackage{<FontFamily>}" to the preamble of your document.
96
97 This style file has a few options:
98
99 "mainfont"
100 Redefine "\familydefault" to make this font the main font for the
101 document. This is a no-op if the font is installed as a serif
102 font; but if the font is installed as a sanserif or typewriter
103 font, this option saves you from having to redefine
104 "\familydefault" yourself.
105
106 "lining", "oldstyle", "tabular", "proportional"
107 Choose which figure style to use. The defaults are "oldstyle" and
108 "proportional" (if available).
109
110 "scale=<factor>", "scale=MatchLowercase"
111 Scale the font by <factor>; as an example,
112 "\usepackage[scale=1.05]{<FontFamily>}" will increase the font's
113 size by 5%. The special value "MatchLowercase" may be used to
114 scale the font so that its x-height matches that of the current
115 main font (which is usually Computer Modern Roman, unless you have
116 loaded another font package before this one). The word "scale" may
117 also be spelled as "scaled".
118
119 "medium", "book", "text", "normal", "regular"
120 Select the weight that LaTeX will use as the "regular" weight.
121
122 "heavy", "black", "extrabold", "demibold", "semibold", "bold"
123 Select the weight that LaTeX will use as the "bold" weight.
124
125 The last two groups of options will only work if you have the mweights
126 package installed. The default here is not to change LaTeX's default,
127 i.e. use the "m" and "b" weights.
128
129 The style file will also try to load the fontaxes package (on CTAN),
130 which gives easy access to various font shapes and styles. Using the
131 machinery set up by fontaxes, the generated style file defines a number
132 of commands (which take the text to be typeset as argument) and
133 declarations (which don't take arguments, but affect all text up to the
134 end of the current group) to access titling, superior and inferior
135 characters:
136
137 DECLARATION COMMAND SHORT FORM OF COMMAND
138
139 \tlshape \texttitling \texttl
140 \supfigures \textsuperior \textsup, \textsu
141 \inffigures \textinferior \textinf, \textin
142
143 In addition, the existing "\swshape" and "\textsw" commands are
144 redefined to place swash on fontaxes' secondary shape axis (fontaxes
145 places it on the primary shape axis) to make them behave properly when
146 nested, so that "\swshape\upshape" will give upright swash.
147
148 Finally, the style file redefines Latex's "\textsuperscript" and
149 "\textsubscript" commands to use the fonts' superior and inferior
150 figures, and modifies Latex's footnote mechanism to use
151 "\textsuperscript" instead of reduced-size numerals from the regular
152 text font. The old versions of these commands are still available as
153 "\textsuperscript*" and "\textsubscript*".
154
155 There are no commands for accessing the numerator and denominator
156 fonts; these can be selected using fontaxes' standard commands, e.g.,
157 "\fontfigurestyle{numerator}\selectfont".
158
159 Once again: all these commands are only generated for existing shapes
160 and number styles; no commands are generated for shapes and styles that
161 are missing from your fonts. Note that all these commands are built on
162 top of fontaxes; if that package cannot be found, you're limited to
163 using lower-level commands from standard NFSS ("\fontfamily",
164 "\fontseries", "\fontshape" etc.).
165
166 By default, autoinst generates text fonts with OT1, LY1 and T1
167 encodings, and the generated style files use T1 as the default text
168 encoding. Other encodings can be chosen using the -encoding option
169 (see "COMMAND-LINE OPTIONS" below).
170
171 Maths
172 This is an experimental feature; USE AT YOUR OWN RISK! Test the
173 results thoroughly before using them in real documents, and be warned
174 that future versions of autoinst may introduce incompatible changes.
175
176 The -math option tells autoinst to generate basic math fonts. When
177 enabled, the generated style file defines a few extra options to access
178 these math fonts:
179
180 "math"
181 Use these fonts for the maths in your document.
182
183 "mathlining", "matholdstyle", "mathtabular", "mathproportional"
184 Choose which figure style and alignment to use in maths. The
185 defaults are "mathlining" and "mathtabular".
186
187 "mathcal"
188 Use the swash characters from these fonts as the "\mathcal"
189 alphabet. (This option will only exist if your fonts actually
190 contain swash characters, plus a "swsh" feature to access them).
191
192 "nomathgreek"
193 Don't redeclare greek letters in math.
194
195 "math-style=<style>"
196 Choose the "math style" to use. With "math-style=ISO", all latin
197 and greek letters in math are italic; with "math-style=TeX" (the
198 default), uppercase greek is upright; with "math-style=french", all
199 greek as well as uppercase latin is upright; and with
200 "math-style=upright" all letters are upright.
201
202 Note that this "math" option only affects digits, latin and greek
203 letters, plus a few basic punctuation characters; all other
204 mathematical symbols, operators, delimiters etc. are left as they were
205 before. If you don't want to use TeX's default versions of those
206 symbols, load another math package (such as mathdesign or newtxmath)
207 before loading the autoinst-generated style file.
208
209 Finally, note that autoinst doesn't check if your fonts actually
210 contains all of the required characters; it just assumes that they do
211 and sets up the style file accordingly. Even if your fonts do contain
212 greek, characters such as "\varepsilon" may be missing. You may also
213 find that some glyphs are present in your fonts, but don't work well in
214 equations or don't match with other symbols; edit the generated style
215 file to remove the declarations of these offending characters. Once
216 again: test the results before using them! If the characters
217 themselves are fine but spaced too tightly, you may try increasing the
218 side bearings in math fonts with the -mathspacing option (see below),
219 e.g. "-mathspacing=50".
220
221 NFSS codes
222 LaTeX's New Font Selection System (NFSS) identifies fonts by a
223 combination of family, series (the concatenation of weight and width),
224 shape and size. autoinst parses the font's metadata to determine these
225 parameters. When this fails (usually because the font family contains
226 uncommon weights, widths or shapes), autoinst ends up with multiple
227 fonts having the same values for these font parameters; such fonts
228 cannot be used in NFSS, since there's no way distinguish them. When
229 autoinst detects such a situation, it will print an error message and
230 abort. If that happens, either rerun autoinst on a smaller set of
231 fonts, or add the missing widths, weights and shapes to the tables
232 @WIDTH, @WEIGHT and %SHAPE in the source code. Please also send a bug
233 report (see AUTHOR below).
234
235 The mapping of shapes to NFSS codes is done using the following table:
236
237 SHAPE CODE
238 -------------------------------- ----
239 Roman, Upright n
240 Italic it
241 Oblique, Slant(ed), Incline(d) sl
242
243 (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
247 For weights and widths, autoinst tries to the standard NFSS codes (ul,
248 el, l, sl, m, sb, b, eb and ub for weights; uc, ec, c, sc, m, sx, x, ex
249 and ux for widths) as much as possible. Of course, not all 81
250 combinations of these NFSS weights and widths will map to existing
251 fonts; and conversely it may not be possible to assign every existing
252 font a unique code in a sane way (especially for the weights, some font
253 families offer more variants than NFSS's codes can handle; e.g., Fira
254 Sans contains fifteen different weights!). Therefore every font is
255 also assigned a "series" name that is the concatenation of its weight
256 and width, after expanding any abbreviations and converting to
257 lowercase. A font of "Cond" width and "Ultra" weight will then be
258 known as "ultrablackcondensed".
259
260 The exact mapping between fonts and NFSS codes can be found in the
261 generated fd files and in the log file (you may want to run autoinst
262 with the -dryrun option to check the chosen mapping beforehand). The
263 -nfssweight and -nfsswidth command-line options can be used to finetune
264 the mapping between NFSS codes and fonts.
265
266 To access specific weights or widths, one can always use the
267 "\fontseries" command with the full series name (i.e.,
268 "\fontseries{demibold}\selectfont").
269
270 Ornaments
271 Ornament fonts are regular LY1-encoded fonts, with a number of
272 "regular" characters replaced by ornament glyphs. The OpenType
273 specification says that fonts should only put their ornaments in place
274 of the lowercase ASCII letters, but some fonts put them in other
275 positions (such as those of the digits) as well.
276
277 Ornaments can be accessed like "{\ornaments a}" and
278 "{\ornaments\char"61}", or equivalently "\textornaments{a}" and
279 "\textornaments{\char"61}". To see which ornaments a font contains
280 (and at which positions), run LaTeX on the file nfssfont.tex (which is
281 included in any standard LaTeX installation), supply the name of the
282 ornament font (i.e., "GaramondLibre-Regular-orn-u") and give the
283 command "\table\bye"; this will create a table of all glyphs in that
284 font.
285
286 Note that versions of autoinst up to 20200428 handled ornaments
287 differently, and fonts and style files generated by those versions are
288 not compatible with files generated by newer versions.
289
291 OpenType fonts and licensing issues
292 Since pdfTeX cannot subset otf-flavoured OpenType fonts, otftotfm will
293 convert such fonts to Type1 (pfb) format. However, many fonts (at
294 least those licensed under the SIL Open Font License) do not allow
295 redistributing such converted versions under their original name.
296
297 In order to try to meet such licensing requirements, autoinst provides
298 a -t1suffix command-line option that appends a suffix to the names
299 (both the filename and the internal font name) of all generated Type1
300 fonts; see "COMMAND-LINE OPTIONS" below.
301
302 Please note that I am not a lawyer and do not guarantee that this
303 suffix is sufficient to meet the license's requirements. When in
304 doubt, consult a real lawyer!
305
306 Sorry, LIGTABLE too long for me to handle
307 The LIGTABLE in TeX's tfm files, which contains a font's ligatures and
308 kerning pairs, is limited to about 32,500 entries (2^15 - 256). If the
309 number of ligatures plus kerns in a font is higher than that limit,
310 pltotf and vptovf will complain loudly and ignore the excess entries.
311 This happens at least with Adobe's Source Serif 4 and Minion 3 font
312 families. Even when pltotf and vptovf don't warn about the LIGTABLE's
313 size, you may still find that pdftex crashes with a "Bad metric (TFM)
314 file" error. The best way to handle this situation is to use
315 autoinst's "-extra" option to raise otftotfm's value for the
316 "--min-kern" parameter, which causes it to ignore small kerning pairs:
317 "-extra='--min-kern=6.0'". Finding the correct value for the
318 "--min-kern" parameter may require some trial and error.
319
320 A note for MiKTeX users
321 Automatically installing the fonts into a suitable TEXMF tree (as
322 autoinst tries to do by default) only works for TeX-installations that
323 use the kpathsea library; with TeX distributions that implement their
324 own directory searching, such as MiKTeX, autoinst will complain that it
325 cannot find the kpsewhich program and move all generated files into a
326 subdirectory "autoinst_output/" of the current directory. If you use
327 such a TeX distribution, you should either move these files to their
328 correct destinations by hand, or use the -target option (see "COMMAND-
329 LINE OPTIONS" below) to manually specify a TEXMF tree.
330
331 Also, some OpenType fonts contain so many kerning pairs that the
332 resulting pl and vpl files are too big for MiKTeX's pltotf and vptovf;
333 the versions that come with W32TeX (http://www.w32tex.org) and TeXLive
334 (http://tug.org/texlive) don't seem to have this problem.
335
336 A note for MacTeX users
337 By default, autoinst will try to install all generated files into the
338 $TEXMFLOCAL tree; when this directory isn't user-writable, it will use
339 the $TEXMFHOME tree instead. Unfortunately, MacTeX's version of
340 "updmap-sys" doesn't search in $TEXMFHOME, and hence MacTeX will not
341 find the new fonts.
342
343 To remedy this, either run autoinst as root (so that it can install
344 everything into $TEXMFLOCAL) or manually run "updmap -user" to tell TeX
345 about the files in $TEXMFHOME. This latter option does, however, come
346 with some caveats; see https://tug.org/texlive/scripts-sys-user.html.
347
349 autoinst tries hard to do The Right Thing (TM) by default, so you
350 usually won't need these options; but most aspects of its operation can
351 be fine-tuned if you want to.
352
353 You may use either one or two dashes before options, and option names
354 may be shortened to a unique prefix (e.g., -encoding may be abbreviated
355 to -enc or even -en, but -e is ambiguous (it may mean either -encoding
356 or -extra)).
357
358 General options
359 -help
360 Print a (relatively) short help text and exit.
361
362 -dryrun
363 Don't generate output; just parse input fonts and write the results
364 to the log file.
365
366 -verbose
367 Add more details to the log file.
368
369 -version
370 Print autoinst's version number and exit.
371
372 Font creation options
373 -encoding=encoding[,encoding]
374 Generate the specified encoding(s) for the text fonts. Multiple
375 encodings may be specified as a comma-separated list (without
376 spaces!); the default choice of encodings is "OT1,LY1,T1".
377
378 For each encoding argument, autoinst will first check if it is the
379 filename of an encoding file, and if found it will use that;
380 otherwise the argument is assumed to be the name of one of the
381 built-in encodings. Currently autoinst comes with built-in support
382 for the OT1, T1/TS1, LY1, T2A/B/C, T3/TS3, T4, T5, LGR, CS, L7X and
383 QX encodings. (These files are called fontools_ot1.enc etc. to
384 avoid name clashes with other packages; the fontools_ prefix may be
385 omitted.)
386
387 -ts1/-nots1
388 Control the creation of TS1-encoded fonts. The default is -ts1 if
389 the text encodings (see -encoding above) include T1, -nots1
390 otherwise.
391
392 -lining/-nolining
393 Control the creation of fonts with lining figures. The default is
394 -lining.
395
396 -oldstyle/-nooldstyle
397 Control the creation of fonts with oldstyle figures. The default is
398 -oldstyle.
399
400 -proportional/-noproportional
401 Control the creation of fonts with proportional figures. The
402 default is -proportional.
403
404 -tabular/-notabular
405 Control the creation of fonts with tabular figures. The default is
406 -tabular.
407
408 -smallcaps/-nosmallcaps
409 Control the creation of small caps fonts. The default is
410 -smallcaps.
411
412 -swash/-noswash
413 Control the creation of swash fonts. The default is -swash.
414
415 -titling/-notitling
416 Control the creation of titling families. The default is -titling.
417
418 -superiors/-nosuperiors
419 Control the creation of fonts with superior characters. The
420 default is -superiors.
421
422 -inferiors [ = none | auto | subs | sinf | dnom ]
423 -noinferiors
424 The OpenType standard defines several kinds of digits that might be
425 used as inferiors or subscripts: "Subscripts" (OpenType feature
426 "subs"), "Scientific Inferiors" ("sinf"), and "Denominators"
427 ("dnom"). This option allows the user to determine which of these
428 styles autoinst should use for the inferior characters.
429 Alternatively, the value "auto" tells autoinst to use the first
430 value in "sinf", "subs" or "dnom" that is supported by the font.
431 Saying just -inferiors is equivalent to -inferiors=auto; otherwise
432 the default is -noinferiors.
433
434 If you specify a style of inferiors that isn't present in the font,
435 autoinst will fall back to its default behaviour of not creating
436 fonts with inferiors at all; it won't try to substitute one of the
437 other styles.
438
439 -fractions/-nofractions
440 Control the creation of fonts with numerators and denominators.
441 The default is -nofractions.
442
443 -ligatures/-noligatures
444 Some fonts contain glyphs for the standard f-ligatures (ff, fi, fl,
445 ffi, ffl), but don't provide a "liga" feature to access these.
446 This option tells autoinst to add extra "LIGKERN" rules to the
447 generated fonts to enable the use of these ligatures. The default
448 is -ligatures, except for typewriter fonts.
449
450 Specify -noligatures to disable generation of ligatures even for
451 fonts that do contain a "liga" feature.
452
453 -ornaments/-noornaments
454 Control the creation of ornament fonts. The default is -ornaments.
455
456 -serif/-sanserif/-typewriter
457 Install the font as a serif, sanserif or typewriter font,
458 respectively. This changes how you access the font in LaTeX: with
459 "\rmfamily"/"\textrm", "\sffamily"/"\textsf" or
460 "\ttfamily"/"\texttt".
461
462 Installing the font as a typewriter font will cause two further
463 changes: it will - by default - turn off the use of f-ligatures
464 (though this can be overridden with the -ligatures option), and it
465 will disable hyphenation for this font. This latter effect cannot
466 be re-enabled in autoinst; if you want typewriter text to be
467 hyphenated, use the hyphenat package.
468
469 If none of these options is specified, autoinst tries to guess: if
470 the font's filename contains the string "mono" or if the field
471 "isFixedPitch" in the font's "post" table is True, it will select
472 -typewriter; else if the filename contains "sans" it will select
473 -sanserif; otherwise it will opt for -serif.
474
475 -math
476 Tells autoinst to create basic math fonts (see above).
477
478 -mathspacing=amount
479 Letterspace each character in the math fonts by amount units, where
480 1000 units equal one em. In my opinion, many text fonts benefit
481 from letterspacing by 50 to 100 units when used in maths; some
482 fonts need even more. Use your own judgement!
483
484 Output options
485 -t1suffix [ = SUFFIX ]
486 Tell autoinst to modify the font names of all generated
487 Type1-fonts, by adding SUFFIX to the family name. If you use this
488 option without specifying a SUFFIX value, autoinst will use the
489 value "PS". The default behaviour when this option is not given is
490 to not modify font names at all.
491
492 See also "OpenType fonts and licensing issues" in "WARNINGS AND
493 CAVEATS" above.
494
495 -target=DIRECTORY
496 Install all generated files into the TEXMF tree at DIRECTORY.
497
498 By default, autoinst searches the $TEXMFLOCAL and $TEXMFHOME trees
499 and installs all files into the first user-writable TEXMF tree it
500 finds. If autoinst cannot find such a user-writable directory
501 (which shouldn't happen, since $TEXMFHOME is supposed to be user-
502 writable) it will print a warning message and put all files into
503 the subdirectory "autoinst_output/" of the current directory. It's
504 then up to the user to move the generated files to a better
505 location and update all relevant databases (usually by calling
506 texhash and updmap).
507
508 -vendor=VENDOR
509 -typeface=TYPEFACE
510 These options are equivalent to otftotfm's --vendor and
511 --typeface options: they change the "vendor" and "typeface" parts
512 of the names of the subdirectories in the TEXMF tree where
513 generated files will be stored. The default values are "lcdftools"
514 and the font's FontFamily name. These options change only
515 directory names, not the names of any generated files.
516
517 -logfile=filename
518 Write log data to filename instead of the default <fontfamily>.log.
519 If the file already exists, autoinst appends to it; it doesn't
520 overwrite an existing file.
521
522 Specialist options
523 -defaultlining/-defaultoldstyle
524 -defaulttabular/-defaultproportional
525 Tell autoinst which figure style is the current font family's
526 default (i.e., which figures you get when you don't specify any
527 OpenType features).
528
529 Don't use these options unless you are certain you need them! They
530 are only needed for fonts that don't provide OpenType features for
531 their default figure style; and even in that case, autoinst's
532 default values (-defaultlining and -defaulttabular) are usually
533 correct.
534
535 -nfssweight=code=weight
536 -nfsswidth=code=width
537 Map the NFSS code code to the given weight or width, overriding the
538 built-in tables. Each of these options may be given multiple
539 times, to override more than one NFSS code. Example: to map the
540 "ul" code to the "Thin" weight, use "-nfssweight=ul=thin". To
541 inhibit the use of the "ul" code completely, use "-nfssweight=ul=".
542
543 -extra=extra options
544 Pass extra options to the commands for otftotfm. To prevent extra
545 options from accidentily being interpreted as options to autoinst,
546 they should be properly quoted.
547
548 -manual
549 Manual mode; for users who want to post-process the generated files
550 and commands. By default, autoinst immediately executes all
551 otftotfm commands it generates; in manual mode, these are instead
552 written to a file autoinst.bat. Furthermore it tells otftotfm to
553 generate human readable (and editable) pl/vpl files instead of the
554 default tfm/vf ones, and to place all generated files in a
555 subdirectory "./autoinst_output/" of the current directory, rather
556 than install them into your TeX installation.
557
558 When using this option, you need to execute the following manual
559 steps after autoinst has finished:
560
561 - run pltotf and vptovf on the generated pl and vf files, to
562 convert them to tfm/vf format;
563 - move all generated files to a proper TEXMF tree, and, if
564 necessary, update the filename database;
565 - tell TeX about the new map file (usually by running "updmap" or
566 similar).
567
568 Note that some options (-target, -vendor and -typeface) are
569 meaningless, and hence ignored, in manual mode.
570
571 Also note that font name modification doesn't happen in manual
572 mode.
573
574 -nofigurekern
575 Some fonts provide kerning pairs for tabular figures. This is very
576 probably not what you want (e.g., numbers in tables won't line up
577 exactly). This option adds extra --ligkern options to the
578 commands for otftotfm to suppress such kerns. Note that this
579 option leads to very long commands (it adds one hundred --ligkern
580 options), which may cause problems on some systems; hence it is not
581 active by default.
582
584 Eddie Kohler's TypeTools and T1Utils (http://www.lcdf.org/type).
585
586 Perl can be obtained from http://www.perl.org; it is included in most
587 Linux distributions. For Windows, try ActivePerl
588 (http://www.activestate.com) or Strawberry Perl
589 (http://strawberryperl.com).
590
591 LuaTeX (http://www.luatex.org) and XeTeX (http://www.tug.org/xetex) are
592 Unicode-aware TeX engines that can use OpenType fonts directly, without
593 any (La)TeX-specific support files.
594
595 The FontPro project (https://github.com/sebschub/FontPro) offers very
596 complete LaTeX support (even for typesetting maths) for Adobe's Minion
597 Pro, Myriad Pro and Cronos Pro font families.
598
600 Marc Penninga (marcpenninga@gmail.com)
601
602 When sending a bug report, please give as much relevant information as
603 possible; this usually includes (but may not be limited to) the log
604 file (please add the -verbose command-line option, for extra info). If
605 you see any error messages, please include these verbatim; don't
606 paraphase.
607
609 Copyright (C) 2005-2023 Marc Penninga.
610
612 This program is free software; you can redistribute it and/or modify it
613 under the terms of the GNU General Public License as published by the
614 Free Software Foundation, either version 2 of the License, or (at your
615 option) any later version. A copy of the text of the GNU General
616 Public License is included in the fontools distribution; see the file
617 GPLv2.txt.
618
620 This program is distributed in the hope that it will be useful, but
621 WITHOUT ANY WARRANTY; without even the implied warranty of
622 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
623 General Public License for more details.
624
626 This document describes autoinst version 20230201.
627
629 (See the source for the full story, all the way back to 2005.)
630
631 2023-02-01 Added support for the T4, T5, CS, L7X and QX encodings.
632
633 2023-01-31 If the fonts contain superior and/or inferior figures, the
634 generated style file now redefines the "\textsuperscript"
635 and "\textsubscript" commands, and patches Latex's footnote
636 mechanism to use these figures (inspired by the realscripts
637 package). Fixed a few bugs in metadata parsing, style file
638 generation and the "-t1suffix" option, so that the latter
639 also works for dvips and dvipdfmx.
640
641 2021-11-15 Bugfix: font info parsing now works for Adobe Source Serif
642 4.
643
644 2021-07-21 Bugfixes:
645
646 - Yet another problem with argument quoting on Windows.
647
648 - Selecting numerator/denominator fonts didn't work as
649 documented.
650
651 - Font info parsing failed for Microsoft Sitka and
652 LucasFonts Thesis.
653
654 2021-04-01 The -encoding option now also accepts filenames of encoding
655 files in directories other than the current directory.
656 Directory names containing spaces do (or at least should)
657 also work.
658
659
660
661fontools 2023-02-01 AUTOINST(1)