diff options
author | Karl Berry <karl@freefriends.org> | 2012-04-16 23:15:11 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2012-04-16 23:15:11 +0000 |
commit | e8a389a2d60b6ff53118a05f72c266fc3bd725b0 (patch) | |
tree | a684b2e593b0f7cede10362be9fe321f733e1acc /Master/texmf | |
parent | c3c415e17085b0a75a89e652d576f6a943a41649 (diff) |
fontools (6mar12)
git-svn-id: svn://tug.org/texlive/trunk@25995 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf')
-rw-r--r-- | Master/texmf/doc/man/man1/afm2afm.1 | 185 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/afm2afm.man1.pdf | bin | 5765 -> 5398 bytes | |||
-rw-r--r-- | Master/texmf/doc/man/man1/autoinst.1 | 629 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/autoinst.man1.pdf | bin | 25069 -> 29341 bytes | |||
-rw-r--r-- | Master/texmf/doc/man/man1/cmap2enc.1 | 450 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/cmap2enc.man1.pdf | bin | 16975 -> 0 bytes | |||
-rw-r--r-- | Master/texmf/doc/man/man1/font2afm.1 | 196 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/font2afm.man1.pdf | bin | 5311 -> 0 bytes | |||
-rw-r--r-- | Master/texmf/doc/man/man1/ot2kpx.1 | 186 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/ot2kpx.man1.pdf | bin | 6021 -> 7539 bytes | |||
-rw-r--r-- | Master/texmf/doc/man/man1/pfm2kpx.1 | 208 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/pfm2kpx.man1.pdf | bin | 6179 -> 0 bytes | |||
-rw-r--r-- | Master/texmf/doc/man/man1/showglyphs.1 | 185 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/showglyphs.man1.pdf | bin | 4582 -> 0 bytes |
14 files changed, 528 insertions, 1511 deletions
diff --git a/Master/texmf/doc/man/man1/afm2afm.1 b/Master/texmf/doc/man/man1/afm2afm.1 index d190f994365..d15c5cb8b21 100644 --- a/Master/texmf/doc/man/man1/afm2afm.1 +++ b/Master/texmf/doc/man/man1/afm2afm.1 @@ -1,26 +1,11 @@ -.\" Automatically generated by Pod::Man version 1.15 -.\" Thu Jan 12 09:06:57 2006 +.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) .\" .\" Standard preamble: -.\" ====================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. +.\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. .de Vb \" Begin verbatim text .ft CW .nf @@ -28,16 +13,15 @@ .. .de Ve \" End verbatim text .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. | will give a -.\" real vertical bar. \*(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-|\(bv\*(Tr +.\" 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' .ie n \{\ . ds -- \(*W- @@ -56,26 +40,28 @@ . ds R" '' 'br\} .\" -.\" If the F register is turned on, we'll generate index entries on stderr -.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and -.\" index entries marked with X<> in POD. Of course, you'll have to process -.\" the output yourself in some meaningful fashion. -.if \nF \{\ +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" +.\" If the F register is turned on, we'll generate index entries on stderr for +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index +.\" entries marked with X<> in POD. Of course, you'll have to process the +.\" output yourself in some meaningful fashion. +.ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it -.\" makes way too many mistakes in technical documents. -.hy 0 -.if n .na +.el \{\ +. de IX +.. +.\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. -.bd B 3 . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 @@ -135,80 +121,79 @@ . ds Ae AE .\} .rm #[ #] #H #V #F C -.\" ====================================================================== +.\" ======================================================================== .\" .IX Title "AFM2AFM 1" -.TH AFM2AFM 1 "fontools" "2006-01-12" "fontools" -.UC +.TH AFM2AFM 1 "2012-03-06" "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" -afm2afm \- reencode an \fIafm\fR file +afm2afm \- reencode an afm file .SH "SYNOPSIS" .IX Header "SYNOPSIS" -afm2afm \fB\-e\fR \fIencoding\fR [\fB\-o\fR \fIoutput\fR] \fIafmfile\fR +.IP "\fBafm2afm\fR" 8 +.IX Item "afm2afm" +[\fB\-help\fR] +[\fB\-encoding\fR \fIencodingfile\fR] +[\fB\-output\fR \fIoutputfile\fR] +\&\fBafmfile\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" -This program reencodes an \fIafm\fR file. It's mainly intended to be used with -\&\fIafm\fR files that were extracted from TrueType or OpenType fonts, since these -are often too big to be handled with tools like \fIfontinst\fR (Adobe's -CaflischScriptPro-Regular font, for example, contains 1289 glyphs and -278678 kerning pairs, leading to an \fIafm\fR file of nearly 9MB). +\&\fBafm2afm\fR re-encodes an \fIafm\fR file. +.PP +Metrics (including kerning data) for characters not present in the +chosen encoding are excluded from the output, which resuls in +much smaller files. +.PP +Note that if you don't specify an encoding file, the \fIafm\fR file +isn't re-encoded, but the unused data is still pruned. .PP -Glyphs that are absent from the chosen encoding aren't written to the output, -which yields much smaller output files. +The program also generates an entry for a \fIdvips\fR\-style map file, +but only if the \fIafm\fR file has been re-encoded and +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 +.IX Item "-help" +Print a short description of the syntax +.IP "\fB\-encoding\fR \fIencodingfile\fR" 4 +.IX Item "-encoding encodingfile" +Re-encode to the enconding in \fIencodingfile\fR +.IP "\fB\-output\fR \fIoutputfile\fR" 4 +.IX Item "-output outputfile" +Write the result to \fIoutputfile\fR instead of \f(CW\*(C`stdout\*(C'\fR. +.IP "\fBafmfile\fR" 4 +.IX Item "afmfile" +The \fIafm\fR file to be re-encoded. .PP -The program also generates an entry for a \fIdvips\fR\-style map file. -.SH "OPTIONS" -.IX Header "OPTIONS" -Option names were chosen to match those of \fIttf2afm\fR. -.Ip "\fB\-e\fR \fIencoding\fR" 4 -.IX Item "-e encoding" -Reencode using the encoding given in file \fIencoding\fR. -.Ip "\fB\-o\fR \fIoutput\fR" 4 -.IX Item "-o output" -Write the reencoded \fIafm\fR to file \fIoutput\fR instead of \f(CW\*(C`stdout\*(C'\fR. -The mapfile entry will still be written to \f(CW\*(C`stdout\*(C'\fR. -.SH "FILES" -.IX Header "FILES" -All input files are searched using \fBkpsewhich\fR or \fBfindtexmf\fR when these -commands are available; otherwise only the current working directory -is searched. -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIautoinst\fR, \fIcmap2enc\fR, \fIfont2afm\fR, \fIot2kpx\fR, \fIpfm2kpx\fR. +Option names may be shortened to a unique prefix. .SH "AUTHOR" .IX Header "AUTHOR" -Marc Penninga <marc@penninga.info> -.SH "HISTORY" -.IX Header "HISTORY" -.Ip "\fI2005\-01\-10\fR" 12 -.IX Item "2005-01-10" -First version -.Ip "\fI2005\-01\-25\fR" 12 -.IX Item "2005-01-25" -Added printing of mapfile entry -.Ip "\fI2005\-02\-18\fR" 12 -.IX Item "2005-02-18" -Rewrote some of the code -.Ip "\fI2005\-03\-08\fR" 12 -.IX Item "2005-03-08" -Input files searched via \fBkpsewhich\fR (where available) -.Ip "\fI2005\-03\-15\fR" 12 -.IX Item "2005-03-15" -Input files searched using \fBkpsewhich\fR or \fBfindtexmf\fR (if available) -.Ip "\fI2005\-04\-15\fR" 12 -.IX Item "2005-04-15" -Updated creation of mapfile entry; look for font file to deduce the correct -font file format (pfb, pfa, ttf). If no font file is found, -pfb is assumed. -.Ip "\fI2005\-04\-20\fR" 12 -.IX Item "2005-04-20" -Program quits if the specified output file exists -.Ip "\fI2005\-04\-29\fR" 12 -.IX Item "2005-04-29" -Improved the documentation -.Ip "\fI2005\-07\-29\fR" 12 -.IX Item "2005-07-29" -Some updates to the documentation -.Ip "\fI2006\-01\-12\fR" 12 -.IX Item "2006-01-12" -A few minor changes to the code +Marc Penninga <marcpenninga@gmail.com> +.SH "COPYRIGHT" +.IX Header "COPYRIGHT" +Copyright (C) 2005\-2012 Marc Penninga. +.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 +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 \fBautoinst\fR; +see the file \fIGPLv2.txt\fR. +.SH "DISCLAIMER" +.IX Header "DISCLAIMER" +This program is distributed in the hope that it will be useful, +but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of +\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0. +See the \s-1GNU\s0 General Public License for more details. +.SH "RECENT CHANGES" +.IX Header "RECENT CHANGES" +(See the source code for the rest of the story.) +.IP "\fI2012\-02\-01\fR" 12 +.IX Item "2012-02-01" +Refactored the code; added the \*(L"no re-encoding, only pruning\*(R" +functionality. diff --git a/Master/texmf/doc/man/man1/afm2afm.man1.pdf b/Master/texmf/doc/man/man1/afm2afm.man1.pdf Binary files differindex 1c980702799..a4884c93ddf 100644 --- a/Master/texmf/doc/man/man1/afm2afm.man1.pdf +++ b/Master/texmf/doc/man/man1/afm2afm.man1.pdf diff --git a/Master/texmf/doc/man/man1/autoinst.1 b/Master/texmf/doc/man/man1/autoinst.1 index 4f1ed4256ae..2e66e514d3b 100644 --- a/Master/texmf/doc/man/man1/autoinst.1 +++ b/Master/texmf/doc/man/man1/autoinst.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07) +.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) .\" .\" Standard preamble: .\" ======================================================================== @@ -124,96 +124,88 @@ .\" ======================================================================== .\" .IX Title "AUTOINST 1" -.TH AUTOINST 1 "2011-06-15" "fontools" "fontools" +.TH AUTOINST 1 "2012-03-06" "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" -autoinst \- wrapper script around the \fI\s-1LCDF\s0 TypeTools\fR, +autoinst \- wrapper around the LCDF TypeTools, for installing OpenType fonts in LaTeX. .SH "SYNOPSIS" .IX Header "SYNOPSIS" -autoinst [options] \fIfontfile\fR [\fIfontfile\fR ...] +\&\fBautoinst\fR [\fIoptions\fR] \fBfont(s)\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" -Eddie Kohler's \fITypeTools\fR, especially \fIotftotfm\fR, are great tools for -installing OpenType fonts for use with LaTeX, but their use (even in -automatic mode) is quite complicated because it needs lots of long -command lines and doesn't generate the \fIfd\fR and \fIsty\fR files LaTeX needs. -\&\fBautoinst\fR simplifies the font installation -process by generating and executing all commands for \fIotftotfm\fR -and by creating all necessary \fIfd\fR and \fIsty\fR files. +Eddie Kohler's \fITypeTools\fR, especially \fIotftotfm\fR, are superb tools +for installing OpenType fonts in LaTeX, but their use +(even in automatic mode) is complicated: they need many long +command lines and don't generate the \fIfd\fR and \fIsty\fR files LaTeX needs. +\&\fBautoinst\fR simplifies the font installation process with \fIotftotfm\fR +by generating and executing all command lines +and by creating and installing all \fIfd\fR and \fIsty\fR files. .PP -All the user then needs -to do is move these files to a suitable location -(\fI\f(CI$LOCALTEXMF\fI/tex/latex/<Supplier>/<FontFamily>/\fR is the -official choice) and update TeX's filename database. -.PP -Given a family of font files (in either \fI.ttf\fR or \fI.otf\fR format), +Given a family of font files (in either \fIotf\fR or \fIttf\fR format), \&\fBautoinst\fR will create several LaTeX font families: .RS 2 -.IP "\fB\-\fR" 2 -.IX Item "-" -Four text families (with lining and oldstyle figures, in tabular and +.IP "\-" 3 +Four text families (with lining and oldstyle digits, in tabular and proportional variants), each with the following shapes: +.RS 3 .RS 2 -.RS 2 -.IP "\fIn\fR" 4 +.IP "\fIn\fR" 6 .IX Item "n" Roman text -.IP "\fIsc\fR" 4 +.IP "\fIsc\fR" 6 .IX Item "sc" Small caps -.IP "\fInw\fR" 4 +.IP "\fInw\fR" 6 .IX Item "nw" -`Upright swash'; usually normal text with some extra `oldstyle' ligatures, +\&\*(L"Upright swash\*(R"; usually normal text with some extra \*(L"oldstyle\*(R" ligatures, such as ct, sp and st. -.IP "\fItl\fR" 4 +.IP "\fItl\fR" 6 .IX Item "tl" -Titling shape. Meant for all-caps text only (even though it sometimes contains -lowercase glyphs as well), where letterspacing and the positioning of -punctuation characters have been adjusted to suit all-caps text. -This shape is generated only for the families with lining figures. -.IP "\fIit\fR" 4 +Titling shape. Meant for all-caps text only (even though it sometimes contains +lowercase glyphs as well), where letterspacing and the positioning of +punctuation characters have been adjusted to suit all-caps text. +This shape is generated only for the families with lining digits, since +all-caps text doesn't mix with old-style digits. +.IP "\fIit\fR" 6 .IX Item "it" -Italic or oblique text -.IP "\fIscit\fR" 4 +Italic (or oblique) text +.IP "\fIscit\fR" 6 .IX Item "scit" Italic small caps -.IP "\fIsw\fR" 4 +.IP "\fIsw\fR" 6 .IX Item "sw" Swash -.IP "\fItlit\fR" 4 +.IP "\fItlit\fR" 6 .IX Item "tlit" Italic titling .RE .RS 2 .RE .RE -.RS 2 +.RS 3 .RE -.IP "\fB\-\fR" 2 -.IX Item "-" -For each text family: a family of TS1\-encoded symbol fonts, +.IP "\-" 3 +For each text family: a family of TS1\-encoded symbol fonts, in roman and italic shapes. -.IP "\fB\-\fR" 2 -.IX Item "-" +.IP "\-" 3 Four families with superiors, inferiors, numerators and denominators, in roman and italic shapes. -.IP "\fB\-\fR" 2 -.IX Item "-" +.IP "\-" 3 An ornament family, in roman and italic shapes. .RE .RS 2 .RE .PP -Of course, if the font doesn't contain oldstyle figures, small caps etc., -the corresponding shapes or families are not created; -furthermore, the creation of most families and shapes can be controlled by -command-line options (see below). +Of course, if the fonts don't contain oldstyle digits, small caps etc., +the corresponding shapes and families are not created. +Furthermore, the creation of most families and shapes can be controlled by +command-line options (see \*(L"COMMAND-LINE \s-1OPTIONS\s0\*(R" below). .PP -The generated font families are named \fI<FontFamily>\-<Suffix>\fR, +The generated font families are named \fI<FontFamily>\-<Suffix>\fR, where \fI<Suffix>\fR is one of .IP "\fI\s-1LF\s0\fR" 8 .IX Item "LF" @@ -229,12 +221,12 @@ proportional oldstyle figures tabular oldstyle figures .IP "\fISup\fR" 8 .IX Item "Sup" -superior characters (many fonts only have an incomplete set -of superiors: figures, some punctuation and the letters -\&\fIabdeilmnorst\fR; normal forms will be used for the other characters) +superior characters (many fonts have only an incomplete set of superiors: +digits, punctuation and the letters \fIabdeilmnorst\fR; +normal forms will be used for the other characters) .IP "\fIInf\fR" 8 .IX Item "Inf" -inferior characters; usually only figures and punctuation, +inferior characters; usually only digits and punctuation, normal forms for the other characters .IP "\fIOrn\fR" 8 .IX Item "Orn" @@ -246,313 +238,363 @@ numerators .IX Item "Dnom" denominators .PP -The generated fonts are named \fI<FontFile>\-<suffix>\-<shape>\-<enc>\fR, -where \fI<FontFile>\fR is the name of the OpenType file, \fI<suffix>\fR -is the same as above (but in lowercase), \fI<shape>\fR is either empty, -`sc', `swash' or `titling', and \fI<enc>\fR is the encoding. -A typical name in this scheme is \fIMinionPro\-Regular\-osf\-sc\-ly1\fR. +The generated 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", \*(L"swash\*(R" or \*(L"titling\*(R", +and \fI<enc>\fR is the encoding. +A typical name in this scheme would be \*(L"MinionPro\-Regular\-osf\-sc\-ly1\*(R". .SS "On the choice of text encoding" .IX Subsection "On the choice of text encoding" -By default, all text families use the \s-1LY1\s0 encoding. This has been chosen -over T1 (Cork) because many OpenType fonts contain additional ligatures -such as fj and Th, and \s-1LY1\s0 has a number of empty slots to accommodate these. -Different encodings can be selected using the \fB \-\-encoding\fR -command line option (see below). -.SS "Using the fonts with LaTeX" -.IX Subsection "Using the fonts with LaTeX" -\&\fBautoinst\fR generates a style file for using the font in LaTeX documents, -named `<\fIFontFamily\fR>.sty'. This style file also takes care of loading the +By default, \fBautoinst\fR generates text fonts with \s-1OT1\s0, T1 and \s-1LY1\s0 +encodings, and the generated style files use \s-1LY1\s0 as the default text encoding. +\&\s-1LY1\s0 has been chosen over T1 because it has some empty slots to accomodate +the additional ligatures and alternate glyphs provided by many OpenType fonts. +Different encodings can be selected using the \fI\-encoding\fR +command-line option (see \*(L"COMMAND-LINE \s-1OPTIONS\s0\*(R" below). +.SS "Using the fonts in your LaTeX documents" +.IX Subsection "Using the fonts in your LaTeX documents" +\&\fBautoinst\fR generates a style file for using the font in LaTeX documents, +named \fI<FontFamily>.sty\fR. This style file also takes care of loading the \&\fIfontenc\fR and \fItextcomp\fR packages, if necessary. -To use the font, simply put \f(CW\*(C`\eusepackage{MinionPro}\*(C'\fR -(or whatever the font is called) in the preamble of your document. +To use the font, simply put \f(CW\*(C`\eusepackage{\f(CI<FontFamily>\f(CW}\*(C'\fR +in the preamble of your document. .PP This style file defines a number of options: .IP "\fIlining, oldstyle, tabular, proportional\fR" 4 .IX Item "lining, oldstyle, tabular, proportional" -Choose which figures will be used for the text fonts. -The defaults are `oldstyle' and `proportional' (if available). +Choose which digits will be used for the text fonts. +The defaults are \*(L"oldstyle\*(R" and \*(L"proportional\*(R" (if available). .IP "\fIultrablack, ultrabold, heavy, extrablack, black, extrabold, demibold, semibold, bold\fR" 4 .IX Item "ultrablack, ultrabold, heavy, extrablack, black, extrabold, demibold, semibold, bold" -Choose the weight that LaTeX will use for the `bold' weight +Choose the weight that LaTeX will use for the \*(L"bold\*(R" weight (i.e., the value of \f(CW\*(C`\ebfdefault\*(C'\fR). .IP "\fIlight, medium, regular\fR" 4 .IX Item "light, medium, regular" -Choose the weight that LaTeX will use for the `regular' weight +Choose the weight that LaTeX will use for the \*(L"regular\*(R" weight (i.e., the value of \f(CW\*(C`\emddefault\*(C'\fR). .IP "\fIscaled=<scale>\fR" 4 .IX Item "scaled=<scale>" -Scale the font by a factor of \fI<scale>\fR. +Scale the font by a factor of \fI<scale>\fR. For example: to increase the size of the font by 5%, use the command -\&\f(CW\*(C`\eusepackage[scaled=1.05]{MyriadPro}\*(C'\fR. +\&\f(CW\*(C`\eusepackage[scaled=1.05]{\f(CI<FontFamily>\f(CW}\*(C'\fR. .Sp This option is only available when the \fIxkeyval\fR package is found in your TeX installation. .PP -The style file will also try to load the \fIfontaxes\fR package (part of -the MinionPro for LaTeX project), which gives easy access to various font -shapes and styles. This package can be downloaded from the project's homepage -(\fIhttp://developer.berlios.de/projects/minionpro\fR) or directly through -the \s-1CVS\s0 web interface -(\fIhttp://cvs.berlios.de/cgi\-bin/viewcvs.cgi/minionpro/MinionPro/tex/\fR), -and is also available from \s-1CTAN\s0 as part of the archive \fImetrics\-base.zip\fR -(\fIhttp://www.ctan.org/tex\-archive/fonts/minionpro/metrics\-base.zip\fR). -.PP -Using the machinery set up by \fIfontaxes\fR, the generated style file -also defines a few commands (which take the text to be typeset as argument) -and declarations (which don't take arguments, but affect all text up to +The style file will also try to load the \fIfontaxes\fR package, +which gives easy access to various font shapes and styles. +It is available from \s-1CTAN\s0 +(\fIhttp://www.ctan.org/tex\-archive/macros/latex/contrib/fontaxes\fR). +Using the machinery set up by \fIfontaxes\fR, the generated style file also +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 the end of the current group) of its own: .PP .Vb 1 \& DECLARATION COMMAND SHORT FORM OF COMMAND -\& +\& \& \etlshape \etexttitling \etexttl -\& \esufigures \etextsuperior \etextsu +\& \esufigures \etextsuperior \etextsu \& \einfigures \etextinferior \etextin .Ve .PP In addition, the \f(CW\*(C`\eswshape\*(C'\fR and \f(CW\*(C`\etextsw\*(C'\fR commands are redefined to place -swash on the secondary shape axis (\fIfontaxes\fR places it on the primary -shape axis); this allows the use of `upright swash'. -Just saying \f(CW\*(C`\eswshape\*(C'\fR will still give normal (italic) swash, -but \f(CW\*(C`\eswshape\eupshape\*(C'\fR results in upright swash. +swash on the secondary shape axis (\fIfontaxes\fR places it on the primary +shape axis); this makes these commands behave properly when nested, so that +\&\f(CW\*(C`\eswshape\eupshape\*(C'\fR will give upright swash. .PP -Note that there is no separate command for accessing the italic titling shape; -but these commands behave properly when nested, so \f(CW\*(C`\etlshape\eitshape\*(C'\fR gives -italic titling. -There are also no commands for accessing the numerator and denominator -fonts; these can be selected using \fIfontaxes\fR' low-level commands, +There are no commands for accessing the numerator and denominator +fonts; these can be selected using \fIfontaxes\fR' standard commands, e.g., \f(CW\*(C`\efontfigurestyle{numerator}\eselectfont\*(C'\fR. .PP -The style file also provides a command \f(CW\*(C`\eornament{\f(CI<number>\f(CW}\*(C'\fR, -where \f(CW\*(C`\f(CI<number>\f(CW\*(C'\fR is a number from 0 to the total number of -ornaments minus one. Ornaments are always typeset using the current family, +The style file also provides a command \f(CW\*(C`\eornament{\f(CI<number>\f(CW}\*(C'\fR, +where \f(CW\*(C`\f(CI<number>\f(CW\*(C'\fR is a number from 0 to the total number of +ornaments minus one. Ornaments are always typeset using the current family, series and shape. A list of all ornaments in a font can be created by -running LaTeX on the file \fInfssfont.tex\fR (part of a standard -LaTeX installation) and specifying the ornament font -(e.g., \fIMinionPro-Regular-orn-u\fR). +running LaTeX on the file \fInfssfont.tex\fR (part of a standard +LaTeX installation) and supplying the name of the ornament font. +.PP +To access the ornaments, \fBautoinst\fR creates a font-specific encoding file +\&\fI<FontFamily>_orn.enc\fR, but only if that file doesn't yet exist. +This means you can provide your own encoding vector, +e.g. if your fonts use non-standard glyph names for ornaments. .PP These commands are only generated for shapes and number styles -that actually exist; no commands are generated for shapes and styles +that actually exist; no commands are generated for shapes and styles that don't exist, or whose generation has been turned off. -.PP -This whole machinery builds on \fIfontaxes\fR; if that package cannot be found, -the style file doesn't provide high-level access to the more `exotic' -font shapes and styles. In that case, you're limited to using the lower-level -commands from standard \s-1NFSS\s0. +Please note that these commands are built on top of \fIfontaxes\fR; +if that package cannot be found, you're limited to using the +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.). .SS "Using multiple font families in one document" .IX Subsection "Using multiple font families in one document" -If you want to use several font families in one document, make sure -all fonts were installed using the same version of \fBautoinst\fR. -\&\fBautoinst\fR has seen some non-backward-compatible changes in the past, -and \fI.sty\fR and \fI.fd\fR files that were generated by different versions -of \fBautoinst\fR may not be able to coexist peacefully. +If you want to use more than one font family in a document, be aware +that style files generated by versions of \fBautoinst\fR older dan 2009 +are incompatible with those generated by newer versions. .SS "\s-1NFSS\s0 codes" .IX Subsection "NFSS codes" -In \s-1NFSS\s0, weight and width are concatenated into a single `series' attribute. -\&\fBautoinst\fR maps widths, weights and shapes to \s-1NFSS\s0 codes using -the following tables. These are based on the tables in Lehman's -\&\fIFont Installation Guide\fR, but some changes had to be made to avoid -name clashes for font families with many different widths and weights -(such as Helvetica Neue). +\&\s-1NFSS\s0 identifies fonts by a combination of family, series (weight plus width), +shape and size. +\&\fBautoinst\fR parses the output of \f(CW\*(C`otfinfo \-\-info\*(C'\fR to determine +these parameters. When this fails +(e.g., because the font family contains unusual widths or weights), +\&\fBautoinst\fR ends up with different fonts having the \fIsame\fR values +for the font parameters, which means that these fonts cannot be used in \s-1NFSS\s0. +\&\fBautoinst\fR will then split the font family into multiple subfamilies +(based on the font's \*(L"Subfamily\*(R" value) and try again. +(Since many font families overdo the \*(L"Subfamily\*(R" by making each font +a separate subfamily, this strategy is only used as a last resort.) +.PP +If this proliferation of font families is unwanted, +either rerun \fBautoinst\fR on a smaller set of fonts (omitting the ones that +failed to parse correctly) +or else add the missing widths, weights and shapes to the tables \f(CW%FD_WIDTH\fR, +\&\f(CW%FD_WEIGHT\fR and \f(CW%FD_SHAPE\fR, near the top of the source code. +Please also send a bug report (see \s-1AUTHOR\s0 below). +.PP +\&\fBautoinst\fR maps widths, weights and shapes to \s-1NFSS\s0 codes using +the following tables. These are based both on the standard \fIFontname\fR scheme +and on the tables in Philipp Lehman's \fIFont Installation Guide\fR, +but some changes had to be made to avoid name clashes in font families +with many different widths and weights. .PP .Vb 1 -\& WEIGHT WIDTH -\& -\& Thin t Ultra Condensed uc -\& Ultra Light ul Extra Condensed ec -\& Extra Light el Condensed c -\& Light l Semicondensed sc -\& Book [1] Regular [1] -\& Regular [1] Semiextended sx -\& Medium mb Extended x -\& Demibold db -\& Semibold sb -\& Bold b -\& Extra Bold eb SHAPES -\& Black a -\& Extra Black ea Roman n -\& Heavy h Italic it -\& Ultra ub Oblique it [2] -\& Ultra Bold ub RomanI n [3] -\& Ultra Black ua RomanII it [3] +\& WEIGHT WIDTH +\& +\& Thin t Ultra Compressed up +\& Ultra Light ul Extra Compressed ep +\& Extra Light el Compressed, Compact p +\& Light l Compact p +\& Book [1] Ultra Condensed uc +\& Regular [1] Extra Condensed ec +\& Medium mb Condensed c +\& Demibold db Narrow n +\& Semibold sb Semicondensed sc +\& Bold b Regular [1] +\& Extra Bold eb Semiextended sx +\& Ultra ub Extended x +\& Ultra Bold ub Expanded e +\& Black k Wide w +\& Extra Black ek +\& Ultra Black uk +\& Heavy h SHAPE +\& Poster r +\& Roman, Upright n [2] +\& Italic it +\& Cursive, Kursiv it +\& Oblique, Slanted it [3] +\& Incline(d) it [3] .Ve +.PP +\fINotes:\fR +.IX Subsection "Notes:" .IP "[1]" 4 .IX Item "[1]" -When \fIboth\fR weight and width are empty, the `series' attribute becomes `m'. +When \fIboth\fR weight and width are empty, the \*(L"series\*(R" attribute becomes \*(L"m\*(R". .IP "[2]" 4 .IX Item "[2]" -Mapping the `Oblique' shape to `it' instead of the canonical `sl' simplifies -\&\fBautoinst\fR. Since font families with both `Italic' and `Oblique' shapes -probably do not exist (apart from Computer Modern), -this shouldn't cause problems in real life. +Adobe Silentium Pro contains two \*(L"Roman\*(R" shapes (\*(L"RomanI\*(R" and \*(L"RomanII\*(R"); +the first of these is mapped to \*(L"n\*(R", the second one to \*(L"it\*(R". .IP "[3]" 4 .IX Item "[3]" -To the best of my knowledge, the only font family that has two `Roman' shapes -is Silentium; since this has no `Italic' shape, -the `it' code is (ab)used for the `RomanII' shape. -.SS "A note for MikTeX users" -.IX Subsection "A note for MikTeX users" -Calling \fIotftotfm\fR with the \fB \-\-automatic\fR option (as \fBautoinst\fR does by -default) requires a TeX-installation that uses the \fIkpathsea\fR library; with -TeX-installations that implement their own directory searching -(such as MiKTeX) \fIotftotfm\fR might complain that it -cannot find a writable \fItexmf\fR directory and leave all generated \fItfm\fR, -\&\fIvf\fR, \fIenc\fR and \fImap\fR files in the current working directory. -In that case, you need to move these to their correct destinations. -You also need to tell the dvi-driver (\fIdvips\fR, \fIdvipdfm\fR, \fIpdfTeX\fR etc.) -about the new font map files; see the documentation for how this is done. +Mapping the \*(L"Slanted\*(R", \*(L"Oblique\*(R" or \*(L"Inclined\*(R" shape to \*(L"it\*(R" instead of \*(L"sl\*(R" +simplifies \fBautoinst\fR. Since font families with both italic and slanted +shapes do \- to the best of my knowledge \- not exist +(apart from Computer Modern, of course), +this shouldn't cause problems in real life. +.SS "A note for MiKTeX users" +.IX Subsection "A note for MiKTeX users" +Automatically installing the fonts into a suitable \s-1TEXMF\s0 tree +(as \fBautoinst\fR does by default) requires a TeX-installation that uses +the \fIkpathsea\fR library; with TeX distributions that implement their +own directory searching (such as MiKTeX), \fBautoinst\fR will complain that +it cannot find the \fIkpsewhich\fR program and install all generated files +into subdirectories 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\s0\*(R" below) to specify a \s-1TEXMF\s0 tree. .PP -Also, some OpenType fonts lead to \fIpl\fR and \fIvpl\fR files that are too -big for MiKTeX's \fIpltotf\fR and \fIvptovf\fR; the versions from TeXLive -(\fIhttp://tug.org/ftp/texlive/Contents/live/bin/win32/\fR) don't have this -problem. +Also, some OpenType fonts lead to \fIpl\fR and \fIvpl\fR files that +are too big for MiKTeX's \fIpltotf\fR and \fIvptovf\fR; +the versions that come with W32TeX (\fIhttp://www.w32tex.org\fR) +and TeXLive (\fIhttp://tug.org/texlive\fR) don't have this problem. .SH "COMMAND-LINE OPTIONS" .IX Header "COMMAND-LINE OPTIONS" -.IP "\fB \-\-encoding\fR=\fIencoding[,encoding]\fR" 4 -.IX Item " --encoding=encoding[,encoding]" -Use the encoding \fIencoding\fR for the text fonts. The default is `\s-1LY1\s0'. -A file named `<\fIencoding\fR>.enc' (in all \fIlowercase\fR) should be somewhere -where \fIotftotfm\fR can find it. Suitable encoding files -for \s-1LY1\s0, \s-1OT1\s0 and T1/TS1 come with \fIfontools\fR. (Note that these files are -called \fIfontools_xxx.enc\fR to avoid name clashes with other packages; -the `fontools_' prefix doesn't need to be specified.) +You may use either one or two dashes before options, +and option names may be shortened to a unique prefix +(e.g., \fB\-enc\fR instead of \fB\-encoding\fR). +.IP "\fB\-encoding\fR=\fIencoding[,encoding]\fR" 4 +.IX Item "-encoding=encoding[,encoding]" +Use the specified encodings for the text fonts. The default is \*(L"\s-1OT1\s0,T1,LY1\*(R". +For each encoding, a file \fI<encoding>.enc\fR (in all \fIlowercase\fR) +should be somewhere where \fIotftotfm\fR can find it. Suitable encoding files +for \s-1OT1\s0, T1/TS1 and \s-1LY1\s0 come with \fBautoinst\fR. (Note that these files are +called \fIfontools_ot1.enc\fR etc. to avoid name clashes with other packages; +the \*(L"fontools_\*(R" prefix doesn't need to be specified.) .Sp -Multiple text encodings can be specified as well: \f(CW\*(C` \-\-encoding=OT1,T1,LY1\*(C'\fR. -The encodings are passed to \fIfontenc\fR in the order specified, -so the last one will be the default text encoding. -.IP "\fB \-\-sanserif\fR" 4 -.IX Item " --sanserif" -Install the font as a sanserif font, accessed via \f(CW\*(C`\esffamily\*(C'\fR and \f(CW\*(C`\etextsf\*(C'\fR. -Note that the generated style file redefines \f(CW\*(C`\efamilydefault\*(C'\fR, -so including it will make this font the default text font. -.IP "\fB \-\-typewriter\fR" 4 -.IX Item " --typewriter" -Install the font as a typewriter font, accessed via \f(CW\*(C`\ettfamily\*(C'\fR and -\&\f(CW\*(C`\etexttt\*(C'\fR. -Note that the generated style file redefines \f(CW\*(C`\efamilydefault\*(C'\fR, -so including it will make this font the default text font. -.IP "\fB \-\-ts1\fR" 4 -.IX Item " --ts1" +Multiple text encodings can be specified as a comma-separated list: +\&\f(CW\*(C`\-encoding=OT1,T1\*(C'\fR. The encodings are passed to \fIfontenc\fR in the order +specified, so the last one will be the default text encoding. +.IP "\fB\-sanserif\fR" 4 +.IX Item "-sanserif" +Install the font as a sanserif font, accessed via \f(CW\*(C`\esffamily\*(C'\fR and \f(CW\*(C`\etextsf\*(C'\fR. +Note that the generated style file redefines \f(CW\*(C`\efamilydefault\*(C'\fR, +so including it will still make this font the default text font. +.IP "\fB\-typewriter\fR" 4 +.IX Item "-typewriter" +Install the font as a typewriter font, accessed via \f(CW\*(C`\ettfamily\*(C'\fR and +\&\f(CW\*(C`\etexttt\*(C'\fR. +Note that the generated style file redefines \f(CW\*(C`\efamilydefault\*(C'\fR, +so including it will still make this font the default text font. +.IP "\fB\-ts1\fR" 4 +.IX Item "-ts1" .PD 0 -.IP "\fB \-\-nots1\fR" 4 -.IX Item " --nots1" +.IP "\fB\-nots1\fR" 4 +.IX Item "-nots1" .PD -Turn the creation of TS1\-encoded fonts on or off. The default is \fB \-\-ts1\fR -if the text encodings (see \fI \-\-encoding\fR above) include T1, -\&\fB \-\-nots1\fR otherwise. -.IP "\fB \-\-smallcaps\fR" 4 -.IX Item " --smallcaps" +Turn the creation of TS1\-encoded fonts on or off. The default is \fB\-ts1\fR +if the text encodings (see \fI\-encoding\fR above) include T1, +\&\fB\-nots1\fR otherwise. +.IP "\fB\-smallcaps\fR" 4 +.IX Item "-smallcaps" .PD 0 -.IP "\fB \-\-nosmallcaps\fR" 4 -.IX Item " --nosmallcaps" +.IP "\fB\-nosmallcaps\fR" 4 +.IX Item "-nosmallcaps" .PD -Turn the creation of small caps fonts on or off. The default is -\&\fB \-\-smallcaps\fR. -.IP "\fB \-\-swash\fR" 4 -.IX Item " --swash" +Turn the creation of small caps fonts on or off. The default is +\&\fB\-smallcaps\fR. +.IP "\fB\-swash\fR" 4 +.IX Item "-swash" .PD 0 -.IP "\fB \-\-noswash\fR" 4 -.IX Item " --noswash" +.IP "\fB\-noswash\fR" 4 +.IX Item "-noswash" .PD -Turn the creation of swash fonts on or off. The default is \fB \-\-swash\fR. -.IP "\fB \-\-titling\fR" 4 -.IX Item " --titling" +Turn the creation of swash fonts on or off. The default is \fB\-swash\fR. +.IP "\fB\-titling\fR" 4 +.IX Item "-titling" .PD 0 -.IP "\fB \-\-notitling\fR" 4 -.IX Item " --notitling" +.IP "\fB\-notitling\fR" 4 +.IX Item "-notitling" .PD -Turn the creation of titling fonts on or off. The default is \fB \-\-notitling\fR. -.IP "\fB \-\-superiors\fR" 4 -.IX Item " --superiors" +Turn the creation of titling fonts on or off. The default is \fB\-titling\fR. +.IP "\fB\-superiors\fR" 4 +.IX Item "-superiors" .PD 0 -.IP "\fB \-\-nosuperiors\fR" 4 -.IX Item " --nosuperiors" +.IP "\fB\-nosuperiors\fR" 4 +.IX Item "-nosuperiors" .PD -Turn the creation of fonts with superior characters on or off. -The default is \fB \-\-superiors\fR. -.IP "\fB \-\-inferiors\fR" 4 -.IX Item " --inferiors" +Turn the creation of fonts with superior characters on or off. +The default is \fB\-superiors\fR. +.IP "\fB\-inferiors\fR" 4 +.IX Item "-inferiors" .PD 0 -.IP "\fB \-\-noinferiors\fR" 4 -.IX Item " --noinferiors" +.IP "\fB\-noinferiors\fR" 4 +.IX Item "-noinferiors" .PD -Turn the creation of fonts with inferior figures on or off. -The default is \fB \-\-noinferiors\fR. -.IP "\fB \-\-fractions\fR" 4 -.IX Item " --fractions" +Turn the creation of fonts with inferior digits on or off. +The default is \fB\-noinferiors\fR. +.IP "\fB\-fractions\fR" 4 +.IX Item "-fractions" .PD 0 -.IP "\fB \-\-nofractions\fR" 4 -.IX Item " --nofractions" +.IP "\fB\-nofractions\fR" 4 +.IX Item "-nofractions" .PD -Turn the creation of fonts with numerators and denominators on or off. -The default is \fB \-\-nofractions\fR. -.IP "\fB \-\-ornaments\fR" 4 -.IX Item " --ornaments" +Turn the creation of fonts with numerators and denominators on or off. +The default is \fB\-nofractions\fR. +.IP "\fB\-ornaments\fR" 4 +.IX Item "-ornaments" .PD 0 -.IP "\fB \-\-noornaments\fR" 4 -.IX Item " --noornaments" +.IP "\fB\-noornaments\fR" 4 +.IX Item "-noornaments" .PD -Turn the creation of ornament fonts on or off. The default is \fB \-\-ornaments\fR. -.IP "\fB \-\-manual\fR" 4 -.IX Item " --manual" -Manual mode. By default, \fBautoinst\fR immediately executes all \fIotftotfm\fR -command lines it generates; with the \fB \-\-manual\fR option, these commands are -instead written to a batch command file (named `<\fIfont\fR>.bat', to make things -easier for our friends on Windows). Also, the generated \fIotftotfm\fR command -lines specify the \fI \-\-pl\fR option and leave out the \fI \-\-automatic\fR option; -this causes human readable (and editable) \fIpl\fR and \fIvpl\fR files to be created -instead of the default \fItfm\fR and \fIvf\fR files. -.IP "\fB \-\-verbose\fR" 4 -.IX Item " --verbose" +Turn the creation of ornament fonts on or off. The default is \fB\-ornaments\fR. +.IP "\fB\-target\fR=\fI\s-1DIRECTORY\s0\fR" 4 +.IX Item "-target=DIRECTORY" +Install all generated files into the \s-1TEXMF\s0 tree at \fI\s-1DIRECTORY\s0\fR. +.Sp +By default, \fBautoinst\fR searches your \f(CW$TEXMFLOCAL\fR and \f(CW$TEXMFHOME\fR paths +and installs all files into subdirectories of the first writable \s-1TEXMF\s0 tree +it finds (or into subdirectories of the current directory, +if no writable directory is found). +.Sp +\&\fBNote\fR: this option gets overriden by the \fB\-manual\fR option! +.IP "\fB\-manual\fR" 4 +.IX Item "-manual" +Manual mode. By default, \fBautoinst\fR immediately executes all \fIotftotfm\fR +command lines it generates; with the \fB\-manual\fR option, these commands are +instead written to a file \fIautoinst.bat\fR. +Also, the generated \fIotftotfm\fR command lines specify the \fI \-\-pl\fR option +(which tells \fIotftotfm\fR to generate readable/editable \fIpl\fR and \fIvpl\fR files +instead of the default \fItfm\fR and \fIvf\fR files) +and leave out the \fI \-\-automatic\fR option (which tells \fIotftotfm\fR to +leave all generated files in the current directory, rather than install +them into your \s-1TEXMF\s0 tree). +.Sp +When using this option, you should run \fIpltotf\fR and \fIvptovf\fR after +executing all commands, +to convert the \fIpl\fR and \fIvf\fR files to \fItfm\fR and \fIvf\fR format. +.Sp +\&\fBNote\fR: this option overrides the \fB\-target\fR option! +.IP "\fB\-verbose\fR" 4 +.IX Item "-verbose" Verbose mode; print detailed info about what \fBautoinst\fR thinks it's doing. -.IP "\fB \-\-extra\fR=\fItext\fR" 4 -.IX Item " --extra=text" -Pass \fItext\fR as options to \fIotftotfm\fR. To prevent \fItext\fR from accidentily +.IP "\fB\-extra\fR=\fItext\fR" 4 +.IX Item "-extra=text" +Pass \fItext\fR as options to \fIotftotfm\fR. To prevent \fItext\fR from accidentily being interpreted as options to \fBautoinst\fR, it should be properly quoted. +.IP "\fB\-figurekern\fR" 4 +.IX Item "-figurekern" +.PD 0 +.IP "\fB\-nofigurekern\fR" 4 +.IX Item "-nofigurekern" +.PD +Some fonts provide kerning pairs for tabular figures. +This is probably unwanted (e.g., numbers in tables won't line up exactly). +The option \fB\-nofigurekern\fR adds extra \fI \-\-ligkern\fR options +to the command lines for \fIotftotfm\fR to suppress such kerns +(but only for the \*(L"\s-1TLF\s0\*(R" and \*(L"TOsF\*(R" families). +Since this leads to very long command lines (it adds one hundred such options) +and the problem affects only few fonts, the default is \fB\-figurekern\fR. .SH "SEE ALSO" .IX Header "SEE ALSO" Eddie Kohler's TypeTools (\fIhttp://www.lcdf.org/type\fR). .PP -Perl is usually pre-installed on Linux and Unix systems; -on Windows, try ActivePerl (available from \fIhttp://www.activestate.com\fR) +Perl is pre-installed on most Linux and Unix systems; +on Windows, try ActiveState's ActivePerl +(available from \fIhttp://www.activestate.com\fR) or Strawberry Perl (\fIhttp://strawberryperl.com\fR). .PP -XeTeX (\fIhttp://www.tug.org/xetex\fR) is an extension of TeX -that can natively use any font installed in the operating system -(including both flavours of OpenType fonts) -without additional support files. +XeTeX (\fIhttp://www.tug.org/xetex\fR) and LuaTeX (\fIhttp://www.luatex.org\fR) +are TeX extensions that can use any font (including both flavours of OpenType) +without TeX-specific support files. .PP -John Owens' \fIotfinst\fR (available from \s-1CTAN\s0) is another wrapper +John Owens' \fIotfinst\fR (available from \s-1CTAN\s0) is another wrapper around \fIotftotfm\fR, and may work when \fBautoinst\fR doesn't. .PP -The MinionPro for LaTeX project -(\fIhttp://developer.berlios.de/projects/minionpro/\fR, also on \s-1CTAN\s0) -developed very complete support files for Minion Pro (including math), +The MinionPro for LaTeX project +(\fIhttp://developer.berlios.de/projects/minionpro/\fR, also on \s-1CTAN\s0) +developed very complete support files for Minion Pro (including math), but the project appears to have been abandoned; -these files don't work with recent versions of Minion Pro. +these files don't work with the latest versions of Minion Pro. .SH "AUTHOR" .IX Header "AUTHOR" -Marc Penninga <marc@penninga.info> -.PP -When sending a bug report, please give as much relevant information as -possible; this usually includes (but may not be limited to) the output from -running \fBautoinst\fR with the \fB \-\-verbose\fR option. -Please make sure that this output includes all error messages (if any); -this can be done using the command +Marc Penninga <marcpenninga@gmail.com> .PP -\&\f(CW\*(C`autoinst \f(CI(... all options and files ...)\f(CW >autoinst.log 2>&1\*(C'\fR +When sending a bug report, please give as much relevant information as +possible; this includes at least (but may not be limited to) the output +from running \fBautoinst\fR with the \fI\-verbose\fR option. +Please make sure that this output includes all (if any) error messages. .SH "COPYRIGHT" .IX Header "COPYRIGHT" -Copyright (C) 2005, 2006, 2007, 2009, 2010, 2011 Marc Penninga. +Copyright (C) 2005\-2012 Marc Penninga. .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 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 the \fIfontools\fR -collection; see the file \fIGPLv2.txt\fR. +it under the terms of the \s-1GNU\s0 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 \fBautoinst\fR; +see the file \fIGPLv2.txt\fR. .SH "DISCLAIMER" .IX Header "DISCLAIMER" This program is distributed in the hope that it will be useful, @@ -561,30 +603,51 @@ but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty \&\s-1GNU\s0 General Public License for more details. .SH "RECENT CHANGES" .IX Header "RECENT CHANGES" -(See the source code for the full story.) +(See the source code for the rest of the story.) +.IP "\fI2012\-03\-06\fR" 12 +.IX Item "2012-03-06" +Implemented the \*(L"splitting the font family into multiple subfamilies\*(R" +emergency strategy when font info parsing fails. +Added recognition for a number of unusual widths, weights and shapes. +.IP "\fI2012\-02\-29\fR" 12 +.IX Item "2012-02-29" +Fixed a bug in the font parsing code, +where possible widths, weights and shapes where tested in the wrong order; +this led to \*(L"ExtraLight\*(R" fonts being recognised as \*(L"Light\*(R". +Added recognition for \*(L"Narrow\*(R" and \*(L"Wide\*(R" widths. +Also added the \fI\-(no)figurekern\fR command-line option. +.IP "\fI2012\-02\-01\fR" 12 +.IX Item "2012-02-01" +Reorganised the code, and fixed some bugs in the process. +Added the \fI\-target\fR command-line option. +Made \fBautoinst\fR install the \fIfd\fR and \fIsty\fR files in +the same \s-1TEXMF\s0 tree as the other generated files. +Generate \s-1OT1\s0, T1 and \s-1LY1\s0 encoded text fonts by default. +Made \fI\-titling\fR a default option (instead of \fI\-notitling\fR). +Updated the documentation. .IP "\fI2011\-06\-15\fR" 12 .IX Item "2011-06-15" Fixed the font info parsing code for some fonts that are -too lazy to spell out 'Italic' in full. +too lazy to spell out \*(L"Italic\*(R" in full. .IP "\fI2010\-04\-29\fR" 12 .IX Item "2010-04-29" -The \f(CW\*(C` \-\-feature=kern\*(C'\fR option is only used for fonts that +The \fI \-\-feature=kern\fR option is only used for fonts that contain either a \fIkern\fR feature or a \fIkern\fR table. -Font feature selection commands in the \fI.sty\fR file are only -generated for shapes and figure styles that are supported +Font feature selection commands in the \fIsty\fR file are only +generated for shapes and figure styles that are supported by the current font, and whose generation has not been -turned off using the command line options. +turned off using the command-line options. Fixed the font info parsing to work with the Condensed fonts in the Minion Pro family. .IP "\fI2010\-04\-23\fR" 12 .IX Item "2010-04-23" -Always provide the \f(CW\*(C` \-\-feature=kern\*(C'\fR option to \fIotftotfm\fR, -even if the font doesn't have a \fIkern\fR feature; +Always provide the \fI \-\-feature=kern\fR option to \fIotftotfm\fR, +even if the font doesn't have a \fIkern\fR feature; this will make \fIotftotfm\fR use the \fIkern\fR table if present. -For fonts without a \fIliga\fR feature, add \f(CW\*(C` \-\-ligkern\*(C'\fR +For fonts without a \fIliga\fR feature, add \fI \-\-ligkern\fR options for the common f\-ligatures to the \fIotftotfm\fR command line, so that any ligatures present in the font will still be used. -Bug fix: the generated \fI.sty\fR files now work for font families +Bug fix: the generated \fIsty\fR files now work for font families with names containing digits. .IP "\fI2009\-04\-09\fR" 12 .IX Item "2009-04-09" @@ -592,6 +655,6 @@ Prefixed the filenames of the included encoding files with \&\fIfontools_\fR, to prevent name clashes with other packages. .IP "\fI2009\-04\-06\fR" 12 .IX Item "2009-04-06" -A small patch to the \f(CW\*(C`make_ornament_encoding\*(C'\fR subroutine; -it now also recognises the \fIbullet.xxx\fR ornament glyphs -in Adobe's Kepler Pro. +A small patch to the \f(CW\*(C`get_orn\*(C'\fR subroutine: +it now also recognises the \fIbullet.xxx\fR ornament glyphs +in Adobe Kepler Pro. diff --git a/Master/texmf/doc/man/man1/autoinst.man1.pdf b/Master/texmf/doc/man/man1/autoinst.man1.pdf Binary files differindex 1e8719ab7e5..4d9927de987 100644 --- a/Master/texmf/doc/man/man1/autoinst.man1.pdf +++ b/Master/texmf/doc/man/man1/autoinst.man1.pdf diff --git a/Master/texmf/doc/man/man1/cmap2enc.1 b/Master/texmf/doc/man/man1/cmap2enc.1 deleted file mode 100644 index b57fc021fd1..00000000000 --- a/Master/texmf/doc/man/man1/cmap2enc.1 +++ /dev/null @@ -1,450 +0,0 @@ -.\" Automatically generated by Pod::Man version 1.15 -.\" Thu Feb 8 11:04:39 2007 -.\" -.\" Standard preamble: -.\" ====================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.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. | will give a -.\" real vertical bar. \*(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-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.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" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr -.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and -.\" index entries marked with X<> in POD. Of course, you'll have to process -.\" the output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it -.\" makes way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -.bd B 3 -. \" 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 "CMAP2ENC 1" -.TH CMAP2ENC 1 "fontools" "2007-02-08" "fontools" -.UC -.SH "NAME" -cmap2enc \- convert glyph indices in a TrueType-flavored OpenType font to -Adobe glyph names -.SH "SYNOPSIS" -.IX Header "SYNOPSIS" -cmap2enc [options] \fIfontfile\fR \fIencoding\fR -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -Many TrueType-flavored OpenType fonts contain no glyph names. -When creating an \fIafm\fR file with \fIttf2afm\fR, this causes all glyphs to be -named something -like \f(CW\*(C`index0x01E7\*(C'\fR, which makes the \fIafm\fR file almost useless for use with -\&\fIfontinst\fR or \fIafm2tfm\fR. -.PP -\&\fBcmap2enc\fR uses the font's `cmap' table to map glyph indices to -Unicode values, and Adobe's \fIglyphlist.txt\fR file to map these to glyph names. -.PP -\&\fBcmap2enc\fR creates a new encoding file (for downloading with the font file) -and a \fImtx\fR file (for use with \fIfontinst\fR). The encoding file contains the -same glyphs as the original one, but has all glyph names replaced with -the corresponding glyph indices; the \fImtx\fR file maps these glyph indices back -to the original glyph names (it consists of many commands of the form -\&\f(CW\*(C`\erenameGlyph{index0x01E7}{Euro}\*(C'\fR, plus a definition of that -\&\f(CW\*(C`\erenameGlyph\*(C'\fR command). -.PP -Some of the glyph substitution features of OpenType fonts are supported; -e.g. when the `smcp' (Small Caps) feature is specified, the glyph names -of the lowercase glyphs will be mapped to the glyph indices of the -small capitals. -.PP -A list of features supported by the font can be generated using the \fB\-p\fR -option, see below. -.SH "EXAMPLES" -.IX Header "EXAMPLES" -\&\s-1NOTE:\s0 the \fIexamples/\fR subdirectory in the \fIfontools\fR distribution contains -several complete examples of the use of \fBcmap2enc\fR and other tools from -the \fIfontools\fR collection. -.Ip "\fB-\fR" 2 -.IX Item "-" -To display all scripts, languages and features supported by Linotype Palatino: -.Sp -.Vb 1 -\& cmap2enc -p pala.ttf -.Ve -.Ip "\fB-\fR" 2 -.IX Item "-" -To install Linotype Palatino in T1 encoding, with oldstyle figures: -.RS 2 -.Ip "\fB1.\fR" 3 -.IX Item "1." -Generate an encoding file \fIt1\-tosf-pala.enc\fR and a metrics file -\&\fIresetpala-t1\-osf.mtx\fR: -.Sp -.Vb 1 -\& cmap2enc -f onum pala.ttf t1.enc -.Ve -.Ip "\fB2.\fR" 3 -.IX Item "2." -Create an \fIafm\fR file for the font; this is done best using \fIfont2afm\fR -(also in the \fIfontools\fR collection): -.Sp -.Vb 1 -\& font2afm pala.ttf -.Ve -.Ip "\fB3.\fR" 3 -.IX Item "3." -Reencode the \fIafm\fR file using the \fIt1\-tosf-pala.enc\fR encoding to create -a `raw' font \fIrlplrj9d\fR, with either \fIafm2afm\fR (also in the \fIfontools\fR -collection) or \fIfontinst\fR (but be warned that \fIfontinst\fR might take a long -time, and can even crash if the \fIafm\fR is really big): -.Sp -.Vb 1 -\& afm2afm -e t1-tosf-pala.enc -o rlplrj9d.afm pala.afm -.Ve -or -.Sp -.Vb 1 -\& \etransformfont{rlplrj9d}{\ereencodefont{t1-tosf-pala}{\efromafm{pala}}} -.Ve -.Ip "\fB4.\fR" 3 -.IX Item "4." -Create a `value-added' \fIvpl\fR file from this raw font by adding -ligatures, faking missing glyphs etc. with \fIfontinst\fR: -.Sp -.Vb 2 -\& \einstallfont{lplrj9d}{rlplrj9d,resetpala-t1-tosf,newlatin} -\& {t1}{T1}{lplj}{m}{n}{} -.Ve -.RE -.RS 2 -.RE -.SH "OPTIONS" -.IX Header "OPTIONS" -\&\fBcmap2enc\fR supports the following command-line options: -.Ip "\fB\-p\fR" 4 -.IX Item "-p" -Print some info about the font, plus a list of all scripts, languages and -features contained in this font's \s-1GSUB\s0 table; then exit. (When using -this option, the \fIencoding\fR need not be specified.) -.Ip "\fB\-f\fR \fIfeature\fR[,\fIfeature\fR]*" 4 -.IX Item "-f feature[,feature]*" -Use the specified features when matching glyph indices to glyph names. -Multiple features can be specified as a comma-separated list, -\&\fBwithout\fR spaces between the items. -.Ip "\fB\-x\fR \fIextra\fR" 4 -.IX Item "-x extra" -Use the user-specified substitutions from \fIextra\fR (see below). -.Ip "\fB\-l\fR \fIlanguage\fR" 4 -.IX Item "-l language" -Select the specified language. The default is `\s-1DFLT\s0' (surprise!). -.Ip "\fB\-s\fR \fIscript\fR" 4 -.IX Item "-s script" -Select the specified script. The default is `latn'. -.SH "FILES" -.IX Header "FILES" -All input files are searched using \fBkpsewhich\fR or \fBfindtexmf\fR when these -commands are available; otherwise only the current working directory -is searched. -.Ip "\fIfontfile\fR" 4 -.IX Item "fontfile" -The font file can be any OpenType font, though \fBcmap2enc\fR is probably only -useful for the TrueType-flavored variant (PostScript-flavored ones always -contain glyph names in the `\s-1CFF\s0' table). -.Ip "\fIencoding\fR" 4 -.IX Item "encoding" -The encoding files read and written by \fBcmap2enc\fR are in standard \fIdvips\fR -format. The name of the output encoding file is -\&\f(CW\*(C`<encoding>\-<suffix>\-<font>.enc\*(C'\fR, -.Sp -where -.RS 4 -.Ip "\fBencoding\fR" 10 -.IX Item "encoding" -is the name of the input encoding file (without the extension `.enc'); -.Ip "\fBsuffix\fR" 10 -.IX Item "suffix" -names the OpenType features you specified: -.RS 10 -.Ip "\fItlf\fR" 10 -.IX Item "tlf" -for tabular lining figures (when neither the `onum' nor the `pnum' features -have been chosen) -.Ip "\fIlf\fR" 10 -.IX Item "lf" -for proportional width lining figures (when you've specified `pnum', -but not `onum') -.Ip "\fItosf\fR" 10 -.IX Item "tosf" -for tabular oldstyle figures (when you've specified `onum', but not `pnum') -.Ip "\fIosf\fR" 10 -.IX Item "osf" -for proportional width oldstyle figures (when both `onum' and `pnum' have been -chosen) -.Ip "\fIsc\fR" 10 -.IX Item "sc" -for small caps (`smcp' feature) -.Ip "\fIswash\fR" 10 -.IX Item "swash" -for swash (`swsh' feature) -.Ip "\fItitling\fR" 10 -.IX Item "titling" -for a titling font (`titl' feature) -.Ip "\fIsup\fR" 10 -.IX Item "sup" -for superior figures and (some) letters (`sups' feature) -.Ip "\fIorn\fR" 10 -.IX Item "orn" -for ornaments (`ornm' feature) -.RE -.RS 10 -.Sp -When several features have been specified, the \fBsuffix\fR is a combination -of the appropriate items; e.g., when you specify \-f onum,pnum,swsh (for a -swash font with proportional oldstyle figures) the \fBsuffix\fR is -\&\f(CW\*(C`osf\-swash\*(C'\fR. -.RE -.Ip "\fBfont\fR" 10 -.IX Item "font" -is the name of the input font file, without the `.ttf' or `.otf' extension. -.RE -.RS 4 -.RE -.Ip "\fImtx\fR" 4 -.IX Item "mtx" -The output \fImtx\fR file is in standard \fIfontinst\fR format. The name of this file -is \f(CW\*(C`reset<font>\-<encoding>\-<suffix>.mtx\*(C'\fR, -.Sp -where \fIfont\fR, \fIencoding\fR and \fIsuffix\fR have the same meaning as above. -.Ip "\fIextra\fR" 4 -.IX Item "extra" -The option \fB\-x\fR can be used to name a file containing extra substitutions -that complement or override the ones specified by the selected features. -It consists of one substitution per line; each is either of the form -\&\f(CW\*(C`<from>;<to>\*(C'\fR, where \fIfrom\fR and \fIto\fR are both glyph indices -(specified as four hexadecimal digits), or of the form -\&\f(CW\*(C`<glyph name>;<glyph index>\*(C'\fR, where \fIglyph name\fR is any glyph name -and \fIglyph index\fR the glyph index (again, four hex digits) that is to be -mapped to the specified glyph name. The \fIexamples/\fR subdirectory in the -\&\fIfontools\fR distribution contains some examples of user-defined -substitution files. -.SH "CAVEATS" -.IX Header "CAVEATS" -.Ip "\fB-\fR" 2 -.IX Item "-" -Most OpenType fonts contain several tables in the `cmap' table, -for different platforms and different encodings. -\&\fBcmap2enc\fR only reads the first table that implements Unicode, that is, -the first table with either platformID = 0 and encodingID = 3 or 4 -or platformID = 3 and encodingID = 1 or 10. -At least one of those will probably always be present, and (afaik) it doesn't -matter which of these is used. -.Sp -The fact that only tableFormat = 4 is supported might be more of a restriction, -though I haven't yet found any font that used a different tableFormat. -.Ip "\fB-\fR" 2 -.IX Item "-" -OpenType fonts implement features using so-called `Lookup Tables'. -\&\fBcmap2enc\fR supports only features from the `\s-1GSUB\s0' table that have -LookupType = 1 (single substitution). -.Sp -Some features are implemented as a combination of lookups from both -the `\s-1GSUB\s0' and the `\s-1GPOS\s0' tables; these features are (currently?) -not supported. An example of this are the `sinf' (Scientific Inferiors) and -\&'subs' (Subscripts) features of Linotype Palatino; these are implemented -by first replacing the standard numerals with smaller ones and then -adjusting their position. -.Ip "\fB-\fR" 2 -.IX Item "-" -Some of the font's features may yield surprising results. E.g., Linotype -Palatino doesn't have small-caps forms of dotlessi, germandbls and the -standard f-ligatures, so it will give you the lowercase forms of these glyphs -even when the `smcp' feature is specified. -(The \fIexamples/palatinox\fR subdirectory contains a file \fIunsetSCaps.mtx\fR -that deletes these lowercase forms; \fIfontinst\fR's \fInewlatin.mtx\fR file -will then create fake small-caps forms of these glyphs.) -.Ip "\fB-\fR" 2 -.IX Item "-" -If the user-defined substitution file substitutes glyph1 with glyph2, -\&\fBcmap2enc\fR will also substitute glyph2 with glyph2; this may seem silly, -but it means that any selected feature that would substitute glyph2 with glyph3 -gets overridden. -.Ip "\fB-\fR" 2 -.IX Item "-" -The glyph names are independent of the features selected, e.g., when using -features like `smcp' or `onum', glyph names still come out as `a' and `zero' -rather than `Asmall' and `zerooldstyle'. When installing the font with -\&\fIfontinst\fR, you should therefore always use \fIt1.etx\fR rather than \fIt1c.etx\fR -or \fIt1j.etx\fR. -.SH "SEE ALSO" -.IX Header "SEE ALSO" -The other programs in the \fIfontools\fR bundle: \fIafm2afm\fR, \fIautoinst\fR, -\&\fIfont2afm\fR, \fIot2kpx\fR, \fIpfm2kpx\fR, \fIshowglyphs\fR. -.PP -A good free (as in beer) Perl-implementation for Windows (and Linux) -is ActivePerl, available from \fIhttp://www.activestate.com\fR. -.SH "AUTHOR" -.IX Header "AUTHOR" -Marc Penninga <marc@penninga.info> -.PP -If you're sending a bug report, please give as much information as possible. -Also be sure to mention the name \fIfontools\fR somewhere in the subject line, -or risk being caught by my spam filter. -.SH "COPYRIGHT" -.IX Header "COPYRIGHT" -Copyright (c) 2005, 2006 Marc Penninga. -.SH "LICENSE" -.IX Header "LICENSE" -This program is free software; you can redistribute it and/or modify -it under the terms of version 2 of the \s-1GNU\s0 General Public License -as published by the Free Software Foundation. -.PP -A copy of the \s-1GNU\s0 General Public License is included with the \fIfontools\fR -collection; see the file \fIGPLv2.txt\fR. -.SH "DISCLAIMER" -.IX Header "DISCLAIMER" -This program is distributed in the hope that it will be useful, -but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of -\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0. See the -\&\s-1GNU\s0 General Public License for more details. -.SH "HISTORY" -.IX Header "HISTORY" -.Ip "\fI2006\-01\-17\fR" 12 -.IX Item "2006-01-17" -Changed the names of the generated output files; extended the documentation. -.Ip "\fI2005\-08\-01\fR" 12 -.IX Item "2005-08-01" -Removed some warning messages that didn't convey any useful information; -added contents of \fIglyphlist.txt\fR to the program itself and removed -the file from the \fIfontools\fR collection; -expanded the example in the documentation -.Ip "\fI2005\-04\-29\fR" 12 -.IX Item "2005-04-29" -Improved the documentation -.Ip "\fI2005\-03\-21\fR" 12 -.IX Item "2005-03-21" -Fixed somed bugs; added `titl' feature -.Ip "\fI2005\-03\-15\fR" 12 -.IX Item "2005-03-15" -Input files searched using \fBkpsewhich\fR or \fBfindtexmf\fR -.Ip "\fI2005\-03\-08\fR" 12 -.IX Item "2005-03-08" -Input files searched via \fBkpsewhich\fR (where available) -.Ip "\fI2005\-02\-18\fR" 12 -.IX Item "2005-02-18" -Rewrote some of the code, fixed a few bugs -.Ip "\fI2005\-01\-10\fR" 12 -.IX Item "2005-01-10" -First version diff --git a/Master/texmf/doc/man/man1/cmap2enc.man1.pdf b/Master/texmf/doc/man/man1/cmap2enc.man1.pdf Binary files differdeleted file mode 100644 index e943fb56c1e..00000000000 --- a/Master/texmf/doc/man/man1/cmap2enc.man1.pdf +++ /dev/null diff --git a/Master/texmf/doc/man/man1/font2afm.1 b/Master/texmf/doc/man/man1/font2afm.1 deleted file mode 100644 index a692930536e..00000000000 --- a/Master/texmf/doc/man/man1/font2afm.1 +++ /dev/null @@ -1,196 +0,0 @@ -.\" Automatically generated by Pod::Man version 1.15 -.\" Wed Aug 30 11:37:48 2006 -.\" -.\" Standard preamble: -.\" ====================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.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. | will give a -.\" real vertical bar. \*(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-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.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" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr -.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and -.\" index entries marked with X<> in POD. Of course, you'll have to process -.\" the output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it -.\" makes way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -.bd B 3 -. \" 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 "FONT2AFM 1" -.TH FONT2AFM 1 "fontools" "2006-08-30" "fontools" -.UC -.SH "NAME" -font2afm \- create font metrics (in \fIafm\fR format) for (almost) any font file -.SH "SYNOPSIS" -.IX Header "SYNOPSIS" -font2afm [options] \fIfont\fR ... -.PP -font2afm [options] @\fIfilelist\fR -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -\&\fBfont2afm\fR generates font metrics (in Adobe's \fIafm\fR format) for Type1, -TrueType and OpenType fonts. -.PP -\&\fBfont2afm\fR is just a wrapper script around several utilities (\fBcfftot1\fR, -\&\fBpf2afm\fR, \fBttf2afm\fR, \fBpfm2kpx\fR and \fBot2kpx\fR) that do the real work. -All these utilities need to be available on your system. -.SH "OPTIONS" -.IX Header "OPTIONS" -.Ip "\fB\-f\fR" 4 -.IX Item "-f" -Force overwriting of existing \fIafm\fR files. -.SH "FILES" -.IX Header "FILES" -.Ip "\fIfont\fR" 4 -.IX Item "font" -This can be any Type1 (in either \fIpfa\fR or \fIpfb\fR format), TrueType or -OpenType (both PostScript- and TrueType-flavored) font. -.Ip "\fIfilelist\fR" 4 -.IX Item "filelist" -This should contain a newline-separated list of font filenames. -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIpf2afm\fR (part of \fIGhostScript\fR), \fIttf2afm\fR (part of \fIpdfTeX\fR), -\&\fIafm2afm\fR, \fIautoinst\fR, \fIcmap2enc\fR, \fIot2kpx\fR, \fIpfm2kpx\fR, \fIcfftot1\fR -(part of Eddie Kohler's \fI\s-1LCDF\s0 TypeTools\fR). -.SH "AUTHOR" -.IX Header "AUTHOR" -Marc Penninga <marc@penninga.info> -.SH "HISTORY" -.IX Header "HISTORY" -.Ip "\fI2005\-04\-15\fR" 12 -.IX Item "2005-04-15" -First version -.Ip "\fI2005\-04\-29\fR" 12 -.IX Item "2005-04-29" -Improved the documentation -.Ip "\fI2005\-05\-23\fR" 12 -.IX Item "2005-05-23" -Bugfix. -.Ip "\fI2005\-07\-29\fR" 12 -.IX Item "2005-07-29" -Added support for PostScript-flavored (\fIotf\fR) OpenType fonts. -.Ip "\fI2005\-08\-08\fR" 12 -.IX Item "2005-08-08" -Bugfix. diff --git a/Master/texmf/doc/man/man1/font2afm.man1.pdf b/Master/texmf/doc/man/man1/font2afm.man1.pdf Binary files differdeleted file mode 100644 index d86a61bfbcf..00000000000 --- a/Master/texmf/doc/man/man1/font2afm.man1.pdf +++ /dev/null diff --git a/Master/texmf/doc/man/man1/ot2kpx.1 b/Master/texmf/doc/man/man1/ot2kpx.1 index 1c180d772ea..c761d2e9ef4 100644 --- a/Master/texmf/doc/man/man1/ot2kpx.1 +++ b/Master/texmf/doc/man/man1/ot2kpx.1 @@ -1,26 +1,11 @@ -.\" Automatically generated by Pod::Man version 1.15 -.\" Mon Apr 2 10:44:41 2007 +.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) .\" .\" Standard preamble: -.\" ====================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. +.\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. .de Vb \" Begin verbatim text .ft CW .nf @@ -28,16 +13,15 @@ .. .de Ve \" End verbatim text .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. | will give a -.\" real vertical bar. \*(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-|\(bv\*(Tr +.\" 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' .ie n \{\ . ds -- \(*W- @@ -56,26 +40,28 @@ . ds R" '' 'br\} .\" -.\" If the F register is turned on, we'll generate index entries on stderr -.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and -.\" index entries marked with X<> in POD. Of course, you'll have to process -.\" the output yourself in some meaningful fashion. -.if \nF \{\ +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" +.\" If the F register is turned on, we'll generate index entries on stderr for +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index +.\" entries marked with X<> in POD. Of course, you'll have to process the +.\" output yourself in some meaningful fashion. +.ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it -.\" makes way too many mistakes in technical documents. -.hy 0 -.if n .na +.el \{\ +. de IX +.. +.\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. -.bd B 3 . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 @@ -135,71 +121,93 @@ . ds Ae AE .\} .rm #[ #] #H #V #F C -.\" ====================================================================== +.\" ======================================================================== .\" .IX Title "OT2KPX 1" -.TH OT2KPX 1 "fontools" "2007-04-02" "fontools" -.UC +.TH OT2KPX 1 "2012-03-06" "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" -ot2kpx \- extract kerning information from an OpenType font +ot2kpx \- extract kerning information from OpenType fonts .SH "SYNOPSIS" .IX Header "SYNOPSIS" -ot2kpx \fIfont\fR +.IP "\fBot2kpx\fR" 8 +.IX Item "ot2kpx" +\&\fBfontfile\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" -In many OpenType fonts, most kerning data is stored in the `\s-1GPOS\s0' table rather -than in the `kern' table. \fBot2kpx\fR extracts the kerning data from both tables -and prints it (in \fIafm\fR format) to \f(CW\*(C`stdout\*(C'\fR. +\&\fBot2kpx\fR extract the kerning data from OpenType fonts (both \fIotf\fR +and \fIttf\fR formats) and prints it (in \fIafm\fR format) to \f(CW\*(C`stdout\*(C'\fR. +.SH "OPTIONS AND ARGUMENTS" +.IX Header "OPTIONS AND ARGUMENTS" +.IP "\fBfontfile\fR" 4 +.IX Item "fontfile" +The OpenType font (in either \fIotf\fR or \fIttf\fR format). .SH "RESTRICTIONS" .IX Header "RESTRICTIONS" -.Ip "\fB-\fR" 2 +.IP "\fB\-\fR" 4 .IX Item "-" -\&\fBot2kpx\fR prints data from all features named `kern', regardless of script -and language. Maybe it would be better to let the user choose a script -and language (defaulting to `latn' and `\s-1DFLT\s0') and print only the kerning -data from features associated with these values. -.Ip "\fB-\fR" 2 +\&\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 +other types of data than just XAdvance data. +.Sp +Most of these limitations don't really 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, some of these features concern +(according to the OpenType specification) \fI\*(L"define subtle, device-dependent +adjustments at specific font sizes or device resolutions\*(R"\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 .IX Item "-" -\&\fBot2kpx\fR uses only the XAdvance data associated with the first glyph in any -kerning pair; all other data in the ValueRecords is ignored. I'm not sure -whether this is The Right Thing to Do; however, almost always there is -no other data, so this approach gives correct results (in fact, the only -font I know of that does contain data other than XAdvance is Linotype -Palatino; this also contains XAdvDevice data, which is used (according to -the OpenType specification) to \fI`define subtle, device-dependent adjustments -at specific font sizes or device resolutions'\fR. Since there is no way to -express such adjustments in \fIafm\fR format, ignoring them seems to be the -only option.) -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIafm2afm\fR, \fIautoinst\fR, \fIcmap2enc\fR, \fIfont2afm\fR, \fIpfm2kpx\fR. +\&\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 +occurs multiple times, the first value seen is chosen. +There are (or may be) several issues with this approach: +.RS 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\s0\*(R" table. +Many such fonts do, however, contain a \*(L"kern\*(R" table, but no \*(L"\s-1GPOS\s0\*(R" table; +so we use the \*(L"kern\*(R" 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 +wouldn't make any difference (apart from further complicating the code). +.RE +.RS 4 +.RE .SH "AUTHOR" .IX Header "AUTHOR" -Marc Penninga <marc@penninga.info> -.SH "HISTORY" -.IX Header "HISTORY" -.Ip "\fI2005\-01\-10\fR" 12 -.IX Item "2005-01-10" -First version -.Ip "\fI2005\-02\-18\fR" 12 -.IX Item "2005-02-18" -Rewrote some of the code -.Ip "\fI2005\-03\-08\fR" 12 -.IX Item "2005-03-08" -Input files searched via \fBkpsewhich\fR (where available) -.Ip "\fI2005\-03\-15\fR" 12 -.IX Item "2005-03-15" -Input files searched using \fBkpsewhich\fR or \fBfindtexmf\fR -.Ip "\fI2005\-03\-21\fR" 12 -.IX Item "2005-03-21" -Test if \s-1GPOS\s0 table is present before trying to read it -.Ip "\fI2005\-04\-29\fR" 12 -.IX Item "2005-04-29" -Improved the documentation -.Ip "\fI2005\-05\-25\fR" 12 -.IX Item "2005-05-25" -Changed warning that's given when the font contains no \s-1GPOS\s0 table, to an -informational message. -.Ip "\fI2005\-07\-29\fR" 12 -.IX Item "2005-07-29" -A few updates to the documentation +Marc Penninga <marcpenninga@gmail.com> +.SH "COPYRIGHT" +.IX Header "COPYRIGHT" +Copyright (C) 2005\-2012 Marc Penninga. +.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 +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 \fBautoinst\fR; +see the file \fIGPLv2.txt\fR. +.SH "DISCLAIMER" +.IX Header "DISCLAIMER" +This program is distributed in the hope that it will be useful, +but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of +\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0. +See the \s-1GNU\s0 General Public License for more details. +.SH "RECENT CHANGES" +.IX Header "RECENT CHANGES" +(See the source code for the rest of the story.) +.IP "\fI2012\-02\-01\fR" 12 +.IX Item "2012-02-01" +Refactored the code, and fixed a number of bugs in the process. +Updated the documentation. diff --git a/Master/texmf/doc/man/man1/ot2kpx.man1.pdf b/Master/texmf/doc/man/man1/ot2kpx.man1.pdf Binary files differindex 5c3509f20bf..93a2d785375 100644 --- a/Master/texmf/doc/man/man1/ot2kpx.man1.pdf +++ b/Master/texmf/doc/man/man1/ot2kpx.man1.pdf diff --git a/Master/texmf/doc/man/man1/pfm2kpx.1 b/Master/texmf/doc/man/man1/pfm2kpx.1 deleted file mode 100644 index 0f3f38b6455..00000000000 --- a/Master/texmf/doc/man/man1/pfm2kpx.1 +++ /dev/null @@ -1,208 +0,0 @@ -.\" Automatically generated by Pod::Man version 1.15 -.\" Fri Jul 29 13:54:23 2005 -.\" -.\" Standard preamble: -.\" ====================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.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. | will give a -.\" real vertical bar. \*(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-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.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" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr -.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and -.\" index entries marked with X<> in POD. Of course, you'll have to process -.\" the output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it -.\" makes way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -.bd B 3 -. \" 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 "PFM2KPX 1" -.TH PFM2KPX 1 "fontools" "2005-07-29" "fontools" -.UC -.SH "NAME" -pfm2kpx \- extract correct kerning information from \fIpfm\fR -(Printer Font Metrics) files -.SH "SYNOPSIS" -.IX Header "SYNOPSIS" -pfm2kpx [options] \fIpfm\fR -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -Many PostScript Type1 fonts contain only -\&\fIpfb\fR and \fIpfm\fR files, but no \fIafm\fR (Adobe Font Metrics) files. These can be -generated with \fIpf2afm\fR (which comes with \fIGhostScript\fR), but -this might not yield all kerning pairs from the \fIpfm\fR file. The reason -for this is that \fIpf2afm\fR interprets \f(CW\*(C`dfCharSet = 0x00\*(C'\fR to mean that -the Adobe StandardEncoding has been used, whereas many fonts (or font -creation tools) instead use the Windows \s-1ANSI\s0 (aka codepage 1252) encoding. -(You know you've hit this problem when \fBpf2afm\fR complains "\f(CW\*(C`.notdef -character ocurred among kern pairs \-\- you'd better check the resulting -AFM file\*(C'\fR".) In this case, the resulting \fIafm\fR is incomplete and contains -wrong kerning pairs. -.PP -\&\fBpfm2kpx\fR extracts the correct kerning pairs from such \fIpfm\fR files and -repairs the \fIafm\fR (if necessary creating it first by running \fIpf2afm\fR). -If for some reason it can't update the \fIafm\fR, it prints the kerning pairs to -\&\f(CW\*(C`stdout\*(C'\fR instead. -.PP -When \fIpf2afm\fR doesn't complain about the kerning pairs, \fBpfm2kpx\fR -thinks the resulting \fIafm\fR file is fine and quits; this can be -changed by specifying the \fB\-f\fR option (see below). -.SH "OPTIONS" -.IX Header "OPTIONS" -.Ip "\fB\-f\fR" 4 -.IX Item "-f" -Force updating of the \fIafm\fR file, even if \fIpf2afm\fR doesn't complain. -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIpf2afm\fR (part of GhostScript), \fIafm2afm\fR, \fIautoinst\fR, \fIcmap2enc\fR, -\&\fIfont2afm\fR, \fIot2kpx\fR. -.SH "AUTHOR" -.IX Header "AUTHOR" -Marc Penninga <marc@penninga.info> -.SH "HISTORY" -.IX Header "HISTORY" -.Ip "\fI2005\-02\-17\fR" 12 -.IX Item "2005-02-17" -First version -.Ip "\fI2005\-02\-18\fR" 12 -.IX Item "2005-02-18" -Added \f(CW\*(C`binmode PFM\*(C'\fR to make \fBpfm2kpx\fR work on Windows platforms -.Ip "\fI2005\-03\-08\fR" 12 -.IX Item "2005-03-08" -Input files searched via \fBkpsewhich\fR (where available) -.Ip "\fI2005\-03\-14\fR" 12 -.IX Item "2005-03-14" -Rewrote some of the code to make it more robust, added the \fB\-f\fR option -.Ip "\fI2005\-03\-15\fR" 12 -.IX Item "2005-03-15" -Input files searched using \fBkpsewhich\fR or \fBfindtexmf\fR -.Ip "\fI2005\-04\-29\fR" 12 -.IX Item "2005-04-29" -Improved the documentation -.Ip "\fI2005\-05\-24\fR" 12 -.IX Item "2005-05-24" -Bugfix. -.Ip "\fI2005\-07\-29\fR" 12 -.IX Item "2005-07-29" -Some updates to the documentation. diff --git a/Master/texmf/doc/man/man1/pfm2kpx.man1.pdf b/Master/texmf/doc/man/man1/pfm2kpx.man1.pdf Binary files differdeleted file mode 100644 index dc4c78121a9..00000000000 --- a/Master/texmf/doc/man/man1/pfm2kpx.man1.pdf +++ /dev/null diff --git a/Master/texmf/doc/man/man1/showglyphs.1 b/Master/texmf/doc/man/man1/showglyphs.1 deleted file mode 100644 index 06165b1be0f..00000000000 --- a/Master/texmf/doc/man/man1/showglyphs.1 +++ /dev/null @@ -1,185 +0,0 @@ -.\" Automatically generated by Pod::Man version 1.15 -.\" Fri Jul 29 13:54:24 2005 -.\" -.\" Standard preamble: -.\" ====================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.de Vb \" Begin verbatim text -.ft CW -.nf -.ne \\$1 -.. -.de Ve \" End verbatim text -.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. | will give a -.\" real vertical bar. \*(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-|\(bv\*(Tr -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' -.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" '' -'br\} -.\" -.\" If the F register is turned on, we'll generate index entries on stderr -.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and -.\" index entries marked with X<> in POD. Of course, you'll have to process -.\" the output yourself in some meaningful fashion. -.if \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" -.. -. nr % 0 -. rr F -.\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it -.\" makes way too many mistakes in technical documents. -.hy 0 -.if n .na -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -.bd B 3 -. \" 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 "SHOWGLYPHS 1" -.TH SHOWGLYPHS 1 "fontools" "2005-07-29" "fontools" -.UC -.SH "NAME" -showglyphs \- create a \fIpdf\fR file that shows all glyphs in a font -.SH "SYNOPSIS" -.IX Header "SYNOPSIS" -showglyphs \fIfontfile\fR -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" -This program creates a \fIpdf\fR file that shows all glyphs in a given font. -.SH "FILES" -.IX Header "FILES" -.Ip "\fIfont\fR" 4 -.IX Item "font" -This can be any Type 1 or TrueType font; OpenType fonts are not (yet?) -supported. -.SH "RESTRICTIONS" -.IX Header "RESTRICTIONS" -.Ip "\fB-\fR" 4 -.IX Item "-" -\&\fBshowglyphs\fR only works on Unix/Linux systems. -.Ip "\fB-\fR" 4 -.IX Item "-" -\&\fBshowglyphs\fR needs a working, TDS-compliant Tex installation -.SH "SEE ALSO" -.IX Header "SEE ALSO" -\&\fIafm2afm\fR, \fIautoinst\fR, \fIcmap2enc\fR, \fIpfm2kpx\fR, \fIenc2etx\fR, -\&\fIetx2enc\fR, \fIot2kpx\fR. -.SH "AUTHOR" -.IX Header "AUTHOR" -Marc Penninga <marc@penninga.info> -.SH "HISTORY" -.IX Header "HISTORY" -.Ip "\fI2005\-04\-28\fR" 12 -.IX Item "2005-04-28" -First version -.Ip "\fI2005\-04\-29\fR" 12 -.IX Item "2005-04-29" -A few bugfixes; \fBshowglyphs\fR now works with glyphnames containing underscores -.Ip "\fI2005\-05\-24\fR" 12 -.IX Item "2005-05-24" -Another bugfix -.Ip "\fI2005\-07\-29\fR" 12 -.IX Item "2005-07-29" -A few updates to the documentation diff --git a/Master/texmf/doc/man/man1/showglyphs.man1.pdf b/Master/texmf/doc/man/man1/showglyphs.man1.pdf Binary files differdeleted file mode 100644 index 554e6eaea8f..00000000000 --- a/Master/texmf/doc/man/man1/showglyphs.man1.pdf +++ /dev/null |