Debian Codegraph @

texmf-dist/doc/man/man1/autoinst.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\"
56 .\" Required to disable full justification in groff 1.23.0.
57 .if n .ds AD l
58 .\" ========================================================================
59 .\"
60 .IX Title "AUTOINST 1"
61 .TH AUTOINST 1 2026-04-22 fontools "Marc Penninga"
62 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
63 .\" way too many mistakes in technical documents.
64 .if n .ad l
65 .nh
66 .SH NAME
67 autoinst \- wrapper around the LCDF TypeTools,
68 for installing and using OpenType fonts in LaTeX.
69 .SH SYNOPSIS
70 .IX Header "SYNOPSIS"
71 \&\fBautoinst\fR \fI\-help\fR
72 .PP
73 \&\fBautoinst\fR [\fIoptions\fR] \fBfont(s)\fR
74 .SH DESCRIPTION
75 .IX Header "DESCRIPTION"
76 Eddie Kohler\*(Aqs \fILCDF TypeTools\fR are superb tools for installing
77 OpenType fonts in LaTeX, but they can be hard to use:
78 they need many, often long, command lines
79 and don\*(Aqt generate the \fIfd\fR and \fIsty\fR files LaTeX needs.
80 \&\fBautoinst\fR simplifies the use of the \fITypeTools\fR for font installation
81 by generating and executing all commands for \fIotftotfm\fR,
82 and by creating and installing all necessary \fIfd\fR and \fIsty\fR files.
83 .PP
84 Given a family of font files (in \fIotf\fR or \fIttf\fR format),
85 \&\fBautoinst\fR will create several LaTeX font families:
86 .RS 2
87 .IP \- 3
88 Four text families (with lining and oldstyle digits,
89 each in both tabular and proportional variants),
90 all with the following shapes:
91 .RS 3
92 .RS 2
93 .IP \fIn\fR 8
94 .IX Item "n"
95 Roman (i.e., upright) text
96 .IP "\fIit\fR, \fIsl\fR" 8
97 .IX Item "it, sl"
98 Italic and slanted (sometimes called oblique) text
99 .IP \fIsc\fR 8
100 .IX Item "sc"
101 Small caps
102 .IP "\fIscit\fR, \fIscsl\fR" 8
103 .IX Item "scit, scsl"
104 Italic and slanted small caps
105 .IP \fIsw\fR 8
106 .IX Item "sw"
107 Swash
108 .IP \fInw\fR 8
109 .IX Item "nw"
110 "Upright swash"
111 .RE
112 .RS 2
113 .RE
114 .RE
115 .RS 3
116 .RE
117 .IP \- 3
118 For each T1\-encoded text family:
119 a family of TS1\-encoded symbol fonts, in roman, italic and slanted shapes.
120 .IP \- 3
121 Families with superiors, inferiors, numerators and denominators,
122 in roman, italic and slanted shapes.
123 .IP \- 3
124 Families with "Titling" characters;
125 these \fI"... replace the default glyphs
126 with corresponding forms designed specifically for titling.
127 These may be all\-capital and/or larger on the body,
128 and adjusted for viewing at larger sizes"\fR
129 (according to the OpenType Specification).
130 .IP \- 3
131 An ornament family; also in roman, italic and slanted shapes.
132 .RE
133 .RS 2
134 .RE
135 .PP
136 Of course, if your fonts don\*(Aqt contain italics, oldstyle digits, small caps
137 etc., the corresponding shapes and families are not created.
138 In addition, the creation of most families and shapes can be controlled
139 by the user (see "COMMAND\-LINE OPTIONS" below).
140 .PP
141 These families use the \fIFontPro\fR project\*(Aqs naming scheme:
142 \&\fI<FontFamily>\-<Suffix>\fR, where \fI<Suffix>\fR is:
143 .IP \fILF\fR 8
144 .IX Item "LF"
145 proportional (i.e., figures have varying widths) lining figures
146 .IP \fITLF\fR 8
147 .IX Item "TLF"
148 tabular (i.e., all figures have the same width) lining figures
149 .IP \fIOsF\fR 8
150 .IX Item "OsF"
151 proportional oldstyle figures
152 .IP \fITOsF\fR 8
153 .IX Item "TOsF"
154 tabular oldstyle figures
155 .IP \fISup\fR 8
156 .IX Item "Sup"
157 superior characters (note that most fonts have only an incomplete set of
158 superior characters: digits, some punctuation and the letters \fIabdeilmnorst\fR;
159 normal forms are used for other characters)
160 .IP \fIInf\fR 8
161 .IX Item "Inf"
162 inferior characters; usually only digits and some punctuation,
163 normal forms for other characters
164 .IP \fITitl\fR 8
165 .IX Item "Titl"
166 Titling characters; see above
167 .IP \fIOrn\fR 8
168 .IX Item "Orn"
169 ornaments
170 .IP "\fINumr\fR, \fIDnom\fR" 8
171 .IX Item "Numr, Dnom"
172 numerators and denominators
173 .PP
174 The individual fonts are named \fI<FontName>\-<suffix>\-<shape>\-<enc>\fR,
175 where \fI<suffix>\fR is the same as above (but in lowercase),
176 \&\fI<shape>\fR is either empty, "sc" or "swash",
177 and \fI<enc>\fR is the encoding (also in lowercase).
178 A typical name in this scheme would be \fIFiraSans\-Light\-osf\-sc\-ly1\fR.
179 .SS "Using the fonts in your LaTeX documents"
180 .IX Subsection "Using the fonts in your LaTeX documents"
181 \&\fBautoinst\fR generates a style file for using the fonts in LaTeX documents,
182 named \fI<FontFamily>.sty\fR. This style file also loads the \fIfontenc\fR
183 and \fItextcomp\fR packages, if necessary.
184 To use the fonts, add the command \f(CW\*(C`\eusepackage{\fR\f(CI<FontFamily>\fR\f(CW}\*(C'\fR
185 to the preamble of your document.
186 .PP
187 This style file has a few options:
188 .ie n .IP """mainfont""" 4
189 .el .IP \f(CWmainfont\fR 4
190 .IX Item "mainfont"
191 Redefine \f(CW\*(C`\efamilydefault\*(C'\fR to make this font the main font
192 for the document.
193 This is a no\-op if the font is installed as a serif font;
194 but if the font is installed as a sanserif or typewriter font,
195 this option saves you from having to redefine \f(CW\*(C`\efamilydefault\*(C'\fR
196 yourself.
197 .ie n .IP """lining"", ""oldstyle"", ""tabular"", ""proportional""" 4
198 .el .IP "\f(CWlining\fR, \f(CWoldstyle\fR, \f(CWtabular\fR, \f(CWproportional\fR" 4
199 .IX Item "lining, oldstyle, tabular, proportional"
200 Choose which figure style to use.
201 The defaults are "oldstyle" and "proportional" (if available).
202 .ie n .IP """scale=\fI<factor>\fR"", ""scale=MatchLowercase""" 4
203 .el .IP "\f(CWscale=\fR\f(CI<factor>\fR\f(CW\fR, \f(CWscale=MatchLowercase\fR" 4
204 .IX Item "scale=<factor>, scale=MatchLowercase"
205 Scale the font by \fI<factor>\fR;
206 as an example, \f(CW\*(C`\eusepackage[scale=1.05]{\fR\f(CI<FontFamily>\fR\f(CW}\*(C'\fR
207 will increase the font\*(Aqs size by 5%.
208 The special value \f(CW\*(C`MatchLowercase\*(C'\fR may be used to scale the font
209 so that its x\-height matches that of the current main font
210 (which is usually Computer Modern Roman, unless you have loaded
211 another font package before this one).
212 The word "scale" may also be spelled as "scaled".
213 .ie n .IP """medium"", ""book"", ""text"", ""normal"", ""regular""" 4
214 .el .IP "\f(CWmedium\fR, \f(CWbook\fR, \f(CWtext\fR, \f(CWnormal\fR, \f(CWregular\fR" 4
215 .IX Item "medium, book, text, normal, regular"
216 Select the weight that LaTeX will use as the "regular" weight.
217 .ie n .IP """heavy"", ""black"", ""extrabold"", ""demibold"", ""semibold"", ""bold""" 4
218 .el .IP "\f(CWheavy\fR, \f(CWblack\fR, \f(CWextrabold\fR, \f(CWdemibold\fR, \f(CWsemibold\fR, \f(CWbold\fR" 4
219 .IX Item "heavy, black, extrabold, demibold, semibold, bold"
220 Select the weight that LaTeX will use as the "bold" weight.
221 .PP
222 The default here is not to change LaTeX\*(Aqs default,
223 i.e. use the "m" and "b" weights.
224 .PP
225 The style file will also try to load the \fIfigureversions\fR package
226 (on CTAN), which gives easy access to various font shapes and styles.
227 Using the machinery set up by \fIfigureversions\fR, the generated style file
228 defines a number of commands (which take the text to be typeset as argument)
229 and declarations (which don\*(Aqt take arguments, but affect all text up to
230 the end of the current group) to access titling, superior and inferior
231 characters:
232 .PP
233 .Vb 1
234 \& DECLARATION COMMAND SHORT FORM OF COMMAND
235 \&
236 \& \etlshape \etexttitling \etexttl
237 \& \esupfigures \etextsuperior \etextsup, \etextsu
238 \& \einffigures \etextinferior \etextinf, \etextin
239 .Ve
240 .PP
241 Finally, the style file redefines Latex\*(Aqs \f(CW\*(C`\etextsuperscript\*(C'\fR and
242 \&\f(CW\*(C`\etextsubscript\*(C'\fR commands to use the fonts\*(Aq superior and inferior figures,
243 and modifies Latex\*(Aqs footnote mechanism to use \f(CW\*(C`\etextsuperscript\*(C'\fR
244 instead of reduced\-size numerals from the regular text font.
245 The old versions of these commands are still available as
246 \&\f(CW\*(C`\etextsuperscript*\*(C'\fR and \f(CW\*(C`\etextsubscript*\*(C'\fR.
247 .PP
248 There are no commands for accessing the numerator and denominator
249 fonts; these can be selected using \fIfigureversions\fR\*(Aq standard commands,
250 e.g., \f(CW\*(C`\efontfigurestyle{numerator}\eselectfont\*(C'\fR.
251 .PP
252 Once again: all these commands are only generated for existing shapes and number styles;
253 no commands are generated for shapes and styles that are missing from your fonts.
254 Note that all these commands are built on top of \fIfigureversions\fR; if that package
255 cannot be found, you\*(Aqre limited to using lower\-level commands from
256 standard NFSS (\f(CW\*(C`\efontfamily\*(C'\fR, \f(CW\*(C`\efontseries\*(C'\fR, \f(CW\*(C`\efontshape\*(C'\fR etc.).
257 .PP
258 By default, \fBautoinst\fR generates text fonts with OT1, LY1 and T1
259 encodings, and the generated style files use T1 as the default text encoding.
260 Other encodings can be chosen using the \fI\-encoding\fR option
261 (see "COMMAND\-LINE OPTIONS" below).
262 .SS Maths
263 .IX Subsection "Maths"
264 This is an experimental feature; \fBUSE AT YOUR OWN RISK!\fR
265 Test the results thoroughly before using them in real documents,
266 and be warned that future versions of \fBautoinst\fR may introduce
267 incompatible changes.
268 .PP
269 The \fI\-math\fR option tells \fBautoinst\fR to generate basic math fonts.
270 When enabled, the generated style file defines a few extra options
271 to access these math fonts:
272 .ie n .IP """math""" 4
273 .el .IP \f(CWmath\fR 4
274 .IX Item "math"
275 Use these fonts for the maths in your document.
276 .ie n .IP """mathlining"", ""matholdstyle"", ""mathtabular"", ""mathproportional""" 4
277 .el .IP "\f(CWmathlining\fR, \f(CWmatholdstyle\fR, \f(CWmathtabular\fR, \f(CWmathproportional\fR" 4
278 .IX Item "mathlining, matholdstyle, mathtabular, mathproportional"
279 Choose which figure style and alignment to use in maths.
280 The defaults are "mathlining" and "mathtabular".
281 .ie n .IP """mathcal""" 4
282 .el .IP \f(CWmathcal\fR 4
283 .IX Item "mathcal"
284 Use the swash characters from these fonts as the \f(CW\*(C`\emathcal\*(C'\fR alphabet.
285 (This option will only exist if your fonts actually contain
286 both swash characters and a \f(CW\*(C`swsh\*(C'\fR feature to access them).
287 .ie n .IP """nomathgreek""" 4
288 .el .IP \f(CWnomathgreek\fR 4
289 .IX Item "nomathgreek"
290 Don\*(Aqt redeclare greek letters in math.
291 .ie n .IP """math\-style=\fI<style>\fR""" 4
292 .el .IP \f(CWmath\-style=\fR\f(CI<style>\fR\f(CW\fR 4
293 .IX Item "math-style=<style>"
294 Choose the "math style" to use.
295 With \f(CW\*(C`math\-style=ISO\*(C'\fR, all latin and greek letters in math are italic;
296 with \f(CW\*(C`math\-style=TeX\*(C'\fR (the default), uppercase greek is upright;
297 with \f(CW\*(C`math\-style=french\*(C'\fR, all greek as well as uppercase latin is upright;
298 and with \f(CW\*(C`math\-style=upright\*(C'\fR all letters are upright.
299 .ie n .IP """scriptscale=\fI<scale>\fR""" 4
300 .el .IP \f(CWscriptscale=\fR\f(CI<scale>\fR\f(CW\fR 4
301 .IX Item "scriptscale=<scale>"
302 By default, Latex loads fonts for the "script" and "scriptscript" styles
303 at 70% and 50% of the text font size. For many text fonts, this is too small
304 and hurts readability.
305 This option scales the "script" style by a factor of \fIscale\fR and
306 the "scriptscript" style by the square of that.
307 The default value is 1.1, which loads the "script" and "scriptscript" styles
308 at a more readable 77% and 60.5%, respectively.
309 To use Latex\*(Aqs defaults, use \f(CW\*(C`scriptscale=1.0\*(C'\fR.
310 .PP
311 The style file also defines commands \f(CW\*(C`\eup...\*(C'\fR and \f(CW\*(C`\eit...\*(C'\fR to access upright
312 and italic greek characters regardless of the chosen math style:
313 \&\f(CW\*(C`\eupGamma\*(C'\fR, \f(CW\*(C`\eupalpha\*(C'\fR, \f(CW\*(C`\eitDelta\*(C'\fR, \f(CW\*(C`\eitbeta\*(C'\fR etc.
314 .PP
315 Note that this \f(CW\*(C`math\*(C'\fR option only affects digits, latin and greek letters,
316 plus a few basic punctuation characters; all other mathematical symbols,
317 operators, delimiters etc. are left as they were before.
318 If you don\*(Aqt want to use TeX\*(Aqs default versions of those symbols,
319 load another math package (such as \fImathdesign\fR or \fInewtxmath\fR)
320 before loading the \fBautoinst\fR\-generated style file.
321 .PP
322 Finally, note that \fBautoinst\fR doesn\*(Aqt check if your fonts actually contains
323 all of the required characters;
324 it just assumes that they do and sets up the style file accordingly.
325 Even if your fonts do contain greek, characters such as \f(CW\*(C`\evarepsilon\*(C'\fR
326 may be missing.
327 You may also find that some glyphs \fIare\fR present in your fonts,
328 but don\*(Aqt work well in equations or don\*(Aqt match other symbols;
329 edit the generated style file to remove the declarations of
330 these offending characters.
331 Once again: test the results before using them!
332 If the characters themselves are fine but spaced too tightly,
333 you may try increasing the side bearings in math fonts with
334 the \fI\-mathspacing\fR option (see below), e.g. \f(CW\*(C`\-mathspacing=50\*(C'\fR.
335 .SS "NFSS codes"
336 .IX Subsection "NFSS codes"
337 LaTeX\*(Aqs New Font Selection System (NFSS)
338 identifies fonts by a combination of family,
339 series (the concatenation of weight and width), shape and size.
340 \&\fBautoinst\fR parses the font\*(Aqs metadata to determine these parameters.
341 When this fails (usually because the font family contains uncommon weights,
342 widths or shapes),
343 \&\fBautoinst\fR ends up with multiple fonts having the same values
344 for these font parameters; such fonts cannot be used in NFSS,
345 since there\*(Aqs no way distinguish them.
346 When \fBautoinst\fR detects such a situation, it will print an error message
347 and abort.
348 If that happens, either rerun \fBautoinst\fR on a smaller set of fonts,
349 or add the missing widths, weights and shapes to the tables \f(CW@WIDTH\fR,
350 \&\f(CW@WEIGHT\fR and \f(CW%SHAPE\fR in the source code.
351 Please also send a bug report (see AUTHOR below).
352 .PP
353 The mapping of shapes to NFSS codes is done using the following table:
354 .PP
355 .Vb 5
356 \& SHAPE CODE
357 \& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-
358 \& Roman, Upright n
359 \& Italic it
360 \& Oblique, Slant(ed), Incline(d) sl
361 .Ve
362 .PP
363 (\fIException:\fR Adobe Silentium Pro contains two Roman shapes;
364 we map the first of these to \f(CW\*(C`n\*(C'\fR, for the second one we (ab)use the \f(CW\*(C`it\*(C'\fR code
365 as this family doesn\*(Aqt contain an Italic shape.)
366 .PP
367 For weights and widths, \fBautoinst\fR tries to the standard NFSS codes
368 (ul, el, l, sl, m, sb, b, eb and ub for weights;
369 uc, ec, c, sc, m, sx, x, ex and ux for widths)
370 as much as possible.
371 Of course, not all 81 combinations of these NFSS weights and widths will map
372 to existing fonts;
373 and conversely it may not be possible to assign every existing font
374 a unique code in a sane way (especially for the weights,
375 some font families offer more variants than NFSS\*(Aqs codes can handle;
376 e.g., Fira Sans contains fifteen different weights!).
377 Therefore every font is also assigned a "series" name that is
378 the concatenation of its weight and width,
379 after expanding any abbreviations and converting to lowercase.
380 A font of "Cond" width and "Ultra" weight will then be known
381 as "ultrablackcondensed".
382 .PP
383 The exact mapping between fonts and NFSS codes can be found
384 in the log file and in the generated \fIfd\fR files
385 (you may want to run \fBautoinst\fR with the \fI\-dryrun\fR option
386 to check the chosen mapping beforehand).
387 The \fI\-nfssweight\fR and \fI\-nfsswidth\fR command\-line options can be used
388 to finetune the mapping between NFSS codes and fonts.
389 .PP
390 To access specific weights or widths,
391 one can always use the \f(CW\*(C`\efontseries\*(C'\fR command with the full series name
392 (i.e., \f(CW\*(C`\efontseries{demibold}\eselectfont\*(C'\fR).
393 .PP
394 \&\fBautoinst\fR will print a message for each weight and width that
395 could not be mapped to a standard NFSS code.
396 .SS Ornaments
397 .IX Subsection "Ornaments"
398 \&\fBautoinst\fR provides a best\-effort interface to access ornament characters.
399 The OpenType specification offers two ways for fonts to implement ornaments:
400 one way is to map them to the lowercase ASCII letters, the other is
401 to define them as alternates for the "bullet" character.
402 Ornaments of the first type can be used from Latex without problem,
403 but ornaments implemented in the second way cannot easily be used from Latex
404 (at least not generically; it may be done by creating font\-specific encoding files).
405 .PP
406 Unfortunately, there is no way to tell which of these alternatives a font uses;
407 \&\fBautoinst\fR just assumes that the font maps ornaments to lowercase ASCII
408 and creates an OT1\-encoded font that hopefully contains the ornaments,
409 plus a \f(CW\*(C`\etextornament\*(C'\fR command to access them.
410 That command takes one argument: the slot number of the ornament.
411 E.g., to access the ornament at the position of "a" (hexadecimal 0x61),
412 use \f(CW\*(C`\etextornament{"61}\*(C'\fR.
413 .PP
414 To see which ornaments a font contains (and at which positions),
415 run LaTeX on the file \fInfssfont.tex\fR (which is included in any
416 standard LaTeX installation), supply the name of the ornament font
417 (i.e., \f(CW\*(C`Garamontio\-Regular\-orn\-u\*(C'\fR) and give the command \f(CW\*(C`\etable\ebye\*(C'\fR;
418 this will create a table of all glyphs in that font.
419 If this table shows no ornaments, your font unfortunately handles ornaments
420 in a non\-Latex\-compatible (or at least non\-\fBautoinst\fR\-compatible) way.
421 .PP
422 As a final caveat, note that even when your font does handle ornaments in
423 a Latex\-compatible way, it may very well map them to other characters
424 (such as digits or punctuation) instead of lowercase ASCII.
425 .SH "WARNINGS AND CAVEATS"
426 .IX Header "WARNINGS AND CAVEATS"
427 .SS "OpenType fonts and licensing issues"
428 .IX Subsection "OpenType fonts and licensing issues"
429 Since \fIpdfTeX\fR cannot subset otf\-flavoured OpenType fonts,
430 \&\fIotftotfm\fR will convert such fonts to Type1 (pfb) format.
431 However, many fonts (at least those licensed under the SIL Open Font License)
432 do not allow redistributing such converted versions under their original name.
433 .PP
434 In order to try to meet such licensing requirements, \fBautoinst\fR provides
435 a \fI\-t1suffix\fR command\-line option that appends a suffix to the names
436 (both the file name and the internal font name)
437 of all generated Type1 fonts; see "COMMAND\-LINE OPTIONS" below.
438 .PP
439 Please note that I am not a lawyer and do not guarantee that
440 this suffix is sufficient to meet the license\*(Aqs requirements.
441 When in doubt, consult a real lawyer!
442 .SS "Sorry, LIGTABLE too long for me to handle"
443 .IX Subsection "Sorry, LIGTABLE too long for me to handle"
444 The LIGTABLE in TeX\*(Aqs \fItfm\fR files, which contains a font\*(Aqs ligatures
445 and kerning pairs, is limited to about 32,500 entries (2^15 \- 256).
446 If the number of ligatures plus kerns in a font is higher than that limit,
447 \&\fIpltotf\fR and \fIvptovf\fR will complain loudly and ignore the excess entries.
448 This happens at least with Adobe\*(Aqs Source Serif 4 and Minion 3 font families.
449 Even when \fIpltotf\fR and \fIvptovf\fR don\*(Aqt warn about the LIGTABLE\*(Aqs size,
450 you may still find that \fIpdftex\fR crashes with a
451 \&\f(CW\*(C`Bad metric (TFM) file\*(C'\fR error.
452 The best way to handle this situation is to use \fBautoinst\fR\*(Aqs \f(CW\*(C`\-extra\*(C'\fR option
453 to raise \fIotftotfm\fR\*(Aqs value for the \f(CW\*(C`\-\-min\-kern\*(C'\fR parameter, which causes it
454 to ignore small kerning pairs: \f(CW\*(C`\-extra=\*(Aq\-\-min\-kern=6.0\*(Aq\*(C'\fR.
455 Finding a working value for the \f(CW\*(C`\-\-min\-kern\*(C'\fR parameter may require some
456 trial and error.
457 .SS "A note for MiKTeX users"
458 .IX Subsection "A note for MiKTeX users"
459 Automatically installing the fonts into a suitable TEXMF tree
460 (as \fBautoinst\fR tries to do by default) only works for TeX\-installations
461 that use the \fIkpathsea\fR library; with TeX distributions that implement
462 their own directory searching, such as MiKTeX, \fBautoinst\fR will complain
463 that it cannot find the \fIkpsewhich\fR program and move all generated files
464 into a subdirectory \f(CW\*(C`autoinst_output/\*(C'\fR of the current directory.
465 If you use such a TeX distribution, you should either move these files
466 to their correct destinations by hand, or use the \fI\-target\fR option
467 (see "COMMAND\-LINE OPTIONS" below) to manually specify a TEXMF tree.
468 .PP
469 Also, some OpenType fonts contain so many kerning pairs that the resulting
470 \&\fIpl\fR and \fIvpl\fR files are too big for MiKTeX\*(Aqs \fIpltotf\fR and \fIvptovf\fR;
471 the versions that come with W32TeX (\fIhttp://www.w32tex.org\fR)
472 and TeXLive (\fIhttp://tug.org/texlive\fR) don\*(Aqt seem to have this problem.
473 .SS "A note for MacTeX users"
474 .IX Subsection "A note for MacTeX users"
475 By default, \fBautoinst\fR will try to install all generated files into
476 the \f(CW$TEXMFLOCAL\fR tree; when this directory isn\*(Aqt user\-writable,
477 it will use the \f(CW$TEXMFHOME\fR tree instead. Unfortunately, MacTeX\*(Aqs version
478 of \f(CW\*(C`updmap\-sys\*(C'\fR doesn\*(Aqt search in \f(CW$TEXMFHOME\fR,
479 and hence MacTeX will not find the new fonts.
480 .PP
481 To remedy this, either run \fBautoinst\fR as root (so that it can install
482 everything into \f(CW$TEXMFLOCAL\fR) or manually run \f(CW\*(C`updmap \-user\*(C'\fR to tell
483 TeX about the files in \f(CW$TEXMFHOME\fR.
484 This latter option does, however, come with some caveats;
485 see \fIhttps://tug.org/texlive/scripts\-sys\-user.html\fR.
486 .SH "COMMAND\-LINE OPTIONS"
487 .IX Header "COMMAND-LINE OPTIONS"
488 \&\fBautoinst\fR tries hard to do The Right Thing (TM) by default,
489 so you usually won\*(Aqt need these options;
490 but most aspects of its operation can be fine\-tuned if you want to.
491 .PP
492 You may use either one or two dashes before options,
493 and option names may be shortened to a unique prefix
494 (e.g., \fB\-encoding\fR may be abbreviated to \fB\-enc\fR or even \fB\-en\fR,
495 but \fB\-e\fR is ambiguous (it may mean either \fB\-encoding\fR or \fB\-extra\fR)).
496 .SS "General options"
497 .IX Subsection "General options"
498 .IP \fB\-help\fR 4
499 .IX Item "-help"
500 Print a (relatively) short help text and exit.
501 .IP \fB\-dryrun\fR 4
502 .IX Item "-dryrun"
503 Don\*(Aqt generate output; just parse input fonts and write
504 the results to the log file.
505 .IP \fB\-verbose\fR 4
506 .IX Item "-verbose"
507 Add more details to the log file.
508 .IP \fB\-version\fR 4
509 .IX Item "-version"
510 Print \fBautoinst\fR\*(Aqs version number and exit.
511 .SS "Font creation options"
512 .IX Subsection "Font creation options"
513 .IP \fB\-encoding\fR=\fIencoding[,encoding]\fR 4
514 .IX Item "-encoding=encoding[,encoding]"
515 Generate the specified encoding(s) for the text fonts.
516 Multiple encodings may be specified as a comma\-separated list
517 (without spaces!); the default choice of encodings is \f(CW\*(C`OT1,LY1,T1\*(C'\fR.
518 .Sp
519 For each encoding argument, \fBautoinst\fR will first check if it is
520 the file name of an encoding file, and if found it will use that;
521 otherwise the argument is assumed to be the name of one of
522 the built\-in encodings.
523 If the argument is a file name,
524 \&\fBautoinst\fR will define the font with an NFSS encoding
525 equal to the file name (minus a ".enc" extension),
526 except when the file name starts with "U_";
527 in that case the NFSS encoding will be "U"
528 and the part after "U_" will be used as the "enc" part
529 of the name of the generated font.
530 .Sp
531 Currently \fBautoinst\fR comes with built\-in support for the OT1, T1/TS1, LY1,
532 T2A/B/C, T3/TS3, T4, T5, LGR, CS, L7X and QX encodings.
533 (The corresponding files are called \fIfontools_ot1.enc\fR etc.,
534 to avoid name clashes with other packages;
535 the \fIfontools_\fR prefix may be omitted.)
536 .IP \fB\-ts1\fR/\fB\-nots1\fR 4
537 .IX Item "-ts1/-nots1"
538 Control the creation of TS1\-encoded fonts. The default is \fB\-ts1\fR
539 if the text encodings (see \fI\-encoding\fR above) include T1,
540 \&\fB\-nots1\fR otherwise.
541 .IP \fB\-lining\fR/\fB\-nolining\fR 4
542 .IX Item "-lining/-nolining"
543 Control the creation of fonts with lining figures. The default is
544 \&\fB\-lining\fR.
545 .IP \fB\-oldstyle\fR/\fB\-nooldstyle\fR 4
546 .IX Item "-oldstyle/-nooldstyle"
547 Control the creation of fonts with oldstyle figures. The default is
548 \&\fB\-oldstyle\fR.
549 .IP \fB\-proportional\fR/\fB\-noproportional\fR 4
550 .IX Item "-proportional/-noproportional"
551 Control the creation of fonts with proportional figures. The default is
552 \&\fB\-proportional\fR.
553 .IP \fB\-tabular\fR/\fB\-notabular\fR 4
554 .IX Item "-tabular/-notabular"
555 Control the creation of fonts with tabular figures. The default is
556 \&\fB\-tabular\fR.
557 .IP \fB\-smallcaps\fR/\fB\-nosmallcaps\fR 4
558 .IX Item "-smallcaps/-nosmallcaps"
559 Control the creation of small caps fonts. The default is
560 \&\fB\-smallcaps\fR.
561 .IP \fB\-swash\fR/\fB\-noswash\fR 4
562 .IX Item "-swash/-noswash"
563 Control the creation of swash fonts. The default is \fB\-swash\fR.
564 .IP \fB\-titling\fR/\fB\-notitling\fR 4
565 .IX Item "-titling/-notitling"
566 Control the creation of titling families. The default is \fB\-titling\fR.
567 .IP \fB\-superiors\fR/\fB\-nosuperiors\fR 4
568 .IX Item "-superiors/-nosuperiors"
569 Control the creation of fonts with superior characters.
570 The default is \fB\-superiors\fR.
571 .IP "\fB\-inferiors\fR [ = \fBnone\fR | \fBauto\fR | \fBsubs\fR | \fBsinf\fR | \fBdnom\fR ]" 4
572 .IX Item "-inferiors [ = none | auto | subs | sinf | dnom ]"
573 .PD 0
574 .IP \fB\-noinferiors\fR 4
575 .IX Item "-noinferiors"
576 .PD
577 The OpenType standard defines several kinds of digits that might be used
578 as inferiors or subscripts: "Subscripts" (OpenType feature \f(CW\*(C`subs\*(C'\fR),
579 "Scientific Inferiors" (\f(CW\*(C`sinf\*(C'\fR), and "Denominators" (\f(CW\*(C`dnom\*(C'\fR).
580 This option allows the user to determine which of these styles \fBautoinst\fR
581 should use for the inferior characters.
582 Alternatively, the value "auto" tells \fBautoinst\fR to use the first value
583 in \f(CW\*(C`sinf\*(C'\fR, \f(CW\*(C`subs\*(C'\fR or \f(CW\*(C`dnom\*(C'\fR that is supported by the font.
584 Saying just \fB\-inferiors\fR is equivalent to \fB\-inferiors=auto\fR;
585 otherwise the default is \fB\-noinferiors\fR.
586 .Sp
587 \&\fIIf you specify a style of inferiors that isn\*(Aqt present in the font,
588 \&\fR\f(BIautoinst\fR\fI will fall back to its default behaviour of not creating fonts
589 with inferiors at all; it won\*(Aqt try to substitute one of the other styles.\fR
590 .IP \fB\-fractions\fR/\fB\-nofractions\fR 4
591 .IX Item "-fractions/-nofractions"
592 Control the creation of fonts with numerators and denominators.
593 The default is \fB\-nofractions\fR.
594 .IP \fB\-ligatures\fR/\fB\-noligatures\fR 4
595 .IX Item "-ligatures/-noligatures"
596 Some fonts contain glyphs for the standard f\-ligatures (ff, fi, fl, ffi, ffl),
597 but don\*(Aqt provide a \f(CW\*(C`liga\*(C'\fR feature to access these.
598 This option tells \fBautoinst\fR to add extra \f(CW\*(C`LIGKERN\*(C'\fR rules to
599 the generated fonts to enable the use of these ligatures.
600 The default is \fB\-ligatures\fR, except for typewriter fonts.
601 .Sp
602 Specify \fB\-noligatures\fR to disable generation of ligatures even for fonts
603 that do contain a \f(CW\*(C`liga\*(C'\fR feature.
604 .IP \fB\-ornaments\fR/\fB\-noornaments\fR 4
605 .IX Item "-ornaments/-noornaments"
606 Control the creation of ornament fonts. The default is \fB\-ornaments\fR.
607 .IP \fB\-serif\fR/\fB\-sanserif\fR/\fB\-typewriter\fR 4
608 .IX Item "-serif/-sanserif/-typewriter"
609 Install the font as a serif, sanserif or typewriter font, respectively.
610 This changes how you access the font in LaTeX:
611 with \f(CW\*(C`\ermfamily\*(C'\fR/\f(CW\*(C`\etextrm\*(C'\fR, \f(CW\*(C`\esffamily\*(C'\fR/\f(CW\*(C`\etextsf\*(C'\fR
612 or \f(CW\*(C`\ettfamily\*(C'\fR/\f(CW\*(C`\etexttt\*(C'\fR.
613 .Sp
614 Installing the font as a typewriter font will cause two further changes:
615 it will \- by default \- turn off the use of f\-ligatures
616 (though this can be overridden with the \fI\-ligatures\fR option),
617 and it will disable hyphenation for this font.
618 This latter effect cannot be re\-enabled in \fBautoinst\fR;
619 if you want typewriter text to be hyphenated, use the \fIhyphenat\fR package.
620 .Sp
621 If none of these options is specified, \fBautoinst\fR tries to guess:
622 if the font\*(Aqs file name contains the string "mono"
623 or if the field \f(CW\*(C`isFixedPitch\*(C'\fR in the font\*(Aqs \f(CW\*(C`post\*(C'\fR table is True,
624 it will select \fB\-typewriter\fR;
625 else if the file name contains "sans" it will select \fB\-sanserif\fR;
626 otherwise it will opt for \fB\-serif\fR.
627 .IP \fB\-math\fR 4
628 .IX Item "-math"
629 Tells \fBautoinst\fR to create basic math fonts (see above).
630 .IP \fB\-mathspacing\fR=\fIamount\fR 4
631 .IX Item "-mathspacing=amount"
632 Letterspace each character in the math fonts by \fIamount\fR units,
633 where 1000 units equal one em.
634 In my opinion, many text fonts benefit from letterspacing by 50 to 100 units
635 when used in maths; some fonts need even more. Use your own judgement!
636 .SS "Output options"
637 .IX Subsection "Output options"
638 .IP "\fB\-t1suffix\fR [ = \fISUFFIX\fR ]" 4
639 .IX Item "-t1suffix [ = SUFFIX ]"
640 Tell \fBautoinst\fR to modify the font names of all generated Type1\-fonts,
641 by adding \fISUFFIX\fR to the family name.
642 If you use this option without specifying a \fISUFFIX\fR value,
643 \&\fBautoinst\fR will use the value "PS".
644 The default behaviour when this option is not given
645 is to not modify font names at all.
646 .Sp
647 See also "OpenType fonts and licensing issues" in "WARNINGS AND CAVEATS" above.
648 .IP \fB\-target\fR=\fIDIRECTORY\fR 4
649 .IX Item "-target=DIRECTORY"
650 Install all generated files into the TEXMF tree at \fIDIRECTORY\fR.
651 .Sp
652 By default, \fBautoinst\fR searches the \f(CW$TEXMFLOCAL\fR and \f(CW$TEXMFHOME\fR trees
653 and installs all files into the first user\-writable TEXMF tree it finds.
654 If \fBautoinst\fR cannot find such a user\-writable directory
655 (which shouldn\*(Aqt happen, since \f(CW$TEXMFHOME\fR is supposed to be user\-writable)
656 it will print a warning message and put all files into the subdirectory
657 \&\f(CW\*(C`autoinst_output/\*(C'\fR of the current directory.
658 It\*(Aqs then up to the user to move the generated files to a better location
659 and update all relevant databases
660 (usually by calling \fItexhash\fR and \fIupdmap\fR).
661 .IP \fB\-vendor\fR=\fIVENDOR\fR 4
662 .IX Item "-vendor=VENDOR"
663 .PD 0
664 .IP \fB\-typeface\fR=\fITYPEFACE\fR 4
665 .IX Item "-typeface=TYPEFACE"
666 .PD
667 These options are equivalent to \fIotftotfm\fR\*(Aqs \fI \-\-vendor\fR and \fI \-\-typeface\fR
668 options: they change the "vendor" and "typeface" parts of the names of the
669 subdirectories in the TEXMF tree where generated files will be stored.
670 The default values are "lcdftools" and the font\*(Aqs FontFamily name.
671 These options change \fIonly\fR directory names,
672 not the names of any generated files.
673 .IP \fB\-logfile\fR=\fIfilename\fR 4
674 .IX Item "-logfile=filename"
675 Write log data to \fIfilename\fR instead of the default \fI<fontfamily>.log\fR.
676 If the file already exists, \fBautoinst\fR appends to it;
677 it doesn\*(Aqt overwrite an existing file.
678 .SS "Specialist options"
679 .IX Subsection "Specialist options"
680 .IP \fB\-defaultlining\fR/\fB\-defaultoldstyle\fR 4
681 .IX Item "-defaultlining/-defaultoldstyle"
682 .PD 0
683 .IP \fB\-defaulttabular\fR/\fB\-defaultproportional\fR 4
684 .IX Item "-defaulttabular/-defaultproportional"
685 .PD
686 Tell \fBautoinst\fR which figure style is the current font family\*(Aqs default
687 (i.e., which figures you get when you don\*(Aqt specify any OpenType features).
688 .Sp
689 \&\fIDon\*(Aqt use these options unless you are certain you need them!\fR
690 They are only needed for fonts that don\*(Aqt provide OpenType features
691 for their default figure style; and even in that case,
692 \&\fBautoinst\fR\*(Aqs default values (\fB\-defaultlining\fR and \fB\-defaulttabular\fR)
693 are usually correct.
694 .IP "\fB\-nfssweight\fR=""\fIcode\fR=\fIweight\fR""" 4
695 .IX Item "-nfssweight=""code=weight"""
696 .PD 0
697 .IP "\fB\-nfsswidth\fR=""\fIcode\fR=\fIwidth\fR""" 4
698 .IX Item "-nfsswidth=""code=width"""
699 .PD
700 Map the NFSS code \fIcode\fR to the given weight or width,
701 overriding the built\-in tables.
702 Each of these options may be given multiple times,
703 to override more than one NFSS code.
704 Example: to map the \f(CW\*(C`ul\*(C'\fR code to the "Thin" weight,
705 use \f(CW\*(C`\-nfssweight="ul=thin"\*(C'\fR.
706 To inhibit the use of the \f(CW\*(C`ul\*(C'\fR code completely,
707 use \f(CW\*(C`\-nfssweight="ul="\*(C'\fR.
708 .IP "\fB\-opticalsizes\fR=""\fIpattern\fR=\fImin\fR\-\fImax\fR [, \fIpattern\fR=\fImin\fR\-\fImax\fR ...]""" 4
709 .IX Item "-opticalsizes=""pattern=min-max [, pattern=min-max ...]"""
710 Manually set or override the fonts\*(Aq optical size information.
711 If a font\*(Aqs file name matches \fIpattern\fR, its optical size information
712 will be set to the range \fImin\fR\-\fImax\fR (both given in points).
713 The lower bound \fImin\fR is included in the range, the upper bound \fImax\fR isn\*(Aqt.
714 Empty values for \fImin\fR and \fImax\fR are interpreted as zero and infinity,
715 respectively.
716 Multiple optical size range specifications must be separated by commas.
717 .Sp
718 Example:
719 .Sp
720 .Vb 5
721 \& autoinst \e
722 \& \-opticalsizes="9pt=0\-25,72pt=25\-100,144pt=100\-" \e
723 \& Fraunces9pt\-Regular.otf \e
724 \& Fraunces72pt\-Regular.otf \e
725 \& Fraunces144pt\-Regular.otf
726 .Ve
727 .Sp
728 The \fIpattern\fR can be any string that is valid in file names
729 and LaTeX font names.
730 A default size range can be specified with an empty pattern:
731 .Sp
732 .Vb 1
733 \& \-opticalsize="Capt=\-8.4,=8.4\-13,Subh=13\-19.9,Disp=19.9\-"
734 .Ve
735 .Sp
736 Patterns are tested in descending order of pattern length
737 and the first match wins, though \fBautoinst\fR will warn if it finds
738 multiple matching patterns (except for the empty pattern).
739 .Sp
740 If a font\*(Aqs file name does not contain any of the given patterns,
741 the optical size data in the font\*(Aqs \f(CW\*(C`OS/2\*(C'\fR table (if any) will be used.
742 .Sp
743 \&\fBautoinst\fR will adjust size ranges so that there are no gaps;
744 e.g. a set of ranges 5\-7, 9\-14 and 18\-72 will be adjusted to
745 0\-7, 7\-14 and 14\-infinity. Empty or overlapping ranges are an error.
746 .Sp
747 In some font families, the optical size name is part of the family name;
748 e.g., Fraunces in fact consists of three separate families
749 "Fraunces 9pt", "Fraunces 72pt" and "Fraunces 144pt".
750 When given the \fI\-opticalsizes\fR option, \fBautoinst\fR will try to remove
751 the optical size names (i.e., \fIpattern\fR) from the family name,
752 so that all fonts will be installed as a single LaTeX family.
753 Note that Literata (and maybe other fonts as well) has file names
754 like "Literata_24pt\-Regular.ttf" but family names like "Literata 24pt";
755 in this case the \fIpattern\fR "24pt" will be removed from the family name,
756 but the \fIpattern\fR "_24pt" will not, since the underscore doesn\*(Aqt match.
757 .Sp
758 If the transition size between two fonts with design sizes \fIS\fR and \fIL\fR
759 is unknown, sqrt(\fIS\fR * \fIL\fR) might be a good starting value.
760 .IP "\fB\-extra\fR=\fIextra options\fR" 4
761 .IX Item "-extra=extra options"
762 Pass \fIextra options\fR to the commands for \fIotftotfm\fR.
763 To prevent \fIextra options\fR from accidentily being interpreted as
764 options to \fBautoinst\fR, they should be properly quoted.
765 .IP \fB\-manual\fR 4
766 .IX Item "-manual"
767 Manual mode; for users who want to post\-process the generated files
768 and commands. By default, \fBautoinst\fR immediately executes all
769 \&\fIotftotfm\fR commands it generates;
770 in manual mode, these are instead written to a file \fIautoinst.bat\fR.
771 Furthermore it tells \fIotftotfm\fR to generate human readable (and editable)
772 \&\fIpl/vpl\fR files instead of the default \fItfm/vf\fR ones,
773 and to place all generated files in a subdirectory \f(CW\*(C`./autoinst_output/\*(C'\fR
774 of the current directory, rather than install them into your TeX installation.
775 .Sp
776 When using this option, you need to execute the following manual steps after
777 \&\fBautoinst\fR has finished:
778 .RS 4
779 .IP "\- run \fIpltotf\fR and \fIvptovf\fR on the generated \fIpl\fR and \fIvf\fR files, to convert them to \fItfm/vf\fR format;" 2
780 .IX Item "- run pltotf and vptovf on the generated pl and vf files, to convert them to tfm/vf format;"
781 .PD 0
782 .IP "\- move all generated files to a proper TEXMF tree, and, if necessary, update the file name database;" 2
783 .IX Item "- move all generated files to a proper TEXMF tree, and, if necessary, update the file name database;"
784 .ie n .IP "\- tell TeX about the new \fImap\fR file (usually by running ""updmap"" or similar)." 2
785 .el .IP "\- tell TeX about the new \fImap\fR file (usually by running \f(CWupdmap\fR or similar)." 2
786 .IX Item "- tell TeX about the new map file (usually by running updmap or similar)."
787 .PD
788 .RE
789 .RS 4
790 .Sp
791 Note that some options (\fI\-target\fR, \fI\-vendor\fR and \fI\-typeface\fR)
792 are meaningless, and hence ignored, in manual mode.
793 .Sp
794 Also note that font name modification doesn\*(Aqt happen in manual mode.
795 .RE
796 .IP \fB\-nofigurekern\fR 4
797 .IX Item "-nofigurekern"
798 Some fonts provide kerning pairs for tabular figures.
799 This is very probably not what you want
800 (e.g., numbers in tables won\*(Aqt line up exactly).
801 This option adds extra \fI \-\-ligkern\fR options
802 to the commands for \fIotftotfm\fR to suppress such kerns.
803 Note that this option leads to very long commands (it adds
804 one hundred \fI \-\-ligkern\fR options), which may cause problems on some systems;
805 hence it is not active by default.
806 .SH "SEE ALSO"
807 .IX Header "SEE ALSO"
808 Eddie Kohler\*(Aqs \fBTypeTools\fR and \fBT1Utils\fR (\fIhttp://www.lcdf.org/type\fR).
809 .PP
810 \&\fBPerl\fR can be obtained from \fIhttp://www.perl.org\fR;
811 it is included in most Linux distributions.
812 For Windows, try ActivePerl (\fIhttp://www.activestate.com\fR)
813 or Strawberry Perl (\fIhttp://strawberryperl.com\fR).
814 .PP
815 \&\fBLuaTeX\fR (\fIhttp://www.luatex.org\fR) and
816 \&\fBXeTeX\fR (\fIhttp://www.tug.org/xetex\fR)
817 are Unicode\-aware TeX engines that can use OpenType fonts directly,
818 without any (La)TeX\-specific support files.
819 .PP
820 The \fBFontPro\fR project (\fIhttps://github.com/sebschub/FontPro\fR)
821 offers very complete LaTeX support (even for typesetting maths) for
822 Adobe\*(Aqs Minion Pro, Myriad Pro and Cronos Pro font families.
823 .SH AUTHOR
824 .IX Header "AUTHOR"
825 Marc Penninga (\[email protected]\fR)
826 .PP
827 When sending a bug report, please give as much relevant information as
828 possible; this usually includes (but may not be limited to) the log file
829 (please add the \fI\-verbose\fR command\-line option, for extra info).
830 If you see any error messages, please include these \fIverbatim\fR;
831 don\*(Aqt paraphase.
832 .SH COPYRIGHT
833 .IX Header "COPYRIGHT"
834 Copyright (C) 2005\-2026 Marc Penninga.
835 .SH LICENSE
836 .IX Header "LICENSE"
837 This program is free software; you can redistribute it and/or modify
838 it under the terms of the GNU General Public License as published
839 by the Free Software Foundation, either version 2 of the License,
840 or (at your option) any later version.
841 A copy of the text of the GNU General Public License is included in
842 the \fIfontools\fR distribution; see the file \fIGPLv2.txt\fR.
843 .SH DISCLAIMER
844 .IX Header "DISCLAIMER"
845 This program is distributed in the hope that it will be useful,
846 but WITHOUT ANY WARRANTY; without even the implied warranty of
847 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
848 GNU General Public License for more details.
849 .SH VERSION
850 .IX Header "VERSION"
851 This document describes \fBautoinst\fR version 20260422.
852 .SH "RECENT CHANGES"
853 .IX Header "RECENT CHANGES"
854 (See the source for the full story, all the way back to 2005.)
855 .IP \fI2026\-04\-22\fR 12
856 .IX Item "2026-04-22"
857 Several additions and bugfixes (reports and patches by Chris Spiel):
858 .RS 12
859 .ie n .IP "\- Added the ""\-opticalsizes"" option" 2
860 .el .IP "\- Added the \f(CW\-opticalsizes\fR option" 2
861 .IX Item "- Added the -opticalsizes option"
862 .PD 0
863 .IP "\- Log all weights and widths that could not be mapped to standard NFSS ""series"" codes" 2
864 .IX Item "- Log all weights and widths that could not be mapped to standard NFSS ""series"" codes"
865 .IP "\- Bugfix: font names starting with ""ITC"" would be parsed as ""italic""" 2
866 .IX Item "- Bugfix: font names starting with ""ITC"" would be parsed as ""italic"""
867 .PD
868 .RE
869 .RS 12
870 .RE
871 .IP \fI2026\-04\-01\fR 12
872 .IX Item "2026-04-01"
873 Added the "extlight" weight to the font info parsing
874 (reported by Chris Spiel).
875 .IP \fI2026\-02\-10\fR 12
876 .IX Item "2026-02-10"
877 Generated style files now use the \fIfigureversions\fR package
878 to access superior and inferior figures and fractions,
879 instead of the (deprecated) \fIfontaxes\fR package.
880 Added the \fIscriptscale\fR option to the generated style file.
881 When creating math fonts, we use the font\*(Aqs "mgrk" feature,
882 if present.
883 Fixed a few obscure bugs.
884 .IP \fI2025\-09\-09\fR 12
885 .IX Item "2025-09-09"
886 Use the font\*(Aqs WeightClass if its weight cannot be determined
887 from other metadata (suggested by Christoph L. Spiel).
888 .IP \fI2025\-08\-25\fR 12
889 .IX Item "2025-08-25"
890 Fixed a bug in the processing of the \f(CW\*(C`\-nfssweight\*(C'\fR and
891 \&\f(CW\*(C`\-nfsswidth\*(C'\fR options.
892 .IP \fI2025\-08\-19\fR 12
893 .IX Item "2025-08-19"
894 Fixed a bug where any fonts with the word "Typewriter"
895 in their name would be parsed as "Italic".
896 .IP \fI2025\-07\-02\fR 12
897 .IX Item "2025-07-02"
898 The hack in font metadata parsing for Source Serif 4
899 (See 2025\-01\-07) is also needed for other fonts;
900 at least for Arno Pro, maybe some other Adobe fonts as well.
901 So we changed the test again: we apply this hack by default,
902 except for Libertinus.
903 .IP \fI2025\-06\-23\fR 12
904 .IX Item "2025-06-23"
905 Introduced the "U_" rule for encoding file names.
906 .IP \fI2025\-04\-16\fR 12
907 .IX Item "2025-04-16"
908 Don\*(Aqt load the \fImweights\fR package, as its functionality
909 is now part of the LaTeX kernel
910 (and, in fact, has been for a while ...).
911 .IP \fI2025\-01\-07\fR 12
912 .IX Item "2025-01-07"
913 The \*(Aqfix\*(Aq in font metadata parsing that we introduced
914 for Source Serif 4 was biting Libertinus Serif Display
915 (and maybe other fonts as well),
916 so we now test if the family is actually Source Serif 4
917 before applying that fix.