path: root/Master/texmf/doc/man/man1/autoinst.1

.\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.05)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.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.  \*(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-
.    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\}
.\"
.\" 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
.\}
.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.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "AUTOINST 1"
.TH AUTOINST 1 "2010-04-29" "fontools" "fontools"
.\" 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, 
for installing OpenType fonts in LaTeX.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
autoinst [options] \fIfontfile\fR [\fIfontfile\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.
.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), 
\&\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 
proportional variants), each with the following shapes:
.RS 2
.RS 2
.IP "\fIn\fR" 4
.IX Item "n"
Roman text
.IP "\fIsc\fR" 4
.IX Item "sc"
Small caps
.IP "\fInw\fR" 4
.IX Item "nw"
`Upright swash'; usually normal text with some extra `oldstyle' ligatures, 
such as ct, sp and st.
.IP "\fItl\fR" 4
.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
.IX Item "it"
Italic or oblique text
.IP "\fIscit\fR" 4
.IX Item "scit"
Italic small caps
.IP "\fIsw\fR" 4
.IX Item "sw"
Swash
.IP "\fItlit\fR" 4
.IX Item "tlit"
Italic titling
.RE
.RS 2
.RE
.RE
.RS 2
.RE
.IP "\fB\-\fR" 2
.IX Item "-"
For each text family: a family of TS1\-encoded symbol fonts, 
in roman and italic shapes.
.IP "\fB\-\fR" 2
.IX Item "-"
Four families with superiors, inferiors, numerators and denominators,
in roman and italic shapes.
.IP "\fB\-\fR" 2
.IX Item "-"
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).
.PP
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"
proportional (i.e., figures have varying widths) lining figures
.IP "\fI\s-1TLF\s0\fR" 8
.IX Item "TLF"
tabular (i.e., all figures have the same width) lining figures
.IP "\fIOsF\fR" 8
.IX Item "OsF"
proportional oldstyle figures
.IP "\fITOsF\fR" 8
.IX Item "TOsF"
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)
.IP "\fIInf\fR" 8
.IX Item "Inf"
inferior characters; usually only figures and punctuation, 
normal forms for the other characters
.IP "\fIOrn\fR" 8
.IX Item "Orn"
ornaments
.IP "\fINumr\fR" 8
.IX Item "Numr"
numerators
.IP "\fIDnom\fR" 8
.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.
.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 
\&\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.
.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).
.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 
(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 
(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. 
For example: to increase the size of the font by 5%, use the command
\&\f(CW\*(C`\eusepackage[scaled=1.05]{MyriadPro}\*(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 end of the current group) of its own:
.PP
.Vb 1
\&    DECLARATION     COMMAND         SHORT FORM OF COMMAND
\&    
\&    \etlshape        \etexttitling    \etexttl
\&    \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.
.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, 
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, 
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).
.PP
These commands are only generated for shapes and number 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.
.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.
.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).
.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]
.Ve
.IP "[1]" 4
.IX Item "[1]"
When \fIboth\fR weight and width are empty, the `series' attribute becomes `m'.
.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.
.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.
.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.
.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.)
.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"
.PD 0
.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"
.PD 0
.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"
.PD 0
.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"
.PD 0
.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"
.PD 0
.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"
.PD 0
.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"
.PD 0
.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"
.PD 0
.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"
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 
being interpreted as options to \fBautoinst\fR, it should be properly quoted.
.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)
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.
.PP
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), 
but the project appears to have been abandoned;
these files don't work with recent 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
.PP
\&\f(CW\*(C`autoinst \f(CI(... all options and files ...)\f(CW  >autoinst.log 2>&1\*(C'\fR
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2005, 2006, 2007, 2009, 2010 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.
.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 full story.)
.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 
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 
by the current font, and whose generation has not been
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; 
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
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
with names containing digits.
.IP "\fI2009\-04\-09\fR" 12
.IX Item "2009-04-09"
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.