From 74a9e96c08d231fdf6d6cc49aafc4ac75ff0f621 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 26 Jun 2019 20:41:25 +0000 Subject: fontools (26jun19) git-svn-id: svn://tug.org/texlive/trunk@51473 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/autoinst.1 | 241 ++++++++++++++++++------------ 1 file changed, 143 insertions(+), 98 deletions(-) (limited to 'Master/texmf-dist/doc/man/man1/autoinst.1') diff --git a/Master/texmf-dist/doc/man/man1/autoinst.1 b/Master/texmf-dist/doc/man/man1/autoinst.1 index 2ecb719256c..99672c1023b 100644 --- a/Master/texmf-dist/doc/man/man1/autoinst.1 +++ b/Master/texmf-dist/doc/man/man1/autoinst.1 @@ -133,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "AUTOINST 1" -.TH AUTOINST 1 "2019-05-22" "fontools" "Marc Penninga" +.TH AUTOINST 1 "2019-06-25" "fontools" "Marc Penninga" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -158,8 +158,9 @@ Given a family of font files (in \fIotf\fR or \fIttf\fR format), \&\fBautoinst\fR will create several LaTeX font families: .RS 2 .IP "\-" 3 -Four text families (with lining and oldstyle digits, each in both tabular -and proportional variants), all with the following shapes: +Four text families (with lining and oldstyle digits, +each in both tabular and proportional variants), +all with the following shapes: .RS 3 .RS 2 .IP "\fIn\fR" 8 @@ -187,13 +188,14 @@ Swash .RS 3 .RE .IP "\-" 3 -For each T1\-encoded text family: a family of TS1\-encoded symbol fonts, -in roman, italic and slanted shapes. +For each T1\-encoded text family: +a family of TS1\-encoded symbol fonts, in roman, italic and slanted shapes. .IP "\-" 3 Families with superiors, inferiors, numerators and denominators, in roman, italic and slanted shapes. .IP "\-" 3 -Families with \*(L"Titling\*(R" characters; these \*(L"... replace the default glyphs +Families with \*(L"Titling\*(R" characters; +these \*(L"... replace the default glyphs with corresponding forms designed specifically for titling. These may be all-capital and/or larger on the body, and adjusted for viewing at larger sizes\*(R" @@ -258,14 +260,14 @@ but this choice can be overridden by the user; see the \fI\-logfile\fR command-line option in \*(L"COMMAND-LINE \s-1OPTIONS\*(R"\s0 below. If this log file already exists, \fBautoinst\fR will append its data to the end rather than overwrite it. -Use the \fI\-Verbose\fR command-line option to ask for more detailed info. +Use the \fI\-verbose\fR command-line option to ask for more detailed info. .SS "A note for MiKTeX users" .IX Subsection "A note for MiKTeX users" Automatically installing the fonts into a suitable \s-1TEXMF\s0 tree -(as \fBautoinst\fR tries to do by default) only works for TeX-installations that use -the \fIkpathsea\fR library; with TeX distributions that implement their -own directory searching (such as MiKTeX), \fBautoinst\fR will complain that -it cannot find the \fIkpsewhich\fR program and move all generated files +(as \fBautoinst\fR tries to do by default) only works for TeX-installations +that use the \fIkpathsea\fR library; with TeX distributions that implement +their own directory searching (such as MiKTeX), \fBautoinst\fR will complain +that it cannot find the \fIkpsewhich\fR program and move all generated files into a subdirectory \f(CW\*(C`./autoinst_output/\*(C'\fR of the current directory. If you use such a TeX distribution, you should either move these files to their correct destinations by hand, or use the \fI\-target\fR option @@ -277,11 +279,11 @@ the versions that come with W32TeX (\fIhttp://www.w32tex.org\fR) and TeXLive (\fIhttp://tug.org/texlive\fR) don't seem to have this problem. .SS "A note for MacTeX users" .IX Subsection "A note for MacTeX users" -By default, \fBautoinst\fR will try to install all files into the \f(CW$TEXMFLOCAL\fR tree; -when this directory isn't user-writable, it will use the \f(CW$TEXMFHOME\fR tree instead. -Unfortunately, MacTeX's version of \f(CW\*(C`updmap\-sys\*(C'\fR -(which is called behind the scenes) doesn't search in \f(CW$TEXMFHOME\fR, -and hence MacTeX will not find the new fonts. +By default, \fBautoinst\fR will try to install all generated files into +the \f(CW$TEXMFLOCAL\fR tree; when this directory isn't user-writable, +it will use the \f(CW$TEXMFHOME\fR tree instead. Unfortunately, MacTeX's version +of \f(CW\*(C`updmap\-sys\*(C'\fR (which is called behind the scenes) doesn't search +in \f(CW$TEXMFHOME\fR, and hence MacTeX will not find the new fonts. .PP To remedy this, either run \fBautoinst\fR as root (so that it can install everything into \f(CW$TEXMFLOCAL\fR) or manually run \f(CW\*(C`updmap \-user\*(C'\fR to tell @@ -291,8 +293,8 @@ see \fIhttps://tug.org/texlive/scripts\-sys\-user.html\fR. .SS "Using the fonts in your LaTeX documents" .IX Subsection "Using the fonts in your LaTeX documents" \&\fBautoinst\fR generates a style file for using the fonts in LaTeX documents, -named \fI.sty\fR. This style file also takes care of loading the -\&\fIfontenc\fR and \fItextcomp\fR packages. +named \fI.sty\fR. This style file also takes care of loading +the \fIfontenc\fR and \fItextcomp\fR packages. To use the fonts, add the command \f(CW\*(C`\eusepackage{\f(CI\f(CW}\*(C'\fR to the preamble of your document. .PP @@ -335,7 +337,7 @@ The previous two groups of options will only work if you have the \fImweights\fR package installed. .PP The style file will also try to load the \fIfontaxes\fR package -(available on \s-1CTAN\s0), which gives easy access to various font shapes and styles. +(on \s-1CTAN\s0), which gives easy access to various font shapes and styles. Using the machinery set up by \fIfontaxes\fR, the generated style file defines a number of commands (which take the text to be typeset as argument) and declarations (which don't take arguments, but affect all text up to @@ -351,8 +353,8 @@ characters: .Ve .PP In addition, the \f(CW\*(C`\eswshape\*(C'\fR and \f(CW\*(C`\etextsw\*(C'\fR commands are redefined to place -swash on \fIfontaxes\fR' secondary shape axis (\fIfontaxes\fR places it on the primary -shape axis) to make them behave properly when nested, so that +swash on \fIfontaxes\fR' secondary shape axis (\fIfontaxes\fR places it on the +primary shape axis) to make them behave properly when nested, so that \&\f(CW\*(C`\eswshape\eupshape\*(C'\fR will give upright swash. .PP There are no commands for accessing the numerator and denominator @@ -369,8 +371,8 @@ LaTeX installation) and supplying the name of the ornament font. To access ornament glyphs, \fBautoinst\fR creates a font-specific encoding file \&\fI_orn.enc\fR, but only if that file doesn't yet exist in the current directory. -This is a deliberate feature that allows you to provide your own -encoding vector, e.g. if your fonts use non-standard glyph names for ornaments. +This is a deliberate feature that allows you to provide your own encoding +vector, e.g. if your fonts use non-standard glyph names for ornaments. .PP These commands are only generated for existing shapes and number styles; no commands are generated for shapes and styles that don't exist, @@ -434,7 +436,7 @@ uc, ec, c, sc, m, sx, x, ex and ux for widths) to actual fonts. Of course, not all 81 combinations of these \s-1NFSS\s0 weights and widths will map to existing fonts; and conversely it may not be possible to assign every existing font -a unique code in a sane way (especially on the weight axis, some font families +a unique code in a sane way (especially for the weights, some font families offer more choices or finer granularity than \s-1NFSS\s0's codes can handle; e.g., Fira Sans contains fifteen(!) different weights, including an additional \*(L"Medium\*(R" weight between Regular and Semibold). @@ -477,8 +479,8 @@ a log file saying what \fBautoinst\fR would have done. Write log data to \fIfilename\fR instead of the default \fI.log\fR. If the file already exists, \fBautoinst\fR appends to it; it doesn't overwrite an existing file. -.IP "\fB\-Verbose\fR (\fInote:\fR uppercase 'V'!)" 4 -.IX Item "-Verbose (note: uppercase 'V'!)" +.IP "\fB\-verbose\fR" 4 +.IX Item "-verbose" Add more details to the log file. Repeat this option for even more info. .IP "\fB\-encoding\fR=\fIencoding[,encoding]\fR" 4 .IX Item "-encoding=encoding[,encoding]" @@ -491,16 +493,16 @@ so the \fIlast\fR one will become the default text encoding of your document. The default choice of encodings is \*(L"\s-1OT1,T1,LY1\*(R".\s0 For each encoding, a file \fI.enc\fR (in all \fIlowercase\fR!) should be somewhere where \fIotftotfm\fR can find it. Suitable encoding files -for \s-1OT1, T1/TS1, LY1, LGR\s0 and T2A/B/C come with \fBautoinst\fR. (These files are -called \fIfontools_ot1.enc\fR etc. to avoid name clashes with other packages; -the \*(L"fontools_\*(R" prefix may be omitted.) -.IP "\fB\-ts1\fR / \fB\-nots1\fR" 4 -.IX Item "-ts1 / -nots1" +for \s-1OT1, T1/TS1, LY1, LGR, T2A/B/C\s0 and T3/TS3 come with \fBautoinst\fR. +(These files are called \fIfontools_ot1.enc\fR etc. to avoid name clashes +with other packages; the \*(L"fontools_\*(R" prefix may be omitted.) +.IP "\fB\-ts1\fR/\fB\-nots1\fR" 4 +.IX Item "-ts1/-nots1" Control the creation of TS1\-encoded fonts. The default is \fB\-ts1\fR if the text encodings (see \fI\-encoding\fR above) include T1, \&\fB\-nots1\fR otherwise. -.IP "\fB\-serif\fR / \fB\-sanserif\fR / \fB\-typewriter\fR" 4 -.IX Item "-serif / -sanserif / -typewriter" +.IP "\fB\-serif\fR/\fB\-sanserif\fR/\fB\-typewriter\fR" 4 +.IX Item "-serif/-sanserif/-typewriter" Install the font as a serif, sanserif or typewriter font, respectively. This changes how you access the font in LaTeX: 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 @@ -512,38 +514,49 @@ it will \- by default \- turn off the use of f\-ligatures and it will disable hyphenation for this font. This latter effect cannot be disabled in \fBautoinst\fR; if you want typewriter text to be hyphenated, use the \fIhyphenat\fR package. -.IP "\fB\-lining\fR / \fB\-nolining\fR" 4 -.IX Item "-lining / -nolining" +.Sp +If none of these options is specified, \fBautoinst\fR tries to guess: +if the font's filename contains the string \*(L"mono\*(R" +or if the field \f(CW\*(C`isFixedPitch\*(C'\fR in the font's \fIpost\fR table is True, +it will select \fB\-typewriter\fR; +else if the filename contains \*(L"sans\*(R" it selects \fB\-sanserif\fR; +and otherwise it will opt for \fB\-serif\fR. +.IP "\fB\-lining\fR/\fB\-nolining\fR" 4 +.IX Item "-lining/-nolining" Control the creation of fonts with lining figures. The default is \&\fB\-lining\fR. -.IP "\fB\-oldstyle\fR / \fB\-nooldstyle\fR" 4 -.IX Item "-oldstyle / -nooldstyle" +.IP "\fB\-oldstyle\fR/\fB\-nooldstyle\fR" 4 +.IX Item "-oldstyle/-nooldstyle" Control the creation of fonts with oldstyle figures. The default is \&\fB\-oldstyle\fR. -.IP "\fB\-proportional\fR / \fB\-noproportional\fR" 4 -.IX Item "-proportional / -noproportional" +.IP "\fB\-proportional\fR/\fB\-noproportional\fR" 4 +.IX Item "-proportional/-noproportional" Control the creation of fonts with proportional figures. The default is \&\fB\-proportional\fR. -.IP "\fB\-tabular\fR / \fB\-notabular\fR" 4 -.IX Item "-tabular / -notabular" +.IP "\fB\-tabular\fR/\fB\-notabular\fR" 4 +.IX Item "-tabular/-notabular" Control the creation of fonts with tabular figures. The default is \&\fB\-tabular\fR. -.IP "\fB\-smallcaps\fR / \fB\-nosmallcaps\fR" 4 -.IX Item "-smallcaps / -nosmallcaps" +.IP "\fB\-smallcaps\fR/\fB\-nosmallcaps\fR" 4 +.IX Item "-smallcaps/-nosmallcaps" Control the creation of small caps fonts. The default is \&\fB\-smallcaps\fR. -.IP "\fB\-swash\fR / \fB\-noswash\fR" 4 -.IX Item "-swash / -noswash" +.IP "\fB\-swash\fR/\fB\-noswash\fR" 4 +.IX Item "-swash/-noswash" Control the creation of swash fonts. The default is \fB\-swash\fR. -.IP "\fB\-titling\fR / \fB\-notitling\fR" 4 -.IX Item "-titling / -notitling" +.IP "\fB\-titling\fR/\fB\-notitling\fR" 4 +.IX Item "-titling/-notitling" Control the creation of titling families. The default is \fB\-titling\fR. -.IP "\fB\-superiors\fR / \fB\-nosuperiors\fR" 4 -.IX Item "-superiors / -nosuperiors" +.IP "\fB\-superiors\fR/\fB\-nosuperiors\fR" 4 +.IX Item "-superiors/-nosuperiors" Control the creation of fonts with superior characters. The default is \fB\-superiors\fR. -.IP "\fB\-inferiors\fR=[ \fBnone\fR | \fBauto\fR | \fBsubs\fR | \fBsinf\fR | \fBdnom\fR ]" 4 -.IX Item "-inferiors=[ none | auto | subs | sinf | dnom ]" +.IP "\fB\-noinferiors\fR" 4 +.IX Item "-noinferiors" +.PD 0 +.IP "\fB\-inferiors\fR [= \fBnone\fR | \fBauto\fR | \fBsubs\fR | \fBsinf\fR | \fBdnom\fR ]" 4 +.IX Item "-inferiors [= none | auto | subs | sinf | dnom ]" +.PD The OpenType standard defines several kinds of digits that might be used as inferiors or subscripts: \*(L"Subscripts\*(R" (OpenType feature \*(L"subs\*(R"), \&\*(L"Scientific Inferiors\*(R" (\*(L"sinf\*(R"), and \*(L"Denominators\*(R" (\*(L"dnom\*(R"). @@ -551,30 +564,32 @@ This option allows the user to determine which of these styles \fBautoinst\fR should use for the inferior characters. Alternatively, the value \*(L"auto\*(R" tells \fBautoinst\fR to use the first value in \*(L"subs\*(R", \*(L"sinf\*(R" or \*(L"dnom\*(R" that is supported by the font. -The default value is \*(L"none\*(R". +Saying just \fB\-inferiors\fR is equivalent to \fB\-inferiors=auto\fR; +otherwise the default is \fB\-noinferiors\fR. .Sp \&\fIIf you specify a style of inferiors that isn't present in the font, \&\f(BIautoinst\fI will fall back to its default behaviour of not creating fonts with inferiors at all; it won't try to substitute one of the other styles.\fR -.IP "\fB\-fractions\fR / \fB\-nofractions\fR" 4 -.IX Item "-fractions / -nofractions" +.IP "\fB\-fractions\fR/\fB\-nofractions\fR" 4 +.IX Item "-fractions/-nofractions" Control the creation of fonts with numerators and denominators. The default is \fB\-nofractions\fR. -.IP "\fB\-ligatures\fR / \fB\-noligatures\fR" 4 -.IX Item "-ligatures / -noligatures" +.IP "\fB\-ligatures\fR/\fB\-noligatures\fR" 4 +.IX Item "-ligatures/-noligatures" Some fonts create glyphs for the standard f\-ligatures (ff, fi, fl, ffi, ffl), but don't provide a \*(L"liga\*(R" feature to access these. This option tells \fBautoinst\fR to add extra \f(CW\*(C`LIGKERN\*(C'\fR rules to the generated fonts to enable the use of these ligatures. -The default is \fB\-ligatures\fR, unless the user specified the \fIligatures\fR option. +The default is \fB\-ligatures\fR, +unless the user specified the \fIligatures\fR option. .Sp Specify \fB\-noligatures\fR to disable the generation of ligatures even for fonts that do contain a \*(L"liga\*(R" feature. -.IP "\fB\-defaultlining\fR / \fB\-defaultoldstyle\fR" 4 -.IX Item "-defaultlining / -defaultoldstyle" +.IP "\fB\-defaultlining\fR/\fB\-defaultoldstyle\fR" 4 +.IX Item "-defaultlining/-defaultoldstyle" .PD 0 -.IP "\fB\-defaulttabular\fR / \fB\-defaultproportional\fR" 4 -.IX Item "-defaulttabular / -defaultproportional" +.IP "\fB\-defaulttabular\fR/\fB\-defaultproportional\fR" 4 +.IX Item "-defaulttabular/-defaultproportional" .PD Tell \fBautoinst\fR which figure style is the current font family's default (i.e., which figures you get when you don't specify any OpenType features). @@ -593,38 +608,36 @@ This option adds extra \fI \-\-ligkern\fR options to the commands for \fIotftotfm\fR to suppress such kerns. Note that this option leads to very long commands (it adds one hundred \fI \-\-ligkern\fR options), which may cause problems on some systems. -.IP "\fB\-mergewidths\fR / \fB\-nomergewidths\fR" 4 -.IX Item "-mergewidths / -nomergewidths" -Some font families put their Condensed, Narrow, Extended etc. widths -in separate families; -this option tells \fBautoinst\fR to merge those separate families into -the main family. -The default is \fB\-mergewidths\fR. -.IP "\fB\-mergesmallcaps\fR / \fB\-nomergesmallcaps\fR" 4 -.IX Item "-mergesmallcaps / -nomergesmallcaps" -Even more annoyingly, some font families put their small caps fonts -in a separate family; -this option tells \fBautoinst\fR to merge the small caps fonts into +.IP "\fB\-mergewidths\fR/\fB\-nomergewidths\fR, \fB\-mergeweights\fR/\fB\-nomergeweights\fR, \fB\-mergeshapes\fR/\fB\-nomergeshapes\fR" 4 +.IX Item "-mergewidths/-nomergewidths, -mergeweights/-nomergeweights, -mergeshapes/-nomergeshapes" +Some font put different widths, weights or shapes (e.g., small caps) +in separate families. +These options tell \fBautoinst\fR to merge those separate families into the main family. -The default is \fB\-mergesmallcaps\fR. +Since this is usually desirable, they are all enabled by default. +.Sp +In earlier versions, \fB\-mergeshapes\fR was called \fB\-mergesmallcaps\fR; +for reasons of backward compatibility, that option is still supported. .IP "\fB\-nfssweight\fR=\fIcode\fR=\fIweight\fR, \fB\-nfsswidth\fR=\fIcode\fR=\fIwidth\fR" 4 .IX Item "-nfssweight=code=weight, -nfsswidth=code=width" Map the \s-1NFSS\s0 code \fIcode\fR to the given weight or width, overriding the built-in tables. Each of these options may be given multiple times, to override more than one \s-1NFSS\s0 code. -Example: to map the \*(L"ul\*(R" code to the \*(L"Thin\*(R" weight, use \f(CW\*(C`\-nfssweight=ul=thin\*(C'\fR. -To inhibit the use of the \*(L"ul\*(R" code completely, use \f(CW\*(C`\-nfssweight=ul=\*(C'\fR. +Example: to map the \*(L"ul\*(R" code to the \*(L"Thin\*(R" weight, +use \f(CW\*(C`\-nfssweight=ul=thin\*(C'\fR. +To inhibit the use of the \*(L"ul\*(R" code completely, +use \f(CW\*(C`\-nfssweight=ul=\*(C'\fR. .IP "\fB\-extra\fR=\fItext\fR" 4 .IX Item "-extra=text" Append \fItext\fR as extra options to the command lines for \fIotftotfm\fR. -To prevent \fItext\fR from accidentily being interpreted as options to \fBautoinst\fR, -it should be properly quoted. +To prevent \fItext\fR from accidentily being interpreted as options +to \fBautoinst\fR, it should be properly quoted. .IP "\fB\-manual\fR" 4 .IX Item "-manual" -Manual mode; for users who want to post-process the generated files and commands. -By default, \fBautoinst\fR immediately executes all \fIotftotfm\fR commands -it generates; +Manual mode; for users who want to post-process the generated files +and commands. By default, \fBautoinst\fR immediately executes all +\&\fIotftotfm\fR commands it generates; in manual mode, these are instead written to a file \fIautoinst.bat\fR. Furthermore it tells \fIotftotfm\fR to generate human readable (and editable) \&\fIpl/vpl\fR files instead of the default \fItfm/vf\fR ones, @@ -634,20 +647,20 @@ of the current directory, rather than install them into your TeX installation. When using this option, you need to execute the following manual steps after \&\fBautoinst\fR has finished: .RS 4 -.IP "\fB\-\fR run \fIpltotf\fR and \fIvptovf\fR on the generated \fIpl\fR and \fIvf\fR files, to convert them to \fItfm/vf\fR format;" 2 +.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 .IX Item "- run pltotf and vptovf on the generated pl and vf files, to convert them to tfm/vf format;" .PD 0 -.IP "\fB\-\fR move all generated files to a proper \s-1TEXMF\s0 tree, and, if necessary, update the filename database;" 2 +.IP "\- move all generated files to a proper \s-1TEXMF\s0 tree, and, if necessary, update the filename database;" 2 .IX Item "- move all generated files to a proper TEXMF tree, and, if necessary, update the filename database;" -.ie n .IP "\fB\-\fR tell TeX about the new \fImap\fR file (usually by running ""updmap"" or similar)." 2 -.el .IP "\fB\-\fR tell TeX about the new \fImap\fR file (usually by running \f(CWupdmap\fR or similar)." 2 +.ie n .IP "\- tell TeX about the new \fImap\fR file (usually by running ""updmap"" or similar)." 2 +.el .IP "\- tell TeX about the new \fImap\fR file (usually by running \f(CWupdmap\fR or similar)." 2 .IX Item "- tell TeX about the new map file (usually by running updmap or similar)." .RE .RS 4 .PD .Sp -Note that some options (\fI\-target\fR, \fI\-vendor\fR and \fI\-typeface\fR, \fI\-[no]updmap\fR) -are meaningless, and hence ignored, in manual mode. +Note that some options (\fI\-target\fR, \fI\-vendor\fR and \fI\-typeface\fR, +\&\fI\-[no]updmap\fR) are meaningless, and hence ignored, in manual mode. .RE .IP "\fB\-target\fR=\fI\s-1DIRECTORY\s0\fR" 4 .IX Item "-target=DIRECTORY" @@ -660,7 +673,8 @@ If \fBautoinst\fR cannot find such a user-writable directory it will print a warning message and put all files into the subdirectory \&\f(CW\*(C`./autoinst_output/\*(C'\fR of the current directory. It's then up to the user to move the generated files to a better location -and update all relevant databases (usually by calling \fItexhash\fR and \fIupdmap\fR). +and update all relevant databases +(usually by calling \fItexhash\fR and \fIupdmap\fR). .IP "\fB\-vendor\fR=\fI\s-1VENDOR\s0\fR" 4 .IX Item "-vendor=VENDOR" .PD 0 @@ -674,8 +688,8 @@ The default values are \*(L"lcdftools\*(R" and the font's FontFamily name. .Sp Note that these options change \fIonly\fR directory names, not the names of any generated files. -.IP "\fB\-updmap\fR / \fB\-noupdmap\fR" 4 -.IX Item "-updmap / -noupdmap" +.IP "\fB\-updmap\fR/\fB\-noupdmap\fR" 4 +.IX Item "-updmap/-noupdmap" Control whether or not \fIupdmap\fR is called after the last call to \fIotftotfm\fR. The default is \fB\-updmap\fR. .SH "SEE ALSO" @@ -687,20 +701,21 @@ it is included in most Linux distributions. For Windows, try ActivePerl (\fIhttp://www.activestate.com\fR) or Strawberry Perl (\fIhttp://strawberryperl.com\fR). .PP -\&\fBXeTeX\fR (\fIhttp://www.tug.org/xetex\fR) and \fBLuaTeX\fR (\fIhttp://www.luatex.org\fR) +\&\fBXeTeX\fR (\fIhttp://www.tug.org/xetex\fR) and +\&\fBLuaTeX\fR (\fIhttp://www.luatex.org\fR) are Unicode-aware TeX engines that can use OpenType fonts directly, without any (La)TeX\-specific support files. .PP The \fBFontPro\fR project (\fIhttps://github.com/sebschub/FontPro\fR) -offers very complete LaTeX support (even for typesetting maths) for Adobe's -Minion Pro, Myriad Pro and Cronos Pro font families. +offers very complete LaTeX support (even for typesetting maths) for +Adobe's Minion Pro, Myriad Pro and Cronos Pro font families. .SH "AUTHOR" .IX Header "AUTHOR" Marc Penninga (\fImarcpenninga@gmail.com\fR) .PP -When sending a bug report, please give as much relevant information as possible; -this usually includes (but may not be limited to) the log file -(please add the \fI\-Verbose\fR command-line option, for extra info). +When sending a bug report, please give as much relevant information as +possible; this usually includes (but may not be limited to) the log file +(please add the \fI\-verbose\fR command-line option, for extra info). If you see any error messages, please include these \fIverbatim\fR; don't paraphase. .SH "COPYRIGHT" @@ -722,16 +737,46 @@ but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of \&\s-1GNU\s0 General Public License for more details. .SH "VERSION" .IX Header "VERSION" -This document describes \fBautoinst\fR version 20190522. +This document describes \fBautoinst\fR version 20190625. .SH "RECENT CHANGES" .IX Header "RECENT CHANGES" (See the source for the full story, all the way back to 2005.) +.IP "\fI2019\-06\-25\fR" 12 +.IX Item "2019-06-25" +.RS 12 +.PD 0 +.IP "\-" 3 +.PD +Added the \fI\-mergeweights\fR and \fI\-mergeshapes\fR options, +and improved \fI\-mergewidths\fR. +.IP "\-" 3 +Improved the parsing of fonts' widths and weights. +.IP "\-" 3 +Improved the mapping of widths and weights to \s-1NFSS\s0 codes. +.IP "\-" 3 +Changed logging code so that that results of font info parsing +are always logged, even (especially!) when parsing fails. +.IP "\-" 3 +Added a warning when installing fonts from multiple families. +.IP "\-" 3 +Added simple recognition for sanserif and typewriter fonts. +.IP "\-" 3 +Fixed error checking after calls to \fIotfinfo\fR +(\fBautoinst\fR previously only checked whether \f(CW\*(C`fork()\*(C'\fR was successful, +not whether the actual call to \fIotfinfo\fR worked). +.IP "\-" 3 +Fixed a bug in the \fI\-inferiors\fR option; +when used without a (supposedly optional) value, +it would silently gobble the next option instead. +.RE +.RS 12 +.RE .IP "\fI2019\-05\-22\fR" 12 .IX Item "2019-05-22" Added the \fImainfont\fR option to the generated \fIsty\fR files. Prevented hyphenation for typewriter fonts (added \f(CW\*(C`\ehyphenchar\efont=\-1\*(C'\fR to the \f(CW\*(C`\eDeclareFontFamily\*(C'\fR declarations). -Added the \fI\-version\fR option, and renamed \fI\-verbose\fR to \fI\-Verbose\fR. +Added the \fI\-version\fR option. .IP "\fI2019\-05\-17\fR" 12 .IX Item "2019-05-17" Changed the way the \fI\-ligatures\fR option works: -- cgit v1.2.3