diff options
author | Karl Berry <karl@freefriends.org> | 2024-07-07 20:09:55 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2024-07-07 20:09:55 +0000 |
commit | 901c92bc9e04a858de56042ef8c92f7e7ced0561 (patch) | |
tree | 69d2362a19864895b15d2d811bc384b633883195 /Master/texmf-dist/doc | |
parent | 3ee0b76dab37afb26f37abc3b59457a739977b08 (diff) |
mf2pt1 (7jul24)
git-svn-id: svn://tug.org/texlive/trunk@71731 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/info/mf2pt1.info | 359 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/mf2pt1/ChangeLog | 19 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/mf2pt1/README | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/mf2pt1/mf2pt1.pdf | bin | 183116 -> 182727 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/support/mf2pt1/mf2pt1.texi | 16 |
5 files changed, 203 insertions, 193 deletions
diff --git a/Master/texmf-dist/doc/info/mf2pt1.info b/Master/texmf-dist/doc/info/mf2pt1.info index 5666407401c..7667cbf3e49 100644 --- a/Master/texmf-dist/doc/info/mf2pt1.info +++ b/Master/texmf-dist/doc/info/mf2pt1.info @@ -1,6 +1,6 @@ -This is mf2pt1.info, produced by makeinfo version 6.8 from mf2pt1.texi. +This is mf2pt1.info, produced by makeinfo version 7.1 from mf2pt1.texi. -Copyright (C) 2005-2021 Scott Pakin +Copyright © 2005-2024 Scott Pakin @@ -27,9 +27,9 @@ File: mf2pt1.info, Node: Top, Next: Introduction, Prev: (dir), Up: (dir) mf2pt1 ****** -'mf2pt1' is a tool that lets font designers design PostScript Type 1 +‘mf2pt1’ is a tool that lets font designers design PostScript Type 1 fonts using the Metafont language. The same source file can be used to -produce both Type 1 ('.pfb') and bitmap ('.pk') fonts. +produce both Type 1 (‘.pfb’) and bitmap (‘.pk’) fonts. * Menu: @@ -63,12 +63,12 @@ in the name "Metafont"). Ideally, we would like to design a font using the Metafont language, but produce PostScript Type 1 output instead of bitmaps. - 'mf2pt1' helps bridge the gap between Metafont and Type 1 fonts. -'mf2pt1' facilitates producing PostScript Type 1 fonts from a Metafont + ‘mf2pt1’ helps bridge the gap between Metafont and Type 1 fonts. +‘mf2pt1’ facilitates producing PostScript Type 1 fonts from a Metafont source file. It is _not_, as the name may imply, an automatic converter -of arbitrary Metafont fonts to Type 1 format. 'mf2pt1' imposes a number +of arbitrary Metafont fonts to Type 1 format. ‘mf2pt1’ imposes a number of restrictions on the Metafont input. If these restrictions are met, -'mf2pt1' will produce valid Type 1 output. +‘mf2pt1’ will produce valid Type 1 output. * Menu: @@ -81,26 +81,26 @@ File: mf2pt1.info, Node: Requirements, Next: Installation, Prev: Introduction 1.1 Requirements ================ -Before using 'mf2pt1', you will need to install the following programs: +Before using ‘mf2pt1’, you will need to install the following programs: Perl - 'mf2pt1' is written in Perl. You will need a Perl interpreter to + ‘mf2pt1’ is written in Perl. You will need a Perl interpreter to run it. MetaPost - 'mf2pt1' actually uses MetaPost, not Metafont, to produce - PostScript output. Specifically, you will need the 'mpost' - executable and the 'mfplain.mp' base file. + ‘mf2pt1’ actually uses MetaPost, not Metafont, to produce + PostScript output. Specifically, you will need the ‘mpost’ + executable and the ‘mfplain.mp’ base file. Type 1 Utilities - Producing properly encoded Type 1 fonts is tricky. 'mf2pt1' + Producing properly encoded Type 1 fonts is tricky. ‘mf2pt1’ delegates the effort to the Type 1 Utilities, specifically, to the - 't1asm' program within that suite. + ‘t1asm’ program within that suite. FontForge (optional) FontForge is a WYSIWYG, but scriptable, Type 1 font-editing - program. Although FontForge is not strictly required for 'mf2pt1' - to produce a Type 1 font, 'mf2pt1' uses FontForge when available to + program. Although FontForge is not strictly required for ‘mf2pt1’ + to produce a Type 1 font, ‘mf2pt1’ uses FontForge when available to autohint the generated Type 1 font, thereby making it look better especially at lower resolutions. @@ -115,7 +115,7 @@ the Type 1 utilities' home page is <https://www.lcdf.org/type/>. designer to hint fonts manually for additional fine-tuning and to convert among a variety of font formats, such as PostScript, TrueType, and X Window fonts. FontForge is strongly recommended as a complement -to 'mf2pt1'. +to ‘mf2pt1’. File: mf2pt1.info, Node: Installation, Prev: Requirements, Up: Introduction @@ -123,51 +123,51 @@ File: mf2pt1.info, Node: Installation, Prev: Requirements, Up: Introduction 1.2 Installation ================ -To install 'mf2pt1', move the 'mf2pt1' executable someplace where your +To install ‘mf2pt1’, move the ‘mf2pt1’ executable someplace where your operating system can find it. If you're running Microsoft Windows, you -should rename the program to 'mf2pt1.pl', so that Windows knows it's a -Perl script. (Alternatively, if you have 'pl2bat', use that to produce -a 'mf2pt1.bat' file, which you can run as simply 'mf2pt1'.) +should rename the program to ‘mf2pt1.pl’, so that Windows knows it's a +Perl script. (Alternatively, if you have ‘pl2bat’, use that to produce +a ‘mf2pt1.bat’ file, which you can run as simply ‘mf2pt1’.) - The next step is to produce a 'mf2pt1.mem' file from the supplied -'mf2pt1.mp'. The command to do this differs from system to system but + The next step is to produce a ‘mf2pt1.mem’ file from the supplied +‘mf2pt1.mp’. The command to do this differs from system to system but is usually something like the following: mpost -progname=mpost -ini mf2pt1 \\dump - Move the resulting 'mf2pt1.mem' file someplace where MetaPost can + Move the resulting ‘mf2pt1.mem’ file someplace where MetaPost can find it. - The 'mf2pt1' documentation (what you're reading now) is written in + The ‘mf2pt1’ documentation (what you're reading now) is written in Texinfo and can therefore easily be converted to a variety of formats: -PDF ('mf2pt1.pdf') +PDF (‘mf2pt1.pdf’) texi2pdf mf2pt1.texi -PostScript ('mf2pt1.ps') +PostScript (‘mf2pt1.ps’) texi2dvi mf2pt1.texi dvips mf2pt1.dvi -o mf2pt1.ps -HTML ('mf2pt1.html') +HTML (‘mf2pt1.html’) makeinfo --html mf2pt1.texi -Info ('mf2pt1.info') +Info (‘mf2pt1.info’) makeinfo mf2pt1.texi -N.B. The 'install-info' command is a convenient way to install -'mf2pt1.info' on your system. +N.B. The ‘install-info’ command is a convenient way to install +‘mf2pt1.info’ on your system. - On Unix, you may also want to generate an 'mf2pt1' man page. The man -page is embedded within the 'mf2pt1' Perl script and can be extracted -with 'pod2man': + On Unix, you may also want to generate an ‘mf2pt1’ man page. The man +page is embedded within the ‘mf2pt1’ Perl script and can be extracted +with ‘pod2man’: - pod2man --center="User Commands" --date="4 December 2021" \ - --release="v2.7" mf2pt1 > mf2pt1.1 + pod2man --center="User Commands" --date="6 July 2024" \ + --release="v2.8" mf2pt1 > mf2pt1.1 -You can then move 'mf2pt1.1' into '/usr/man/man1' or any other man page -directory. Note that the 'mf2pt1' man page is fairly rudimentary. It +You can then move ‘mf2pt1.1’ into ‘/usr/man/man1’ or any other man page +directory. Note that the ‘mf2pt1’ man page is fairly rudimentary. It is primarily a list of the command-line options (*note Font information::) and a pointer to the document that you're reading now. @@ -177,7 +177,7 @@ File: mf2pt1.info, Node: Usage, Next: Future Work, Prev: Introduction, Up: T 2 Usage ******* -'mf2pt1' is fairly straightforward to use. To process a Metafont source +‘mf2pt1’ is fairly straightforward to use. To process a Metafont source file, merely specify the filename: mf2pt1 myfont.mf @@ -185,30 +185,30 @@ file, merely specify the filename: That simple command automatically performs all of the following operations: - 1. Read 'myfont.mf'. + 1. Read ‘myfont.mf’. - 2. Use 'mpost' to convert each character to a separate Encapsulated - PostScript (EPS) file named 'myfont.NUM'. + 2. Use ‘mpost’ to convert each character to a separate Encapsulated + PostScript (EPS) file named ‘myfont.NUM’. 3. Process and merge the EPS files into a single "disassembled" Type 1 - font called 'myfont.pt1'. + font called ‘myfont.pt1’. - 4. Run 't1asm' from the Type 1 Utilities to convert the disassembled - font into a true, binary Type 1 font called 'myfont.pfb'. + 4. Run ‘t1asm’ from the Type 1 Utilities to convert the disassembled + font into a true, binary Type 1 font called ‘myfont.pfb’. - 5. Invoke 'fontforge' to apply rendering hints to 'myfont.pfb' and to + 5. Invoke ‘fontforge’ to apply rendering hints to ‘myfont.pfb’ and to attempt to remove overlapping paths. - The external programs launched by 'mf2pt1'--'mpost', 't1asm', and -'fontforge'--can be overridden by setting the eponymous, uppercase + The external programs launched by ‘mf2pt1’--‘mpost’, ‘t1asm’, and +‘fontforge’--can be overridden by setting the eponymous, uppercase environment variable. For example, invoking FontForge's predecessor, PfaEdit, instead of FontForge is simply a matter of setting the -'FONTFORGE' environment variable to 'pfaedit' before invoking 'mf2pt1'. -As a corollary, you can inhibit an 'mf2pt1' external program from +‘FONTFORGE’ environment variable to ‘pfaedit’ before invoking ‘mf2pt1’. +As a corollary, you can inhibit an ‘mf2pt1’ external program from running by setting the corresponding environment variable to the name of a nonexistent program. Arguments can be included in the environment -variable's value. Hence, defining 'MPOST' to 'mpost -recorder', for -instance, instructs 'mf2pt1' to run 'mpost' with the '-recorder' option. +variable's value. Hence, defining ‘MPOST’ to ‘mpost -recorder’, for +instance, instructs ‘mf2pt1’ to run ‘mpost’ with the ‘-recorder’ option. * Menu: @@ -224,46 +224,46 @@ File: mf2pt1.info, Node: Restrictions, Next: Font information, Prev: Usage, 2.1 Restrictions ================ -If 'mf2pt1' sounds too good to be true, it is--somewhat. 'mf2pt1' is +If ‘mf2pt1’ sounds too good to be true, it is--somewhat. ‘mf2pt1’ is not a general-purpose Metafont-to-Type 1 converter. Rather, it can convert only certain Metafont constructs. This is not a showstopper for -new fonts designed with 'mf2pt1' in mind, but it is unlikely that -'mf2pt1' will work on an arbitrary Metafont source file. +new fonts designed with ‘mf2pt1’ in mind, but it is unlikely that +‘mf2pt1’ will work on an arbitrary Metafont source file. - 'mf2pt1''s biggest restriction is that each glyph must be drawn + ‘mf2pt1’'s biggest restriction is that each glyph must be drawn entirely from closed paths, using Metafont's *fill* and *unfill* -commands. ('mf2pt1' has limited support for *draw* and *undraw*, but +commands. (‘mf2pt1’ has limited support for *draw* and *undraw*, but their use is currently discouraged. *filldraw* and *unfilldraw* issue a warning message and invoke *draw* and *undraw*, respectively.) The Type 1 format requires that these paths be nonoverlapping. The following are some of the alternatives for removing path overlaps: 1. Install FontForge. As part of its final step in producing a Type 1 - font, 'mf2pt1' instructs FontForge to replace overlapping paths + font, ‘mf2pt1’ instructs FontForge to replace overlapping paths with nonoverlapping paths. 2. Remove overlaps using Metafont code within the font program itself. - A '.zip' file attachment to a 6 January 2005 article + A ‘.zip’ file attachment to a 6 January 2005 article (https://tug.org/pipermail/metapost/2005-January/000080.html) by Boguslaw Jackowski on the MetaPost mailing list (subject: "Re: all intersections between two paths") includes a MetaPost library which assists with that task. The library provides a *find_outlines* command which can be used to define a path as the union of two other paths. A number of MetaPost example programs are also - included in the '.zip' file. + included in the ‘.zip’ file. 3. Design your fonts from the beginning without using overlapping paths. - A secondary restriction is that 'mf2pt1' redefines a number of Plain + A secondary restriction is that ‘mf2pt1’ redefines a number of Plain Metafont commands, such as *beginchar*, *fill*, and *unfill*. Metafont font programs which redefine or bypass these (using Metafont primitives) -will not be convertible with 'mf2pt1'. +will not be convertible with ‘mf2pt1’. - A far less severe restriction is due to 'mf2pt1''s utilizing + A far less severe restriction is due to ‘mf2pt1’'s utilizing MetaPost's Metafont interface instead of Metafont itself. The -implication is that commands not defined by MetaPost's 'mfplain.mp' -cannot be handled by 'mf2pt1', either. Very few fonts will have a +implication is that commands not defined by MetaPost's ‘mfplain.mp’ +cannot be handled by ‘mf2pt1’, either. Very few fonts will have a problem with this restriction but see the MetaPost manual for more information. @@ -279,7 +279,7 @@ These include features such as the font's x-height, quad width, interword stretchability and shrinkability, and other design characteristics that TeX makes use of. PostScript fonts utilize a largely different set of font parameters, such as the underline position -and thickness, font family name, and copyright notice. 'mf2pt1' +and thickness, font family name, and copyright notice. ‘mf2pt1’ provides Metafont commands to define the PostScript font parameters in the generated Type 1 font. These parameters should appear in the Metafont source file as follows: @@ -288,9 +288,9 @@ Metafont source file as follows: ... fi -'ps_output' is defined by 'mf2pt1' but not by Plain Metafont. Checking +‘ps_output’ is defined by ‘mf2pt1’ but not by Plain Metafont. Checking if it is known is the recommended way to determine if the font is being -built under 'mf2pt1'. +built under ‘mf2pt1’. * Menu: @@ -306,23 +306,23 @@ File: mf2pt1.info, Node: Parameters, Next: Command-line equivalents, Prev: Fo ---------------- The following list presents all of the font-information commands -provided by 'mf2pt1' and describes what each command means. Commands +provided by ‘mf2pt1’ and describes what each command means. Commands marked with an asterisk are also defined by Plain Metafont and therefore -do not need to be enveloped within a test for 'ps_output'. +do not need to be enveloped within a test for ‘ps_output’. *font_coding_scheme* The mapping between character numbers and PostScript names. If - this is the name of a file, 'mf2pt1' expects it to contain + this is the name of a file, ‘mf2pt1’ expects it to contain PostScript code defining a font-encoding vector. *Note Custom font encodings::, for an example of such a file. If - *font_coding_scheme* is not the name of a file, 'mf2pt1' expects it - to be one of the literal strings 'standard' (Adobe standard - encoding), 'isolatin1' (ISO Latin 1 encoding), 'ot1' (TeX 7-bit - encoding), 't1' (TeX 8-bit encoding), or 'asis' (encoding + *font_coding_scheme* is not the name of a file, ‘mf2pt1’ expects it + to be one of the literal strings ‘standard’ (Adobe standard + encoding), ‘isolatin1’ (ISO Latin 1 encoding), ‘ot1’ (TeX 7-bit + encoding), ‘t1’ (TeX 8-bit encoding), or ‘asis’ (encoding integrated with the character programs using the *glyph_name* command as described in *note Custom font encodings::). Anything - else will generate a warning message and cause 'mf2pt1' to use - 'standard' instead. + else will generate a warning message and cause ‘mf2pt1’ to use + ‘standard’ instead. *font_comment* A textual comment that will appear within the generated font. This @@ -330,20 +330,20 @@ do not need to be enveloped within a test for 'ps_output'. *font_family* The family that this font belongs to. For example, "Utopia Bold - Italic" belongs to the 'Utopia' family. + Italic" belongs to the ‘Utopia’ family. *font_fixed_pitch* Whether the font is monospaced (if *true*) or or proportionally spaced (if *false*). *font_identifier (*)* - The full name of the font, e.g., 'Utopia Bold Italic'. + The full name of the font, e.g., ‘Utopia Bold Italic’. *font_name* The symbolic font name, used to load the font from a PostScript document. Spaces are forbidden. Generally, the font name is of - the form 'FAMILY-MODIFIERS'. For example, the font name of Utopia - Bold Italic would be 'Utopia-BoldItalic'. + the form ‘FAMILY-MODIFIERS’. For example, the font name of Utopia + Bold Italic would be ‘Utopia-BoldItalic’. *font_size (*)* The font design size. This is specified in "sharped" units within @@ -351,7 +351,7 @@ do not need to be enveloped within a test for 'ps_output'. *font_slant (*)* When specified with *font_slant*, the amount of slant per point. - When specified with '--italicangle', the angle in counterclockwise + When specified with ‘--italicangle’, the angle in counterclockwise degrees from the vertical (i.e., zero for an upright font, negative for a right-slanting italic font). @@ -369,18 +369,18 @@ do not need to be enveloped within a test for 'ps_output'. 16,777,215, with the "open" range being 4,000,000-4,999,999. All IDs not in that range are allocated by contacting Adobe's UniqueID Coordinator. (I don't believe a fee is involved, but I don't know - for sure.) If a unique ID is not specified, 'mf2pt1' will not + for sure.) If a unique ID is not specified, ‘mf2pt1’ will not write a unique ID to the file. Note that Adobe no longer recommends including unique IDs in fonts. *font_version* The version number of the font. This should be of the form - 'MMM.MMM', where MMM is the major version number and MMM is the + ‘MMM.MMM’, where MMM is the major version number and MMM is the minor version number. *font_weight* The font weight. For example, the font weight of Utopia Bold - Italic is 'Bold'. + Italic is ‘Bold’. File: mf2pt1.info, Node: Command-line equivalents, Next: Default values, Prev: Parameters, Up: Font information @@ -392,36 +392,36 @@ Each of the font-information commands listed in *note Parameters:: has a command-line equivalent. Their use is discouraged but they are listed here for completeness: -*font_coding_scheme* '--encoding' +*font_coding_scheme* ‘--encoding’ -*font_comment* '--comment' +*font_comment* ‘--comment’ -*font_family* '--family' +*font_family* ‘--family’ -*font_fixed_pitch* '--fixedpitch' +*font_fixed_pitch* ‘--fixedpitch’ -*font_identifier* '--fullname' +*font_identifier* ‘--fullname’ -*font_name* '--name' +*font_name* ‘--name’ -*font_size* '--designsize' +*font_size* ‘--designsize’ -*font_slant* '--italicangle' +*font_slant* ‘--italicangle’ -*font_underline_position* '--underpos' +*font_underline_position* ‘--underpos’ -*font_underline_thickness* '--underthick' +*font_underline_thickness* ‘--underthick’ -*font_unique_id* '--uniqueid' +*font_unique_id* ‘--uniqueid’ -*font_version* '--fontversion' +*font_version* ‘--fontversion’ -*font_weight* '--weight' +*font_weight* ‘--weight’ - A special case is '--fixedpitch' which does not take an argument. -Rather, you should use '--fixedpitch' as the equivalent of -'font_fixed_pitch true' and '--nofixedpitch' as the equivalent of -'font_fixed_pitch false'. + A special case is ‘--fixedpitch’ which does not take an argument. +Rather, you should use ‘--fixedpitch’ as the equivalent of +‘font_fixed_pitch true’ and ‘--nofixedpitch’ as the equivalent of +‘font_fixed_pitch false’. File: mf2pt1.info, Node: Default values, Next: Parameter example, Prev: Command-line equivalents, Up: Font information @@ -432,11 +432,11 @@ File: mf2pt1.info, Node: Default values, Next: Parameter example, Prev: Comma The next table lists the Metafont type and default value of each of the parameters listed in *note Parameters::. -*font_coding_scheme* *string* '"standard"' +*font_coding_scheme* *string* ‘"standard"’ -*font_comment* *string* '"Font converted to +*font_comment* *string* ‘"Font converted to Type 1 by mf2pt1, written - by Scott Pakin."' + by Scott Pakin."’ *font_family* *string* (The value of *font_identifier*) @@ -444,7 +444,7 @@ parameters listed in *note Parameters::. *font_fixed_pitch* *boolean* *false* *font_identifier* *string* (The input filename, - minus '.mf') + minus ‘.mf’) *font_name* *string* (The value of *font_family*, plus an @@ -453,7 +453,7 @@ parameters listed in *note Parameters::. with all spaces removed) *font_size* *numeric* (Must be specified or - 'mf2pt1' will abort with + ‘mf2pt1’ will abort with an error message) *font_slant* *numeric* 0 @@ -466,9 +466,9 @@ parameters listed in *note Parameters::. the range 4000000-4999999) -*font_version* *string* '"001.000"' +*font_version* *string* ‘"001.000"’ -*font_weight* *string* '"Medium"' +*font_weight* *string* ‘"Medium"’ @@ -478,11 +478,11 @@ File: mf2pt1.info, Node: Parameter example, Prev: Default values, Up: Font in ----------------------- As an example, the following Metafont code shows the usage of all of the -parameters that 'mf2pt1' accepts: +parameters that ‘mf2pt1’ accepts: if known ps_output: font_coding_scheme "ot1"; - font_comment "Copyright (C) 2021 Scott Pakin."; + font_comment "Copyright (C) 2005-2024 Scott Pakin."; font_family "Kerplotz"; font_fixed_pitch false; font_identifier "Kerplotz Light Oblique"; @@ -492,8 +492,7 @@ if known ps_output: font_slant 1/6; font_underline_position -1pt#; font_underline_thickness 1/2pt#; - font_unique_id "4112233"; % Better to omit - this. + font_unique_id "4112233"; % Better to omit this. font_version "002.005"; font_weight "Light"; fi @@ -501,12 +500,12 @@ fi In the above, the *font_fixed_pitch* call could have been omitted, as it defaults to *false*. Also, unless you've requested a unique ID from Adobe, it's generally better not to assign *font_unique_id*; let -'mf2pt1' choose a random value itself. +‘mf2pt1’ choose a random value itself. The same parameters can also be specified on the command line as follows: - mf2pt1 --encoding=ot1 --comment="Copyright (C) 2021 Scott Pakin." + mf2pt1 --encoding=ot1 --comment="Copyright (C) 2005-2024 Scott Pakin." --family=Kerplotz --nofixedpitch --fullname="Kerplotz Light Oblique" --name=Kerplotz-LightOblique --designsize=10 --italicangle=-9.5 --underpos=-100 --underthick=50 --uniqueid=4112233 --version=002.005 @@ -516,7 +515,7 @@ Note that a Metafont font slant of 1/6 is equal to a PostScript italic angle of approximately -9.5. The conversion formula is slant = -tan(angle). In addition, the underline position and thickness must be multiplied by 1000/*font_size* to convert from the Metafont units that -are used within the '.mf' file to the PostScript units that are used on +are used within the ‘.mf’ file to the PostScript units that are used on the command line. @@ -526,29 +525,29 @@ File: mf2pt1.info, Node: Additional command-line options, Next: Custom font en =================================== In addition to the command-line options for setting font parameters that -were presented in *note Parameters::, 'mf2pt1' supports a '--rounding' -option. While 'mf2pt1' normally rounds all font coordinates to the -nearest integer, '--rounding' increases coordinate precision by -instructing 'mf2pt1' to round instead to the nearest multiple of a given -fractional number. For example, '--rounding=0.25' rounds the coordinate +were presented in *note Parameters::, ‘mf2pt1’ supports a ‘--rounding’ +option. While ‘mf2pt1’ normally rounds all font coordinates to the +nearest integer, ‘--rounding’ increases coordinate precision by +instructing ‘mf2pt1’ to round instead to the nearest multiple of a given +fractional number. For example, ‘--rounding=0.25’ rounds the coordinate (7.4, 10.3) to (7.5, 10.25) while it would otherwise be rounded to the less-precise (7, 10). Large glyphs can be problematic in MetaPost and therefore in -'mf2pt1'. Unlike Metafont, MetaPost does not honor 'mag' for magnifying +‘mf2pt1’. Unlike Metafont, MetaPost does not honor ‘mag’ for magnifying dimensions. Rather, the number of PostScript (a.k.a. "big") points per -pixel--'bpppix'--is hardwired to 0.02 and all other dimensions ('mm', -'in', 'pt', etc.) are expressed in terms of that. Consequently, glyphs +pixel--‘bpppix’--is hardwired to 0.02 and all other dimensions (‘mm’, +‘in’, ‘pt’, etc.) are expressed in terms of that. Consequently, glyphs that multiply a large number of font units by a dimension are likely to exceed 4096, the largest value that MetaPost can represent in its fixed-point format. If numerical overflow becomes a problem you can use -the '--bpppix' option to 'mf2pt1' to change the value of 'bpppix'. For -example, specifying '--bpppix=0.2' enables a tenfold increase in maximum +the ‘--bpppix’ option to ‘mf2pt1’ to change the value of ‘bpppix’. For +example, specifying ‘--bpppix=0.2’ enables a tenfold increase in maximum glyph size (with a corresponding decrease in precision). - After generating a Type 1 font, 'mf2pt1' runs it through FontForge to + After generating a Type 1 font, ‘mf2pt1’ runs it through FontForge to add hinting information, remove overlaps, and otherwise clean up the -generated font. The '--ffscript' option specifies the filename of a +generated font. The ‘--ffscript’ option specifies the filename of a FontForge script to use instead of the default script, which is listed below: @@ -566,10 +565,10 @@ below: See the FontForge documentation for an explanation of each of those commands and a description of other commands made available to FontForge -scripts. 'mf2pt1' runs the script with one argument ('$1'), which is -the name of the generated '.pfb' file. +scripts. ‘mf2pt1’ runs the script with one argument (‘$1’), which is +the name of the generated ‘.pfb’ file. - 'mf2pt1' also supports a '--help' option which summarizes all of the + ‘mf2pt1’ also supports a ‘--help’ option which summarizes all of the program's command-line options. @@ -579,12 +578,12 @@ File: mf2pt1.info, Node: Custom font encodings, Next: Restoring mfplain defaul ========================= *note Parameters::, lists the font encodings currently supported by -'mf2pt1' and mentions that an alternate encoding can be specified by +‘mf2pt1’ and mentions that an alternate encoding can be specified by providing the name of an encoding file. To elaborate, the following example represents the contents of an encoding file which defines a--largely useless nowadays--EBCDIC font encoding: - '% Sample encoding vector: EBCDIC + ‘% Sample encoding vector: EBCDIC % The encoding vector must have a name and be defined as a PostScript array. @@ -614,23 +613,23 @@ a--largely useless nowadays--EBCDIC font encoding: /_a237 /_a238 /_a239 /zero /one /two /three /four /five /six /seven /eight /nine /_a250 /_a251 /_a252 /_a253 /_a254 /_a255 % Don't forget to end the array. - ] def' + ] def’ All entries in the encoding vector are PostScript "names" and therefore must be prefixed with a slash. Unnamed characters such as -control characters are commonly named '_aNUMBER', where NUMBER is the +control characters are commonly named ‘_aNUMBER’, where NUMBER is the decimal offset into the character table. Undefined characters are -indicated by '.notdef'. In the EBCDIC example, the character at -position 0 in the font will be named 'a0'; the character at position 1 -will be named 'a1'; the character at position 74 will be named -'bracketleft'; the character at position 129 will be named 'a'; and so +indicated by ‘.notdef’. In the EBCDIC example, the character at +position 0 in the font will be named ‘a0’; the character at position 1 +will be named ‘a1’; the character at position 74 will be named +‘bracketleft’; the character at position 129 will be named ‘a’; and so forth. Individual characters can be mapped to an encoding either numerically or by executing a *glyph_name* command within a character definition. For example, the following code overrides the character position passed to *beginchar* (i.e., 123) with whatever character position the current -encoding has designated for the 'ohungarumlaut' glyph: +encoding has designated for the ‘ohungarumlaut’ glyph: beginchar (123, cap_height#-1/2pt#, cap_height#, 0); if known ps_output: @@ -642,17 +641,17 @@ encoding has designated for the 'ohungarumlaut' glyph: File: mf2pt1.info, Node: Restoring mfplain defaults, Prev: Custom font encodings, Up: Usage -2.5 Restoring 'mfplain' defaults +2.5 Restoring ‘mfplain’ defaults ================================ -'mf2pt1' normally redefines *filldraw* as *fill* and *unfilldraw* and +‘mf2pt1’ normally redefines *filldraw* as *fill* and *unfilldraw* as *unfill* because Type 1 fonts don't allow overlapping curves. -Similarly, 'mf2pt1' redefines *pencircle* as a 20-gon to coerce MetaPost +Similarly, ‘mf2pt1’ redefines *pencircle* as a 20-gon to coerce MetaPost into drawing it using a filled instead of a stroked PostScript path. If you know you'll be postprocessing your fonts using FontForge, which can automatically convert overlapping paths to nonoverlapping -paths, then you can restore the original 'mfplain.mp' definitions of +paths, then you can restore the original ‘mfplain.mp’ definitions of *filldraw*, *unfilldraw*, and *pencircle* as follows: if known ps_output: @@ -677,29 +676,29 @@ locations, using commands such as *define_corrected_pixels*, completely different manner. Type 1 hints distinguish key character features, such as stems and dots, from decorations which can be discarded at low resolutions. The PostScript interpreter uses that -information to determine how to map points to pixels. Although 'mf2pt1' +information to determine how to map points to pixels. Although ‘mf2pt1’ employs FontForge to autohint the fonts it generates, the approach is mechanical and unlikely to hint as well as a human can do manually. It -would be convenient for 'mf2pt1' one day to provide Metafont commands +would be convenient for ‘mf2pt1’ one day to provide Metafont commands for *hstem*, *vstem*, *dotsection*, and the other Type 1 hints. That way, hints will no longer need to be re-added manually every time -'mf2pt1' regenerates a Type 1 font. +‘mf2pt1’ regenerates a Type 1 font. - Another future addition to 'mf2pt1' is the addition of more font -encodings. The following are the encodings that 'mf2pt1' will most + Another future addition to ‘mf2pt1’ is the addition of more font +encodings. The following are the encodings that ‘mf2pt1’ will most likely accept: -'TeXMathItalicEncoding' +‘TeXMathItalicEncoding’ Upper- and lowercase Greek and Latin letters, old-style digits, and a few symbols and accents. -'TeXMathSymbolEncoding' +‘TeXMathSymbolEncoding’ A variety of symbols, as well as calligraphic Latin majuscules. -'TeXMathExtensionEncoding' +‘TeXMathExtensionEncoding’ Variable-sized symbols, such as braces, integrals, and radicals. -'AdobeExpert' +‘AdobeExpert’ Small caps, currency symbols, old-style digits, and various superior and inferior letters and digits. @@ -710,43 +709,43 @@ Acknowledgments *************** Many thanks are owed to Werner Lemberg for writing the code underlying -the '--rounding' option; for introducing the *glyph_name* command and -'asis' encoding vector; for providing the default FontForge script +the ‘--rounding’ option; for introducing the *glyph_name* command and +‘asis’ encoding vector; for providing the default FontForge script listed in *note Additional command-line options::; for fixing some -code-generation bugs in 'mf2pt1'; for finding a more robust way to dump -'mf2pt1.mem'; for directing me to the overlap-removal code mentioned in +code-generation bugs in ‘mf2pt1’; for finding a more robust way to dump +‘mf2pt1.mem’; for directing me to the overlap-removal code mentioned in *note Restrictions::; for supplying the _crossproduct_, _makeline_, and -_is_clockwise_ functions used by 'mf2pt1.mp'; for proposing the -'--bpppix' command-line option; and for suggesting various features and -improvements to 'mf2pt1'. Thanks also go to Werner Lemberg and Boguslaw -Jackowski for updating the *is_clockwise* function in 'mf2pt1.mp' to +_is_clockwise_ functions used by ‘mf2pt1.mp’; for proposing the +‘--bpppix’ command-line option; and for suggesting numerous features and +improvements to ‘mf2pt1’. Thanks also go to Werner Lemberg and Boguslaw +Jackowski for updating the *is_clockwise* function in ‘mf2pt1.mp’ to work around a bug in MetaPost which relates to the *turningnumber* command. Finally, thanks go to Ralf Stubner for providing the T1 encoding vector and for pointing out a typo in the generated font programs; to Michael Zedler for alerting me to problems with -'--encoding' and suggesting I modify that option to accept PostScript -'.enc' files; and to Michael Ummels for fixing a couple of bugs that +‘--encoding’ and suggesting I modify that option to accept PostScript +‘.enc’ files; and to Michael Ummels for fixing a couple of bugs that made character widths in the generated fonts slightly too large. Tag Table: -Node: Top628 -Node: Introduction1166 -Node: Requirements2998 -Node: Installation4731 -Node: Usage6545 -Node: Restrictions8449 -Node: Font information10827 -Node: Parameters12185 -Node: Command-line equivalents15660 -Node: Default values17141 -Node: Parameter example19361 -Node: Additional command-line options21370 -Node: Custom font encodings23710 -Node: Restoring mfplain defaults27160 -Node: Future Work28019 -Node: Acknowledgments29883 +Node: Top627 +Node: Introduction1177 +Node: Requirements3025 +Node: Installation4798 +Node: Usage6696 +Node: Restrictions8688 +Node: Font information11122 +Node: Parameters12496 +Node: Command-line equivalents16047 +Node: Default values17600 +Node: Parameter example19844 +Node: Additional command-line options21843 +Node: Custom font encodings24275 +Node: Restoring mfplain defaults27761 +Node: Future Work28635 +Node: Acknowledgments30535 End Tag Table diff --git a/Master/texmf-dist/doc/support/mf2pt1/ChangeLog b/Master/texmf-dist/doc/support/mf2pt1/ChangeLog index a8e6d2d9105..6df8f950676 100644 --- a/Master/texmf-dist/doc/support/mf2pt1/ChangeLog +++ b/Master/texmf-dist/doc/support/mf2pt1/ChangeLog @@ -1,4 +1,15 @@ -2021-12-04 Scott Pakin <pakin@pakin.org> +2024-07-06 Scott Pakin <scott+mf@pakin.org> + + * README, mf2pt1.texi, mf2pt1.mp, mf2pt1.pl: Updated the copyright + year to 2024. + + * mf2pt1.pl: Applied a patch from Werner Lemberg <wl@gnu.org> that + adds extrema later in the FontForge postprocessing script. This + patch originally was submitted as a LilyPond merge request + (https://gitlab.com/lilypond/lilypond/-/merge_requests/2374). + Updated the program version to 2.8. + +2021-12-04 Scott Pakin <scott+mf@pakin.org> * README, mf2pt1.texi: Updated the copyright year to 2021. @@ -7,7 +18,7 @@ already exist. Updated the copyright year to 2021. Updated the version to 2.7. -2021-11-28 Scott Pakin <pakin@pakin.org> +2021-11-28 Scott Pakin <scott+mf@pakin.org> * Makefile, mf2pt1.pl, mf2pt1.texi: Documented that environment variables for programs can now include @@ -18,13 +29,13 @@ commands to be overridden by environment variables that can also include program parameters. -2021-11-27 Scott Pakin <pakin@pakin.org> +2021-11-27 Scott Pakin <scott+mf@pakin.org> * mf2pt1.pl: Introduced a --save-temps option to suppress deletion of intermediate files. -2020-11-27 Scott Pakin <pakin@pakin.org> +2020-11-27 Scott Pakin <scott+mf@pakin.org> * ChangeLog, README, mf2pt1.mp, mf2pt1.pl, mf2pt1.texi: mf2pt1 no longer generates a UniqueID automatically, only when diff --git a/Master/texmf-dist/doc/support/mf2pt1/README b/Master/texmf-dist/doc/support/mf2pt1/README index 0eb57ca8fcf..e101952ff99 100644 --- a/Master/texmf-dist/doc/support/mf2pt1/README +++ b/Master/texmf-dist/doc/support/mf2pt1/README @@ -27,7 +27,7 @@ For installation instructions, see the mf2pt1 manual (mf2pt1.pdf). Copyright and license --------------------- -Copyright (C) 2005-2021 Scott Pakin, scott+mf@pakin.org +Copyright (C) 2005-2024 Scott Pakin, scott+mf@pakin.org This package may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3c of this diff --git a/Master/texmf-dist/doc/support/mf2pt1/mf2pt1.pdf b/Master/texmf-dist/doc/support/mf2pt1/mf2pt1.pdf Binary files differindex a28895171a0..e702482c745 100644 --- a/Master/texmf-dist/doc/support/mf2pt1/mf2pt1.pdf +++ b/Master/texmf-dist/doc/support/mf2pt1/mf2pt1.pdf diff --git a/Master/texmf-dist/doc/support/mf2pt1/mf2pt1.texi b/Master/texmf-dist/doc/support/mf2pt1/mf2pt1.texi index 9260689d18c..f18ed6694cf 100644 --- a/Master/texmf-dist/doc/support/mf2pt1/mf2pt1.texi +++ b/Master/texmf-dist/doc/support/mf2pt1/mf2pt1.texi @@ -11,7 +11,7 @@ @c %**end of header @copying -Copyright @copyright{} 2005--2021 Scott Pakin +Copyright @copyright{} 2005--2024 Scott Pakin @sp 2 @@ -30,8 +30,8 @@ version 2006/05/20 or later. @end copying -@set VERSION 2.7 -@set DATE 4 December 2021 +@set VERSION 2.8 +@set DATE 6 July 2024 @c Define some fonts we intend to use. @iftex @@ -679,9 +679,9 @@ parameters that @command{mf2pt1} accepts: @noindent @b{if} known @i{ps_output}: -@multitable {@b{if}} {@b{font_underline_thickness}} {@t{"Copyright (C) 2021 Scott Pakin.";}} +@multitable {@b{if}} {@b{font_underline_thickness}} {@t{"Copyright (C) 2005-2024 Scott Pakin.";}} @item @tab @b{font_coding_scheme} @tab @t{"ot1"}; -@item @tab @b{font_comment} @tab @t{"Copyright (C) 2021 Scott Pakin."}; +@item @tab @b{font_comment} @tab @t{"Copyright (C) 2005-2024 Scott Pakin."}; @item @tab @b{font_family} @tab @t{"Kerplotz"}; @item @tab @b{font_fixed_pitch} @tab @b{false}; @item @tab @b{font_identifier} @tab @t{"Kerplotz Light Oblique"}; @@ -708,7 +708,7 @@ The same parameters can also be specified on the command line as follows: @example -mf2pt1 --encoding=ot1 --comment="Copyright (C) 2021 Scott Pakin." +mf2pt1 --encoding=ot1 --comment="Copyright (C) 2005-2024 Scott Pakin." --family=Kerplotz --nofixedpitch --fullname="Kerplotz Light Oblique" --name=Kerplotz-LightOblique --designsize=10 --italicangle=-9.5 --underpos=-100 --underthick=50 --uniqueid=4112233 --version=002.005 @@ -881,7 +881,7 @@ character position the current encoding has designated for the @section Restoring @file{mfplain} defaults @command{mf2pt1} normally redefines @strong{filldraw} as @strong{fill} -and @strong{unfilldraw} and @strong{unfill} because @w{Type 1} fonts +and @strong{unfilldraw} as @strong{unfill} because @w{Type 1} fonts don't allow overlapping curves. Similarly, @command{mf2pt1} redefines @strong{pencircle} as a 20-gon to coerce MetaPost into drawing it using a filled instead of a stroked PostScript path. @@ -957,7 +957,7 @@ more robust way to dump @file{mf2pt1.mem}; for directing me to the overlap-removal code mentioned in @ref{Restrictions}; for supplying the @emph{crossproduct}, @emph{makeline}, and @emph{is_clockwise} functions used by @file{mf2pt1.mp}; for proposing the @copt{bpppix} -command-line option; and for suggesting various features and +command-line option; and for suggesting numerous features and improvements to @command{mf2pt1}. Thanks also go to Werner Lemberg and @iftex |