1AUTOINST(1)                      Marc Penninga                     AUTOINST(1)
2
3
4

NAME

6       autoinst - wrapper around the LCDF TypeTools, for installing and using
7       OpenType fonts in LaTeX.
8

SYNOPSIS

10       autoinst -help
11
12       autoinst [options] font(s)
13

DESCRIPTION

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

WARNINGS AND CAVEATS

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

COMMAND-LINE OPTIONS

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

SEE ALSO

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

AUTHOR

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

LICENSE

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

DISCLAIMER

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

VERSION

626       This document describes autoinst version 20230201.
627

RECENT CHANGES

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)
Impressum