From 0d4ebcae733ad439678cb7e424e1be31529ba363 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 27 May 2020 21:40:38 +0000 Subject: fontools (27may20) git-svn-id: svn://tug.org/texlive/trunk@55297 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/afm2afm.1 | 4 +- Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf | Bin 26658 -> 26712 bytes Master/texmf-dist/doc/man/man1/autoinst.1 | 300 ++++++++++++++--------- Master/texmf-dist/doc/man/man1/autoinst.man1.pdf | Bin 70590 -> 73462 bytes Master/texmf-dist/doc/man/man1/ot2kpx.1 | 4 +- Master/texmf-dist/doc/man/man1/ot2kpx.man1.pdf | Bin 26952 -> 27005 bytes 6 files changed, 187 insertions(+), 121 deletions(-) (limited to 'Master/texmf-dist/doc/man/man1') diff --git a/Master/texmf-dist/doc/man/man1/afm2afm.1 b/Master/texmf-dist/doc/man/man1/afm2afm.1 index 66decb7cd5d..6373339ff28 100644 --- a/Master/texmf-dist/doc/man/man1/afm2afm.1 +++ b/Master/texmf-dist/doc/man/man1/afm2afm.1 @@ -133,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "AFM2AFM 1" -.TH AFM2AFM 1 "2020-05-11" "fontools" "Marc Penninga" +.TH AFM2AFM 1 "2020-05-27" "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 @@ -223,7 +223,7 @@ but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of See the \s-1GNU\s0 General Public License for more details. .SH "VERSION" .IX Header "VERSION" -This document describes \fBafm2afm\fR version 20200511. +This document describes \fBafm2afm\fR version 20200527. .SH "RECENT CHANGES" .IX Header "RECENT CHANGES" (See the source code for the rest of the story.) diff --git a/Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf b/Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf index 79c05127eaa..20d4d06fe62 100644 Binary files a/Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf and b/Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf differ diff --git a/Master/texmf-dist/doc/man/man1/autoinst.1 b/Master/texmf-dist/doc/man/man1/autoinst.1 index 86c989f1406..4ffb6c4fa52 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 "2020-05-11" "fontools" "Marc Penninga" +.TH AUTOINST 1 "2020-05-27" "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 @@ -180,7 +180,7 @@ Italic and slanted small caps Swash .IP "\fInw\fR" 8 .IX Item "nw" -\&\*(L"Upright swash\*(R" +`Upright swash' .RE .RS 2 .RE @@ -194,11 +194,11 @@ a family of TS1\-encoded symbol fonts, in roman, italic and slanted shapes. 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 `Titling' characters; +these `... 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" +and adjusted for viewing at larger sizes' (according to the OpenType Specification). .IP "\-" 3 An ornament family, also in roman, italic and slanted shapes. @@ -236,7 +236,7 @@ inferior characters; usually only digits and some punctuation, normal forms for other characters .IP "\fITitl\fR" 8 .IX Item "Titl" -Titling characters; see above. +Titling characters; see above .IP "\fIOrn\fR" 8 .IX Item "Orn" ornaments @@ -249,47 +249,9 @@ denominators .PP The individual fonts are named \fI\-\-\-\fR, where \fI\fR is the same as above (but in lowercase), -\&\fI\fR is either empty, \*(L"sc\*(R" or \*(L"swash\*(R", +\&\fI\fR is either empty, `sc' or `swash', and \fI\fR is the encoding (also in lowercase). -A typical name in this scheme would be \*(L"FiraSans\-Light\-osf\-sc\-ly1\*(R". -.SS "About the log file" -.IX Subsection "About the log file" -\&\fBautoinst\fR writes some info about what it thinks it's doing to a log file. -By default this is called \fI.log\fR, -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. -.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 -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 -(see \*(L"COMMAND-LINE \s-1OPTIONS\*(R"\s0 below) to manually specify a \s-1TEXMF\s0 tree. -.PP -Also, some OpenType fonts contain so many kerning pairs that the resulting -\&\fIpl\fR and \fIvpl\fR files are too big for MiKTeX's \fIpltotf\fR and \fIvptovf\fR; -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 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 -TeX about the files in \f(CW$TEXMFHOME\fR. -The latter option does, however, have some caveats; -see \fIhttps://tug.org/texlive/scripts\-sys\-user.html\fR. +A typical name in this scheme would be `FiraSans\-Light\-osf\-sc\-ly1'. .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, @@ -312,28 +274,30 @@ yourself. .el .IP "\f(CWlining\fR, \f(CWoldstyle\fR, \f(CWtabular\fR, \f(CWproportional\fR" 4 .IX Item "lining, oldstyle, tabular, proportional" Choose which figure style to use. -The defaults are \*(L"oldstyle\*(R" and \*(L"proportional\*(R" (if available). -.ie n .IP """scale=\fI\fP""" 4 -.el .IP "\f(CWscale=\f(CI\f(CW\fR" 4 -.IX Item "scale=" +The defaults are `oldstyle' and `proportional' (if available). +.ie n .IP """scale=\fI\fP"", ""scale=MatchLowercase""" 4 +.el .IP "\f(CWscale=\f(CI\f(CW\fR, \f(CWscale=MatchLowercase\fR" 4 +.IX Item "scale=, scale=MatchLowercase" Scale the font by a factor of \fI\fR. E.g., to increase the size of the font by 5%, use \&\f(CW\*(C`\eusepackage[scale=1.05]{\f(CI\f(CW}\*(C'\fR. -May also be spelled \f(CW\*(C`scaled\*(C'\fR. -.Sp -This option is only available when you have the \fIxkeyval\fR package installed. +The special value \f(CW\*(C`MatchLowercase\*(C'\fR may be used to scale the font +so that its x\-height matches that of the previously active font +(which is usually Computer Modern, unless you have loaded another +font package before this one). +The name \f(CW\*(C`scaled\*(C'\fR may be used as a synonym for \f(CW\*(C`scale\*(C'\fR. .ie n .IP """medium"", ""book"", ""text"", ""regular""" 4 .el .IP "\f(CWmedium\fR, \f(CWbook\fR, \f(CWtext\fR, \f(CWregular\fR" 4 .IX Item "medium, book, text, regular" -Select the weight that LaTeX will use as the \*(L"regular\*(R" weight; +Select the weight that LaTeX will use as the `regular' weight; the default is \f(CW\*(C`regular\*(C'\fR. .ie n .IP """heavy"", ""black"", ""extrabold"", ""demibold"", ""semibold"", ""bold""" 4 .el .IP "\f(CWheavy\fR, \f(CWblack\fR, \f(CWextrabold\fR, \f(CWdemibold\fR, \f(CWsemibold\fR, \f(CWbold\fR" 4 .IX Item "heavy, black, extrabold, demibold, semibold, bold" -Select the weight that LaTeX will use as the \*(L"bold\*(R" weight; +Select the weight that LaTeX will use as the `bold' weight; the default is \f(CW\*(C`bold\*(C'\fR. .PP -The previous two groups of options will only work if +The last 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 @@ -348,8 +312,8 @@ characters: \& DECLARATION COMMAND SHORT FORM OF COMMAND \& \& \etlshape \etexttitling \etexttl -\& \esufigures \etextsuperior \etextsu -\& \einfigures \etextinferior \etextin +\& \esupfigures \etextsuperior \etextsup, \etextsu +\& \einffigures \etextinferior \etextinf, \etextin .Ve .PP In addition, the \f(CW\*(C`\eswshape\*(C'\fR and \f(CW\*(C`\etextsw\*(C'\fR commands are redefined to place @@ -372,37 +336,66 @@ By default, \fBautoinst\fR generates text fonts with \s-1OT1, LY1\s0 and T1 encodings, and the generated style files use T1 as the default text encoding. Other encodings can be chosen using the \fI\-encoding\fR option (see \*(L"COMMAND-LINE \s-1OPTIONS\*(R"\s0 below). +.SS "Maths" +.IX Subsection "Maths" +This is an experimental feature; \fB\s-1USE AT YOUR OWN RISK\s0!\fR +Test the results thoroughly before using them in real documents, +and be warned that future versions of \fBautoinst\fR may introduce +incompatible changes. .PP -\fIOrnaments\fR -.IX Subsection "Ornaments" +The \fI\-math\fR option tells \fBautoinst\fR to generate basic math fonts. +When enabled, the generated style file defines a few extra options +to access these math fonts: +.ie n .IP """math""" 4 +.el .IP "\f(CWmath\fR" 4 +.IX Item "math" +Use these fonts for the maths in your document. +.ie n .IP """mathlining"", ""matholdstyle""" 4 +.el .IP "\f(CWmathlining\fR, \f(CWmatholdstyle\fR" 4 +.IX Item "mathlining, matholdstyle" +Choose which figure style to use in maths. +The default is `mathlining'. +.ie n .IP """mathcal""" 4 +.el .IP "\f(CWmathcal\fR" 4 +.IX Item "mathcal" +Use the swash characters from your fonts as the \f(CW\*(C`\emathcal\*(C'\fR alphabet. +(This option only exists if your fonts actually contain swash characters +and a \f(CW\*(C`swsh\*(C'\fR feature to access them). +.ie n .IP """math\-style=\fI