diff options
author | Karl Berry <karl@freefriends.org> | 2023-12-30 21:25:52 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2023-12-30 21:25:52 +0000 |
commit | 8419fa32b130f89e32499694bd98fe8379167327 (patch) | |
tree | 066f53fe06ec55819dd242641cfe8317dcd66e34 /Master/texmf-dist/doc/man | |
parent | 05b22bd50ef6cb5fa8be0981e0af3123247ba565 (diff) |
fontools (30dec23)
git-svn-id: svn://tug.org/texlive/trunk@69241 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man')
-rw-r--r-- | Master/texmf-dist/doc/man/man1/afm2afm.1 | 130 | ||||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf | bin | 26983 -> 26740 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/autoinst.1 | 396 | ||||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/autoinst.man1.pdf | bin | 73773 -> 71217 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/ot2kpx.1 | 158 | ||||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/ot2kpx.man1.pdf | bin | 27274 -> 26773 bytes |
6 files changed, 216 insertions, 468 deletions
diff --git a/Master/texmf-dist/doc/man/man1/afm2afm.1 b/Master/texmf-dist/doc/man/man1/afm2afm.1 index ba9102eb77e..e543152a0f6 100644 --- a/Master/texmf-dist/doc/man/man1/afm2afm.1 +++ b/Master/texmf-dist/doc/man/man1/afm2afm.1 @@ -1,4 +1,5 @@ -.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) +.\" -*- mode: troff; coding: utf-8 -*- +.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== @@ -15,29 +16,12 @@ .ft R .fi .. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. \*(C+ will -.\" give a nicer C++. Capital omega is used to do unbreakable dashes and -.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, -.\" nothing in troff, for use with C<>. -.tr \(*W- -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' . ds C` . ds C' 'br\} @@ -68,81 +52,19 @@ . \} .\} .rr rF -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "AFM2AFM 1" -.TH AFM2AFM 1 "2023-09-14" "fontools" "Marc Penninga" +.TH AFM2AFM 1 2023-12-30 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 .nh -.SH "NAME" +.SH NAME afm2afm \- reencode an afm file -.SH "SYNOPSIS" +.SH SYNOPSIS .IX Header "SYNOPSIS" -.IP "\fBafm2afm\fR" 8 +.IP \fBafm2afm\fR 8 .IX Item "afm2afm" [\fB\-help\fR] [\fB\-version\fR] @@ -150,7 +72,7 @@ afm2afm \- reencode an afm file [\fB\-kpx\fR=\fI<kpxfile>\fR] [\fB\-output\fR=\fI<outputfile>\fR] \&\fB<afmfile>\fR -.SH "DESCRIPTION" +.SH DESCRIPTION .IX Header "DESCRIPTION" \&\fBafm2afm\fR re-encodes an \fIafm\fR file. .PP @@ -169,16 +91,16 @@ the output was written to file (i.e., if both the \fI\-encoding\fR and \fI\-output\fR options were specified). .SH "OPTIONS AND ARGUMENTS" .IX Header "OPTIONS AND ARGUMENTS" -.IP "\fB\-help\fR" 4 +.IP \fB\-help\fR 4 .IX Item "-help" Print a short description of the syntax -.IP "\fB\-version\fR" 4 +.IP \fB\-version\fR 4 .IX Item "-version" Print version number and exit -.IP "\fB\-encoding\fR=\fI<encodingfile>\fR" 4 +.IP \fB\-encoding\fR=\fI<encodingfile>\fR 4 .IX Item "-encoding=<encodingfile>" Re-encode to the enconding in \fI<encodingfile>\fR -.IP "\fB\-kpx\fR=\fI<kpxfile>\fR" 4 +.IP \fB\-kpx\fR=\fI<kpxfile>\fR 4 .IX Item "-kpx=<kpxfile>" Read additional kerning pairs from \fI<kpxfile>\fR and add these to the output. This option cannot be used to override values from the input \fIafm\fR file, @@ -192,41 +114,41 @@ i.e. for each kerning pair there should be a line .Ve .Sp All other lines in the \fI<kpxfile>\fR are ignored. -.IP "\fB\-output\fR=\fI<outputfile>\fR" 4 +.IP \fB\-output\fR=\fI<outputfile>\fR 4 .IX Item "-output=<outputfile>" Write the result to \fI<outputfile>\fR instead of \f(CW\*(C`stdout\*(C'\fR. -.IP "\fB<afmfile>\fR" 4 +.IP \fB<afmfile>\fR 4 .IX Item "<afmfile>" The \fIafm\fR file to be re-encoded. .PP You may use either one or two dashes before options, and option names may be shortened to a unique prefix. -.SH "AUTHOR" +.SH AUTHOR .IX Header "AUTHOR" Marc Penninga <marcpenninga@gmail.com> -.SH "COPYRIGHT" +.SH COPYRIGHT .IX Header "COPYRIGHT" Copyright (C) 2005\-2023 Marc Penninga. -.SH "LICENSE" +.SH LICENSE .IX Header "LICENSE" This program is free software; you can redistribute it and/or modify -it under the terms of the \s-1GNU\s0 General Public License as published +it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version. -A copy of the \s-1GNU\s0 General Public License is included with \fBafm2afm\fR; +A copy of the GNU General Public License is included with \fBafm2afm\fR; see the file \fIGPLv2.txt\fR. -.SH "DISCLAIMER" +.SH DISCLAIMER .IX Header "DISCLAIMER" This program is distributed in the hope that it will be useful, -but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of -\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 -See the \s-1GNU\s0 General Public License for more details. -.SH "VERSION" +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +See the GNU General Public License for more details. +.SH VERSION .IX Header "VERSION" -This document describes \fBafm2afm\fR version 20230914. +This document describes \fBafm2afm\fR version 20231230. .SH "RECENT CHANGES" .IX Header "RECENT CHANGES" (See the source code for the rest of the story.) -.IP "\fI2019\-05\-20\fR" 12 +.IP \fI2019\-05\-20\fR 12 .IX Item "2019-05-20" Added the \fI\-version\fR option. diff --git a/Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf b/Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf Binary files differindex f8fd0910351..2dc08afc989 100644 --- a/Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/afm2afm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/autoinst.1 b/Master/texmf-dist/doc/man/man1/autoinst.1 index 6361816046b..846673e8b1c 100644 --- a/Master/texmf-dist/doc/man/man1/autoinst.1 +++ b/Master/texmf-dist/doc/man/man1/autoinst.1 @@ -1,4 +1,5 @@ -.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) +.\" -*- mode: troff; coding: utf-8 -*- +.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== @@ -15,29 +16,12 @@ .ft R .fi .. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. \*(C+ will -.\" give a nicer C++. Capital omega is used to do unbreakable dashes and -.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, -.\" nothing in troff, for use with C<>. -.tr \(*W- -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' . ds C` . ds C' 'br\} @@ -68,87 +52,25 @@ . \} .\} .rr rF -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "AUTOINST 1" -.TH AUTOINST 1 "2023-09-14" "fontools" "Marc Penninga" +.TH AUTOINST 1 2023-12-30 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 .nh -.SH "NAME" +.SH NAME autoinst \- wrapper around the LCDF TypeTools, for installing and using OpenType fonts in LaTeX. -.SH "SYNOPSIS" +.SH SYNOPSIS .IX Header "SYNOPSIS" \&\fBautoinst\fR \fI\-help\fR .PP \&\fBautoinst\fR [\fIoptions\fR] \fBfont(s)\fR -.SH "DESCRIPTION" +.SH DESCRIPTION .IX Header "DESCRIPTION" -Eddie Kohler's \fI\s-1LCDF\s0 TypeTools\fR are superb tools for installing +Eddie Kohler's \fILCDF TypeTools\fR are superb tools for installing OpenType fonts in LaTeX, but they can be hard to use: they need many, often long, command lines and don't generate the \fIfd\fR and \fIsty\fR files LaTeX needs. @@ -159,50 +81,50 @@ and by creating and installing all necessary \fIfd\fR and \fIsty\fR files. 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 +.IP \- 3 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 +.IP \fIn\fR 8 .IX Item "n" Roman (i.e., upright) text .IP "\fIit\fR, \fIsl\fR" 8 .IX Item "it, sl" Italic and slanted (sometimes called oblique) text -.IP "\fIsc\fR" 8 +.IP \fIsc\fR 8 .IX Item "sc" Small caps .IP "\fIscit\fR, \fIscsl\fR" 8 .IX Item "scit, scsl" Italic and slanted small caps -.IP "\fIsw\fR" 8 +.IP \fIsw\fR 8 .IX Item "sw" Swash -.IP "\fInw\fR" 8 +.IP \fInw\fR 8 .IX Item "nw" -\&\*(L"Upright swash\*(R" +"Upright swash" .RE .RS 2 .RE .RE .RS 3 .RE -.IP "\-" 3 +.IP \- 3 For each T1\-encoded text family: a family of TS1\-encoded symbol fonts, in roman, italic and slanted shapes. -.IP "\-" 3 +.IP \- 3 Families with superiors, inferiors, numerators and denominators, in roman, italic and slanted shapes. -.IP "\-" 3 -Families with \*(L"Titling\*(R" characters; -these \fI\*(L"... replace the default glyphs +.IP \- 3 +Families with "Titling" characters; +these \fI"... 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"\fR +and adjusted for viewing at larger sizes"\fR (according to the OpenType Specification). -.IP "\-" 3 +.IP \- 3 An ornament family; also in roman, italic and slanted shapes. .RE .RS 2 @@ -211,35 +133,35 @@ An ornament family; also in roman, italic and slanted shapes. Of course, if your fonts don't contain italics, oldstyle digits, small caps etc., the corresponding shapes and families are not created. In addition, the creation of most families and shapes can be controlled -by the user (see \*(L"COMMAND-LINE \s-1OPTIONS\*(R"\s0 below). +by the user (see "COMMAND-LINE OPTIONS" below). .PP These families use the \fIFontPro\fR project's naming scheme: \&\fI<FontFamily>\-<Suffix>\fR, where \fI<Suffix>\fR is: -.IP "\fI\s-1LF\s0\fR" 8 +.IP \fILF\fR 8 .IX Item "LF" proportional (i.e., figures have varying widths) lining figures -.IP "\fI\s-1TLF\s0\fR" 8 +.IP \fITLF\fR 8 .IX Item "TLF" tabular (i.e., all figures have the same width) lining figures -.IP "\fIOsF\fR" 8 +.IP \fIOsF\fR 8 .IX Item "OsF" proportional oldstyle figures -.IP "\fITOsF\fR" 8 +.IP \fITOsF\fR 8 .IX Item "TOsF" tabular oldstyle figures -.IP "\fISup\fR" 8 +.IP \fISup\fR 8 .IX Item "Sup" superior characters (note that most fonts have only an incomplete set of superior characters: digits, some punctuation and the letters \fIabdeilmnorst\fR; normal forms are used for other characters) -.IP "\fIInf\fR" 8 +.IP \fIInf\fR 8 .IX Item "Inf" inferior characters; usually only digits and some punctuation, normal forms for other characters -.IP "\fITitl\fR" 8 +.IP \fITitl\fR 8 .IX Item "Titl" Titling characters; see above -.IP "\fIOrn\fR" 8 +.IP \fIOrn\fR 8 .IX Item "Orn" ornaments .IP "\fINumr\fR, \fIDnom\fR" 8 @@ -248,7 +170,7 @@ numerators and denominators .PP The individual fonts are named \fI<FontName>\-<suffix>\-<shape>\-<enc>\fR, where \fI<suffix>\fR is the same as above (but in lowercase), -\&\fI<shape>\fR is either empty, \*(L"sc\*(R" or \*(L"swash\*(R", +\&\fI<shape>\fR is either empty, "sc" or "swash", and \fI<enc>\fR is the encoding (also in lowercase). A typical name in this scheme would be \fIFiraSans\-Light\-osf\-sc\-ly1\fR. .SS "Using the fonts in your LaTeX documents" @@ -256,12 +178,12 @@ A typical name in this scheme would be \fIFiraSans\-Light\-osf\-sc\-ly1\fR. \&\fBautoinst\fR generates a style file for using the fonts in LaTeX documents, named \fI<FontFamily>.sty\fR. This style file also loads the \fIfontenc\fR and \fItextcomp\fR packages, if necessary. -To use the fonts, add the command \f(CW\*(C`\eusepackage{\f(CI<FontFamily>\f(CW}\*(C'\fR +To use the fonts, add the command \f(CW\*(C`\eusepackage{\fR\f(CI<FontFamily>\fR\f(CW}\*(C'\fR to the preamble of your document. .PP This style file has a few options: .ie n .IP """mainfont""" 4 -.el .IP "\f(CWmainfont\fR" 4 +.el .IP \f(CWmainfont\fR 4 .IX Item "mainfont" Redefine \f(CW\*(C`\efamilydefault\*(C'\fR to make this font the main font for the document. @@ -273,34 +195,34 @@ 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<factor>\fP"", ""scale=MatchLowercase""" 4 -.el .IP "\f(CWscale=\f(CI<factor>\f(CW\fR, \f(CWscale=MatchLowercase\fR" 4 +The defaults are "oldstyle" and "proportional" (if available). +.ie n .IP """scale=\fI<factor>\fR"", ""scale=MatchLowercase""" 4 +.el .IP "\f(CWscale=\fR\f(CI<factor>\fR\f(CW\fR, \f(CWscale=MatchLowercase\fR" 4 .IX Item "scale=<factor>, scale=MatchLowercase" Scale the font by \fI<factor>\fR; -as an example, \f(CW\*(C`\eusepackage[scale=1.05]{\f(CI<FontFamily>\f(CW}\*(C'\fR +as an example, \f(CW\*(C`\eusepackage[scale=1.05]{\fR\f(CI<FontFamily>\fR\f(CW}\*(C'\fR will increase the font's size by 5%. 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 current main font (which is usually Computer Modern Roman, unless you have loaded another font package before this one). -The word \*(L"scale\*(R" may also be spelled as \*(L"scaled\*(R". +The word "scale" may also be spelled as "scaled". .ie n .IP """medium"", ""book"", ""text"", ""normal"", ""regular""" 4 .el .IP "\f(CWmedium\fR, \f(CWbook\fR, \f(CWtext\fR, \f(CWnormal\fR, \f(CWregular\fR" 4 .IX Item "medium, book, text, normal, 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. .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. .PP The last two groups of options will only work if you have the \fImweights\fR package installed. The default here is not to change LaTeX's default, -i.e. use the \*(L"m\*(R" and \*(L"b\*(R" weights. +i.e. use the "m" and "b" weights. .PP The style file will also try to load the \fIfontaxes\fR package -(on \s-1CTAN\s0), which gives easy access to various font shapes and styles. +(on CTAN), 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 @@ -335,15 +257,15 @@ Once again: all these commands are only generated for existing shapes and number no commands are generated for shapes and styles that are missing from your fonts. Note that all these commands are built on top of \fIfontaxes\fR; if that package cannot be found, you're limited to using lower-level commands from -standard \s-1NFSS\s0 (\f(CW\*(C`\efontfamily\*(C'\fR, \f(CW\*(C`\efontseries\*(C'\fR, \f(CW\*(C`\efontshape\*(C'\fR etc.). +standard NFSS (\f(CW\*(C`\efontfamily\*(C'\fR, \f(CW\*(C`\efontseries\*(C'\fR, \f(CW\*(C`\efontshape\*(C'\fR etc.). .PP -By default, \fBautoinst\fR generates text fonts with \s-1OT1, LY1\s0 and T1 +By default, \fBautoinst\fR generates text fonts with OT1, LY1 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" +(see "COMMAND-LINE OPTIONS" below). +.SS Maths .IX Subsection "Maths" -This is an experimental feature; \fB\s-1USE AT YOUR OWN RISK\s0!\fR +This is an experimental feature; \fBUSE AT YOUR OWN RISK!\fR Test the results thoroughly before using them in real documents, and be warned that future versions of \fBautoinst\fR may introduce incompatible changes. @@ -352,28 +274,28 @@ 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 +.el .IP \f(CWmath\fR 4 .IX Item "math" Use these fonts for the maths in your document. .ie n .IP """mathlining"", ""matholdstyle"", ""mathtabular"", ""mathproportional""" 4 .el .IP "\f(CWmathlining\fR, \f(CWmatholdstyle\fR, \f(CWmathtabular\fR, \f(CWmathproportional\fR" 4 .IX Item "mathlining, matholdstyle, mathtabular, mathproportional" Choose which figure style and alignment to use in maths. -The defaults are \*(L"mathlining\*(R" and \*(L"mathtabular\*(R". +The defaults are "mathlining" and "mathtabular". .ie n .IP """mathcal""" 4 -.el .IP "\f(CWmathcal\fR" 4 +.el .IP \f(CWmathcal\fR 4 .IX Item "mathcal" Use the swash characters from these fonts as the \f(CW\*(C`\emathcal\*(C'\fR alphabet. (This option will only exist if your fonts actually contain both swash characters and a \f(CW\*(C`swsh\*(C'\fR feature to access them). .ie n .IP """nomathgreek""" 4 -.el .IP "\f(CWnomathgreek\fR" 4 +.el .IP \f(CWnomathgreek\fR 4 .IX Item "nomathgreek" Don't redeclare greek letters in math. -.ie n .IP """math\-style=\fI<style>\fP""" 4 -.el .IP "\f(CWmath\-style=\f(CI<style>\f(CW\fR" 4 +.ie n .IP """math\-style=\fI<style>\fR""" 4 +.el .IP \f(CWmath\-style=\fR\f(CI<style>\fR\f(CW\fR 4 .IX Item "math-style=<style>" -Choose the \*(L"math style\*(R" to use. +Choose the "math style" to use. With \f(CW\*(C`math\-style=ISO\*(C'\fR, all latin and greek letters in math are italic; with \f(CW\*(C`math\-style=TeX\*(C'\fR (the default), uppercase greek is upright; with \f(CW\*(C`math\-style=french\*(C'\fR, all greek as well as uppercase latin is upright; @@ -403,25 +325,25 @@ Once again: test the results before using them! If the characters themselves are fine but spaced too tightly, you may try increasing the side bearings in math fonts with the \fI\-mathspacing\fR option (see below), e.g. \f(CW\*(C`\-mathspacing=50\*(C'\fR. -.SS "\s-1NFSS\s0 codes" +.SS "NFSS codes" .IX Subsection "NFSS codes" -LaTeX's New Font Selection System (\s-1NFSS\s0) +LaTeX's New Font Selection System (NFSS) identifies fonts by a combination of family, series (the concatenation of weight and width), shape and size. \&\fBautoinst\fR parses the font's metadata to determine these parameters. When this fails (usually because the font family contains uncommon weights, widths or shapes), \&\fBautoinst\fR ends up with multiple fonts having the same values -for these font parameters; such fonts cannot be used in \s-1NFSS,\s0 +for these font parameters; such fonts cannot be used in NFSS, since there's no way distinguish them. When \fBautoinst\fR detects such a situation, it will print an error message and abort. If that happens, either rerun \fBautoinst\fR on a smaller set of fonts, or add the missing widths, weights and shapes to the tables \f(CW@WIDTH\fR, \&\f(CW@WEIGHT\fR and \f(CW%SHAPE\fR in the source code. -Please also send a bug report (see \s-1AUTHOR\s0 below). +Please also send a bug report (see AUTHOR below). .PP -The mapping of shapes to \s-1NFSS\s0 codes is done using the following table: +The mapping of shapes to NFSS codes is done using the following table: .PP .Vb 5 \& SHAPE CODE @@ -435,38 +357,38 @@ The mapping of shapes to \s-1NFSS\s0 codes is done using the following table: 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 as this family doesn't contain an Italic shape.) .PP -For weights and widths, \fBautoinst\fR tries to the standard \s-1NFSS\s0 codes +For weights and widths, \fBautoinst\fR tries to the standard NFSS codes (ul, el, l, sl, m, sb, b, eb and ub for weights; uc, ec, c, sc, m, sx, x, ex and ux for widths) as much as possible. -Of course, not all 81 combinations of these \s-1NFSS\s0 weights and widths will map +Of course, not all 81 combinations of these NFSS 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 for the weights, -some font families offer more variants than \s-1NFSS\s0's codes can handle; +some font families offer more variants than NFSS's codes can handle; e.g., Fira Sans contains fifteen different weights!). -Therefore every font is also assigned a \*(L"series\*(R" name that is +Therefore every font is also assigned a "series" name that is the concatenation of its weight and width, after expanding any abbreviations and converting to lowercase. -A font of \*(L"Cond\*(R" width and \*(L"Ultra\*(R" weight will then be known -as \*(L"ultrablackcondensed\*(R". +A font of "Cond" width and "Ultra" weight will then be known +as "ultrablackcondensed". .PP -The exact mapping between fonts and \s-1NFSS\s0 codes can be found +The exact mapping between fonts and NFSS codes can be found in the generated \fIfd\fR files and in the log file (you may want to run \fBautoinst\fR with the \fI\-dryrun\fR option to check the chosen mapping beforehand). The \fI\-nfssweight\fR and \fI\-nfsswidth\fR command-line options can be used -to finetune the mapping between \s-1NFSS\s0 codes and fonts. +to finetune the mapping between NFSS codes and fonts. .PP To access specific weights or widths, one can always use the \f(CW\*(C`\efontseries\*(C'\fR command with the full series name (i.e., \f(CW\*(C`\efontseries{demibold}\eselectfont\*(C'\fR). -.SS "Ornaments" +.SS Ornaments .IX Subsection "Ornaments" Ornament fonts are regular LY1\-encoded fonts, with a number of -\&\*(L"regular\*(R" characters replaced by ornament glyphs. +"regular" characters replaced by ornament glyphs. The OpenType specification says that fonts should only put their -ornaments in place of the lowercase \s-1ASCII\s0 letters, but some fonts +ornaments in place of the lowercase ASCII letters, but some fonts put them in other positions (such as those of the digits) as well. .PP Ornaments can be accessed like \f(CW\*(C`{\eornaments a}\*(C'\fR and @@ -487,25 +409,25 @@ are not compatible with files generated by newer versions. .IX Subsection "OpenType fonts and licensing issues" Since \fIpdfTeX\fR cannot subset otf-flavoured OpenType fonts, \&\fIotftotfm\fR will convert such fonts to Type1 (pfb) format. -However, many fonts (at least those licensed under the \s-1SIL\s0 Open Font License) +However, many fonts (at least those licensed under the SIL Open Font License) do not allow redistributing such converted versions under their original name. .PP In order to try to meet such licensing requirements, \fBautoinst\fR provides a \fI\-t1suffix\fR command-line option that appends a suffix to the names (both the filename and the internal font name) -of all generated Type1 fonts; see \*(L"COMMAND-LINE \s-1OPTIONS\*(R"\s0 below. +of all generated Type1 fonts; see "COMMAND-LINE OPTIONS" below. .PP Please note that I am not a lawyer and do not guarantee that this suffix is sufficient to meet the license's requirements. When in doubt, consult a real lawyer! -.SS "Sorry, \s-1LIGTABLE\s0 too long for me to handle" +.SS "Sorry, LIGTABLE too long for me to handle" .IX Subsection "Sorry, LIGTABLE too long for me to handle" -The \s-1LIGTABLE\s0 in TeX's \fItfm\fR files, which contains a font's ligatures +The LIGTABLE in TeX's \fItfm\fR files, which contains a font's ligatures and kerning pairs, is limited to about 32,500 entries (2^15 \- 256). If the number of ligatures plus kerns in a font is higher than that limit, \&\fIpltotf\fR and \fIvptovf\fR will complain loudly and ignore the excess entries. This happens at least with Adobe's Source Serif 4 and Minion 3 font families. -Even when \fIpltotf\fR and \fIvptovf\fR don't warn about the \s-1LIGTABLE\s0's size, +Even when \fIpltotf\fR and \fIvptovf\fR don't warn about the LIGTABLE's size, you may still find that \fIpdftex\fR crashes with a \&\f(CW\*(C`Bad metric (TFM) file\*(C'\fR error. The best way to handle this situation is to use \fBautoinst\fR's \f(CW\*(C`\-extra\*(C'\fR option @@ -515,7 +437,7 @@ Finding the correct value for the \f(CW\*(C`\-\-min\-kern\*(C'\fR parameter may trial and error. .SS "A note for MiKTeX users" .IX Subsection "A note for MiKTeX users" -Automatically installing the fonts into a suitable \s-1TEXMF\s0 tree +Automatically installing the fonts into a suitable TEXMF 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 @@ -523,7 +445,7 @@ 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. +(see "COMMAND-LINE OPTIONS" below) to manually specify a TEXMF 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; @@ -544,7 +466,7 @@ This latter option does, however, come with some caveats; see \fIhttps://tug.org/texlive/scripts\-sys\-user.html\fR. .SH "COMMAND-LINE OPTIONS" .IX Header "COMMAND-LINE OPTIONS" -\&\fBautoinst\fR tries hard to do The Right Thing (\s-1TM\s0) by default, +\&\fBautoinst\fR tries hard to do The Right Thing (TM) by default, so you usually won't need these options; but most aspects of its operation can be fine-tuned if you want to. .PP @@ -554,22 +476,22 @@ and option names may be shortened to a unique prefix but \fB\-e\fR is ambiguous (it may mean either \fB\-encoding\fR or \fB\-extra\fR)). .SS "General options" .IX Subsection "General options" -.IP "\fB\-help\fR" 4 +.IP \fB\-help\fR 4 .IX Item "-help" Print a (relatively) short help text and exit. -.IP "\fB\-dryrun\fR" 4 +.IP \fB\-dryrun\fR 4 .IX Item "-dryrun" Don't generate output; just parse input fonts and write the results to the log file. -.IP "\fB\-verbose\fR" 4 +.IP \fB\-verbose\fR 4 .IX Item "-verbose" Add more details to the log file. -.IP "\fB\-version\fR" 4 +.IP \fB\-version\fR 4 .IX Item "-version" Print \fBautoinst\fR's version number and exit. .SS "Font creation options" .IX Subsection "Font creation options" -.IP "\fB\-encoding\fR=\fIencoding[,encoding]\fR" 4 +.IP \fB\-encoding\fR=\fIencoding[,encoding]\fR 4 .IX Item "-encoding=encoding[,encoding]" Generate the specified encoding(s) for the text fonts. Multiple encodings may be specified as a comma-separated list @@ -579,69 +501,69 @@ For each encoding argument, \fBautoinst\fR will first check if it is the filename of an encoding file, and if found it will use that; otherwise the argument is assumed to be the name of one of the built-in encodings. -Currently \fBautoinst\fR comes with built-in support for the \s-1OT1, T1/TS1, LY1, -T2A/B/C, T3/TS3, T4, T5, LGR, CS, L7X\s0 and \s-1QX\s0 encodings. +Currently \fBautoinst\fR comes with built-in support for the OT1, T1/TS1, LY1, +T2A/B/C, T3/TS3, T4, T5, LGR, CS, L7X and QX encodings. (These files are called \fIfontools_ot1.enc\fR etc. to avoid name clashes with other packages; the \fIfontools_\fR prefix may be omitted.) -.IP "\fB\-ts1\fR/\fB\-nots1\fR" 4 +.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\-lining\fR/\fB\-nolining\fR" 4 +.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 +.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 +.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 +.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 +.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 +.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 +.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 +.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 ]" .PD 0 -.IP "\fB\-noinferiors\fR" 4 +.IP \fB\-noinferiors\fR 4 .IX Item "-noinferiors" .PD The OpenType standard defines several kinds of digits that might be used -as inferiors or subscripts: \*(L"Subscripts\*(R" (OpenType feature \f(CW\*(C`subs\*(C'\fR), -\&\*(L"Scientific Inferiors\*(R" (\f(CW\*(C`sinf\*(C'\fR), and \*(L"Denominators\*(R" (\f(CW\*(C`dnom\*(C'\fR). +as inferiors or subscripts: "Subscripts" (OpenType feature \f(CW\*(C`subs\*(C'\fR), +"Scientific Inferiors" (\f(CW\*(C`sinf\*(C'\fR), and "Denominators" (\f(CW\*(C`dnom\*(C'\fR). 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 +Alternatively, the value "auto" tells \fBautoinst\fR to use the first value 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. 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 +\&\fR\f(BIautoinst\fR\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 +.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 +.IP \fB\-ligatures\fR/\fB\-noligatures\fR 4 .IX Item "-ligatures/-noligatures" Some fonts contain glyphs for the standard f\-ligatures (ff, fi, fl, ffi, ffl), but don't provide a \f(CW\*(C`liga\*(C'\fR feature to access these. @@ -651,10 +573,10 @@ The default is \fB\-ligatures\fR, except for typewriter fonts. .Sp Specify \fB\-noligatures\fR to disable generation of ligatures even for fonts that do contain a \f(CW\*(C`liga\*(C'\fR feature. -.IP "\fB\-ornaments\fR/\fB\-noornaments\fR" 4 +.IP \fB\-ornaments\fR/\fB\-noornaments\fR 4 .IX Item "-ornaments/-noornaments" Control the creation of ornament fonts. The default is \fB\-ornaments\fR. -.IP "\fB\-serif\fR/\fB\-sanserif\fR/\fB\-typewriter\fR" 4 +.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: @@ -669,15 +591,15 @@ This latter effect cannot be re-enabled in \fBautoinst\fR; if you want typewriter text to be hyphenated, use the \fIhyphenat\fR package. .Sp If none of these options is specified, \fBautoinst\fR tries to guess: -if the font's filename contains the string \*(L"mono\*(R" +if the font's filename contains the string "mono" or if the field \f(CW\*(C`isFixedPitch\*(C'\fR in the font's \f(CW\*(C`post\*(C'\fR table is True, it will select \fB\-typewriter\fR; -else if the filename contains \*(L"sans\*(R" it will select \fB\-sanserif\fR; +else if the filename contains "sans" it will select \fB\-sanserif\fR; otherwise it will opt for \fB\-serif\fR. -.IP "\fB\-math\fR" 4 +.IP \fB\-math\fR 4 .IX Item "-math" Tells \fBautoinst\fR to create basic math fonts (see above). -.IP "\fB\-mathspacing\fR=\fIamount\fR" 4 +.IP \fB\-mathspacing\fR=\fIamount\fR 4 .IX Item "-mathspacing=amount" Letterspace each character in the math fonts by \fIamount\fR units, where 1000 units equal one em. @@ -685,22 +607,22 @@ In my opinion, many text fonts benefit from letterspacing by 50 to 100 units when used in maths; some fonts need even more. Use your own judgement! .SS "Output options" .IX Subsection "Output options" -.IP "\fB\-t1suffix\fR [ = \fI\s-1SUFFIX\s0\fR ]" 4 +.IP "\fB\-t1suffix\fR [ = \fISUFFIX\fR ]" 4 .IX Item "-t1suffix [ = SUFFIX ]" Tell \fBautoinst\fR to modify the font names of all generated Type1\-fonts, -by adding \fI\s-1SUFFIX\s0\fR to the family name. -If you use this option without specifying a \fI\s-1SUFFIX\s0\fR value, -\&\fBautoinst\fR will use the value \*(L"\s-1PS\*(R".\s0 +by adding \fISUFFIX\fR to the family name. +If you use this option without specifying a \fISUFFIX\fR value, +\&\fBautoinst\fR will use the value "PS". The default behaviour when this option is not given is to not modify font names at all. .Sp -See also \*(L"OpenType fonts and licensing issues\*(R" in \*(L"\s-1WARNINGS AND CAVEATS\*(R"\s0 above. -.IP "\fB\-target\fR=\fI\s-1DIRECTORY\s0\fR" 4 +See also "OpenType fonts and licensing issues" in "WARNINGS AND CAVEATS" above. +.IP \fB\-target\fR=\fIDIRECTORY\fR 4 .IX Item "-target=DIRECTORY" -Install all generated files into the \s-1TEXMF\s0 tree at \fI\s-1DIRECTORY\s0\fR. +Install all generated files into the TEXMF tree at \fIDIRECTORY\fR. .Sp By default, \fBautoinst\fR searches the \f(CW$TEXMFLOCAL\fR and \f(CW$TEXMFHOME\fR trees -and installs all files into the first user-writable \s-1TEXMF\s0 tree it finds. +and installs all files into the first user-writable TEXMF tree it finds. If \fBautoinst\fR cannot find such a user-writable directory (which shouldn't happen, since \f(CW$TEXMFHOME\fR is supposed to be user-writable) it will print a warning message and put all files into the subdirectory @@ -708,29 +630,29 @@ it will print a warning message and put all files into the subdirectory 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). -.IP "\fB\-vendor\fR=\fI\s-1VENDOR\s0\fR" 4 +.IP \fB\-vendor\fR=\fIVENDOR\fR 4 .IX Item "-vendor=VENDOR" .PD 0 -.IP "\fB\-typeface\fR=\fI\s-1TYPEFACE\s0\fR" 4 +.IP \fB\-typeface\fR=\fITYPEFACE\fR 4 .IX Item "-typeface=TYPEFACE" .PD These options are equivalent to \fIotftotfm\fR's \fI \-\-vendor\fR and \fI \-\-typeface\fR -options: they change the \*(L"vendor\*(R" and \*(L"typeface\*(R" parts of the names of the -subdirectories in the \s-1TEXMF\s0 tree where generated files will be stored. -The default values are \*(L"lcdftools\*(R" and the font's FontFamily name. +options: they change the "vendor" and "typeface" parts of the names of the +subdirectories in the TEXMF tree where generated files will be stored. +The default values are "lcdftools" and the font's FontFamily name. These options change \fIonly\fR directory names, not the names of any generated files. -.IP "\fB\-logfile\fR=\fIfilename\fR" 4 +.IP \fB\-logfile\fR=\fIfilename\fR 4 .IX Item "-logfile=filename" Write log data to \fIfilename\fR instead of the default \fI<fontfamily>.log\fR. If the file already exists, \fBautoinst\fR appends to it; it doesn't overwrite an existing file. .SS "Specialist options" .IX Subsection "Specialist options" -.IP "\fB\-defaultlining\fR/\fB\-defaultoldstyle\fR" 4 +.IP \fB\-defaultlining\fR/\fB\-defaultoldstyle\fR 4 .IX Item "-defaultlining/-defaultoldstyle" .PD 0 -.IP "\fB\-defaulttabular\fR/\fB\-defaultproportional\fR" 4 +.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 @@ -741,17 +663,17 @@ They are only needed for fonts that don't provide OpenType features for their default figure style; and even in that case, \&\fBautoinst\fR's default values (\fB\-defaultlining\fR and \fB\-defaulttabular\fR) are usually correct. -.IP "\fB\-nfssweight\fR=\fIcode\fR=\fIweight\fR" 4 +.IP \fB\-nfssweight\fR=\fIcode\fR=\fIweight\fR 4 .IX Item "-nfssweight=code=weight" .PD 0 -.IP "\fB\-nfsswidth\fR=\fIcode\fR=\fIwidth\fR" 4 +.IP \fB\-nfsswidth\fR=\fIcode\fR=\fIwidth\fR 4 .IX Item "-nfsswidth=code=width" .PD -Map the \s-1NFSS\s0 code \fIcode\fR to the given weight or width, +Map the NFSS 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 \f(CW\*(C`ul\*(C'\fR code to the \*(L"Thin\*(R" weight, +to override more than one NFSS code. +Example: to map the \f(CW\*(C`ul\*(C'\fR code to the "Thin" weight, use \f(CW\*(C`\-nfssweight=ul=thin\*(C'\fR. To inhibit the use of the \f(CW\*(C`ul\*(C'\fR code completely, use \f(CW\*(C`\-nfssweight=ul=\*(C'\fR. @@ -760,7 +682,7 @@ use \f(CW\*(C`\-nfssweight=ul=\*(C'\fR. Pass \fIextra options\fR to the commands for \fIotftotfm\fR. To prevent \fIextra options\fR from accidentily being interpreted as options to \fBautoinst\fR, they should be properly quoted. -.IP "\fB\-manual\fR" 4 +.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 @@ -777,7 +699,7 @@ When using this option, you need to execute the following manual steps after .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 "\- 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 TEXMF 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 "\- 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 @@ -791,7 +713,7 @@ are meaningless, and hence ignored, in manual mode. .Sp Also note that font name modification doesn't happen in manual mode. .RE -.IP "\fB\-nofigurekern\fR" 4 +.IP \fB\-nofigurekern\fR 4 .IX Item "-nofigurekern" Some fonts provide kerning pairs for tabular figures. This is very probably not what you want @@ -818,7 +740,7 @@ without any (La)TeX\-specific support files. 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. -.SH "AUTHOR" +.SH AUTHOR .IX Header "AUTHOR" Marc Penninga (\fImarcpenninga@gmail.com\fR) .PP @@ -827,39 +749,42 @@ 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" +.SH COPYRIGHT .IX Header "COPYRIGHT" Copyright (C) 2005\-2023 Marc Penninga. -.SH "LICENSE" +.SH LICENSE .IX Header "LICENSE" This program is free software; you can redistribute it and/or modify -it under the terms of the \s-1GNU\s0 General Public License as published +it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version. -A copy of the text of the \s-1GNU\s0 General Public License is included in +A copy of the text of the GNU General Public License is included in the \fIfontools\fR distribution; see the file \fIGPLv2.txt\fR. -.SH "DISCLAIMER" +.SH DISCLAIMER .IX Header "DISCLAIMER" This program is distributed in the hope that it will be useful, -but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of -\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 See the -\&\s-1GNU\s0 General Public License for more details. -.SH "VERSION" +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. +.SH VERSION .IX Header "VERSION" -This document describes \fBautoinst\fR version 20230914. +This document describes \fBautoinst\fR version 20231230. .SH "RECENT CHANGES" .IX Header "RECENT CHANGES" (See the source for the full story, all the way back to 2005.) -.IP "\fI2023\-09\-14\fR" 12 +.IP \fI2023\-12\-30\fR 12 +.IX Item "2023-12-30" +Bugfix: font info parsing now works for Junicode 2. +.IP \fI2023\-09\-14\fR 12 .IX Item "2023-09-14" Added the \f(CW\*(C`\eup...\*(C'\fR and \f(CW\*(C`\eit...\*(C'\fR commands to the style file. -.IP "\fI2023\-06\-28\fR" 12 +.IP \fI2023\-06\-28\fR 12 .IX Item "2023-06-28" Adapted font metadata parsing for Adobe Source Serif 4. -.IP "\fI2023\-02\-01\fR" 12 +.IP \fI2023\-02\-01\fR 12 .IX Item "2023-02-01" -Added support for the T4, T5, \s-1CS, L7X\s0 and \s-1QX\s0 encodings. -.IP "\fI2023\-01\-31\fR" 12 +Added support for the T4, T5, CS, L7X and QX encodings. +.IP \fI2023\-01\-31\fR 12 .IX Item "2023-01-31" If the fonts contain superior and/or inferior figures, the generated style file now redefines the \f(CW\*(C`\etextsuperscript\*(C'\fR @@ -869,24 +794,3 @@ mechanism to use these figures Fixed a few bugs in metadata parsing, style file generation and the \f(CW\*(C`\-t1suffix\*(C'\fR option, so that the latter also works for dvips and dvipdfmx. -.IP "\fI2021\-11\-15\fR" 12 -.IX Item "2021-11-15" -Bugfix: font info parsing now works for Adobe Source Serif 4. -.IP "\fI2021\-07\-21\fR" 12 -.IX Item "2021-07-21" -Bugfixes: -.RS 12 -.IP "\-" 3 -Yet another problem with argument quoting on Windows. -.IP "\-" 3 -Selecting numerator/denominator fonts didn't work as documented. -.IP "\-" 3 -Font info parsing failed for Microsoft Sitka and LucasFonts Thesis. -.RE -.RS 12 -.RE -.IP "\fI2021\-04\-01\fR" 12 -.IX Item "2021-04-01" -The \fI\-encoding\fR option now also accepts filenames of encoding files -in directories other than the current directory. -Directory names containing spaces do (or at least should) also work. diff --git a/Master/texmf-dist/doc/man/man1/autoinst.man1.pdf b/Master/texmf-dist/doc/man/man1/autoinst.man1.pdf Binary files differindex c4acbe36c6a..7d6263fa39b 100644 --- a/Master/texmf-dist/doc/man/man1/autoinst.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/autoinst.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ot2kpx.1 b/Master/texmf-dist/doc/man/man1/ot2kpx.1 index 46cd7bbb793..34451566766 100644 --- a/Master/texmf-dist/doc/man/man1/ot2kpx.1 +++ b/Master/texmf-dist/doc/man/man1/ot2kpx.1 @@ -1,4 +1,5 @@ -.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) +.\" -*- mode: troff; coding: utf-8 -*- +.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== @@ -15,29 +16,12 @@ .ft R .fi .. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. \*(C+ will -.\" give a nicer C++. Capital omega is used to do unbreakable dashes and -.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, -.\" nothing in troff, for use with C<>. -.tr \(*W- -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' . ds C` . ds C' 'br\} @@ -68,174 +52,112 @@ . \} .\} .rr rF -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "OT2KPX 1" -.TH OT2KPX 1 "2023-09-14" "fontools" "Marc Penninga" +.TH OT2KPX 1 2023-12-30 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 .nh -.SH "NAME" +.SH NAME ot2kpx \- extract kerning information from OpenType fonts -.SH "SYNOPSIS" +.SH SYNOPSIS .IX Header "SYNOPSIS" \&\fBot2kpx\fR [ \fI\-afm\fR | \fI\-kpx\fR | \fI\-lua\fR ] \fB<fontfile>\fR -.SH "DESCRIPTION" +.SH DESCRIPTION .IX Header "DESCRIPTION" \&\fBot2kpx\fR extract the kerning data from OpenType fonts and prints it -to \f(CW\*(C`stdout\*(C'\fR, either in Adobe's \s-1KPX\s0 format (for adding to an \fIafm\fR file) +to \f(CW\*(C`stdout\*(C'\fR, either in Adobe's KPX format (for adding to an \fIafm\fR file) or as a Luatex custom feature, for use with the \f(CW\*(C`\edirectlua\*(C'\fR command. .SH "OPTIONS AND ARGUMENTS" .IX Header "OPTIONS AND ARGUMENTS" -.IP "\fB\-help\fR" 4 +.IP \fB\-help\fR 4 .IX Item "-help" Print a short help text and exit. -.IP "\fB\-version\fR" 4 +.IP \fB\-version\fR 4 .IX Item "-version" Print \fBot2kpx\fR's version and exit. .IP "\fB\-afm\fR, \fB\-kpx\fR" 4 .IX Item "-afm, -kpx" -Output the kerning data in Adobe's \s-1KPX\s0 format, as used in \fIafm\fR files. +Output the kerning data in Adobe's KPX format, as used in \fIafm\fR files. This is the default output format. -.IP "\fB\-lua\fR" 4 +.IP \fB\-lua\fR 4 .IX Item "-lua" Output the kerning data as a Luatex custom font feature, to be included in a \f(CW\*(C`\edirectlua\*(C'\fR command. -.IP "\fB<fontfile>\fR" 4 +.IP \fB<fontfile>\fR 4 .IX Item "<fontfile>" The OpenType font (both \fIotf\fR and \fIttf\fR format are supported). -.SH "RESTRICTIONS" +.SH RESTRICTIONS .IX Header "RESTRICTIONS" -.IP "\fB\-\fR" 4 +.IP \fB\-\fR 4 .IX Item "-" \&\fBot2kpx\fR doesn't implement all of the OpenType specification. Things that are missing include: support for font files containing multiple fonts, LookupTables with LookupTypes other than 2, -\&\*(L"kern\*(R" tables with format other than 0 and ValueRecords with +"kern" tables with format other than 0 and ValueRecords with other types of data than just XAdvance data. .Sp Most of these limitations won't matter, since the missing features are rare (the only fonts I know of that use them are the non-western fonts that come with Adobe Reader). Furthermore, many of these features define -(according to the OpenType specification) \fI\*(L"subtle, device-dependent -adjustments at specific font sizes or device resolutions\*(R"\fR; +(according to the OpenType specification) \fI"subtle, device-dependent +adjustments at specific font sizes or device resolutions"\fR; since there's no way to express such adjustments in \fIafm\fR format, ignoring them seems to be the only option anyway. -.IP "\fB\-\fR" 4 +.IP \fB\-\fR 4 .IX Item "-" -\&\fBot2kpx\fR collects kerning data first from the \*(L"kern\*(R" table, then from -all LookupTables associated with the \*(L"kern\*(R" feature; if a kerning pair +\&\fBot2kpx\fR collects kerning data first from the "kern" table, then from +all LookupTables associated with the "kern" feature; if a kerning pair occurs multiple times, the first value seen is chosen. There are (or may be) several issues with this approach: .RS 4 -.IP "\-" 4 +.IP \- 4 The OpenType specification says that fonts in \fIotf\fR format shouldn't -use the \*(L"kern\*(R" table at all, just the lookups from the \*(L"\s-1GPOS\*(R"\s0 table. -Many such fonts do, however, contain a \*(L"kern\*(R" table, but no \*(L"\s-1GPOS\*(R"\s0 table; -so we use the \*(L"kern\*(R" table anyway. -.IP "\-" 4 +use the "kern" table at all, just the lookups from the "GPOS" table. +Many such fonts do, however, contain a "kern" table, but no "GPOS" table; +so we use the "kern" table anyway. +.IP \- 4 Instead of reading all LookupTables, it might be better to let the user specify a script and language and process only the LookupTables for those values. However, at least in the fonts I checked, all script/language combinations -eventually point to the \fIsame\fR \*(L"kern\*(R" LookupTables, so this approach +eventually point to the \fIsame\fR "kern" LookupTables, so this approach wouldn't make any difference (apart from further complicating the code). .RE .RS 4 .RE -.SH "AUTHOR" +.SH AUTHOR .IX Header "AUTHOR" Marc Penninga <marcpenninga@gmail.com> -.SH "COPYRIGHT" +.SH COPYRIGHT .IX Header "COPYRIGHT" Copyright (C) 2005\-2023 Marc Penninga. -.SH "LICENSE" +.SH LICENSE .IX Header "LICENSE" This program is free software; you can redistribute it and/or modify -it under the terms of the \s-1GNU\s0 General Public License as published +it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version. -A copy of the \s-1GNU\s0 General Public License is included with \fBot2kpx\fR; +A copy of the GNU General Public License is included with \fBot2kpx\fR; see the file \fIGPLv2.txt\fR. -.SH "DISCLAIMER" +.SH DISCLAIMER .IX Header "DISCLAIMER" This program is distributed in the hope that it will be useful, -but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of -\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 -See the \s-1GNU\s0 General Public License for more details. -.SH "VERSION" +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +See the GNU General Public License for more details. +.SH VERSION .IX Header "VERSION" -This document describes \fBot2kpx\fR version 20230914. +This document describes \fBot2kpx\fR version 20231230. .SH "RECENT CHANGES" .IX Header "RECENT CHANGES" (See the source code for the rest of the story.) -.IP "\fI2019\-05\-20\fR" 12 +.IP \fI2019\-05\-20\fR 12 .IX Item "2019-05-20" Added the \fI\-version\fR option. -.IP "\fI2019\-04\-15\fR" 12 +.IP \fI2019\-04\-15\fR 12 .IX Item "2019-04-15" Added the \fI\-lua\fR command-line option to get output in Luatex's custom feature format. diff --git a/Master/texmf-dist/doc/man/man1/ot2kpx.man1.pdf b/Master/texmf-dist/doc/man/man1/ot2kpx.man1.pdf Binary files differindex 4a5f96bd5dd..2c1a8c2af1f 100644 --- a/Master/texmf-dist/doc/man/man1/ot2kpx.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ot2kpx.man1.pdf |