install fontools utilities (10apr09)

git-svn-id: svn://tug.org/texlive/trunk@12687 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 583 insertions, 0 deletions

diff --git a/Master/texmf/doc/man/man1/autoinst.1 b/Master/texmf/doc/man/man1/autoinst.1
new file mode 100644
index 00000000000..2861af70cdc
--- /dev/null
+++ b/Master/texmf/doc/man/man1/autoinst.1
@@ -0,0 +1,583 @@
+.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
+.\"
+.\" 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 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 (.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.
+.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 "2009-04-09" "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, mainly \fIotftotfm\fR, are great tools for 
+installing OpenType fonts for use with LaTeX, but their use (even in 
+automatic mode) is quite complicated; they need lots of long 
+command lines and don'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. All the user then needs
+to do is move these files to a suitable location 
+(\f(CW\*(C`$LOCALTEXMF/tex/latex/<Supplier>/<FontFamily>/\*(C'\fR is the
+canonical 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.
+.Sh "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.
+.PP
+A different encoding can be selected using the \fB \-\-encoding\fR 
+command line option (see below).
+.Sh "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 \fIbase\-v2.zip\fR
+(\fIhttp://www.ctan.org/tex\-archive/fonts/minionpro/base\-v2.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
+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, or even plain TeX's \f(CW\*(C`\efont\*(C'\fR primitive
+(and it's called `primitive' for a reason!)
+.Sh "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.
+.Sh "\s-1NFSS\s0 codes"
+.IX Subsection "NFSS codes"
+In \s-1NFSS\s0, weight and width are concatenated into a single `series' attribute.
+(\fINote:\fR versions of \fBautoinst\fR before 2007\-07\-27 erroneously formed
+the series as `width plus weight' instead of the reverse.)
+\&\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.
+.Sh "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; this usually means editing some 
+configuration file.
+.PP
+Furthermore, 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 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;
+for Windows, good (and free) Perl implementations are 
+Strawberry Perl (\fIhttp://strawberryperl.com\fR) and
+ActivePerl (available from \fIhttp://www.activestate.com\fR);
+.PP
+John Owens' \fIotfinst\fR (\fIhttp://www.ece.ucdavis.edu/~jowens/code/otfinst/\fR;
+also available from \s-1CTAN\s0) is another wrapper around \fIotftotfm\fR, 
+and may work for you when \fBautoinst\fR doesn't.
+.PP
+Ready-made support files for MinionPro, providing more options and features
+than \fBautoinst\fR ever will (including math), are available from 
+\&\fIhttp://developer.berlios.de/projects/minionpro/\fR.
+.PP
+XeTeX (\fIhttp://scripts.sil.org/xetex\fR) is a TeX extension that can use 
+any font installed in the operating system (including both flavours of
+OpenType fonts) without additional support files.
+It also isn't hindered by standard TeX's limitation to 8\-bit fonts,
+so it is especially well suited to fonts with many ligatures and 
+alternate glyphs, such as Bickham, Poetica and Zapfino.
+.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
+.Vb 1
+\&    autoinst (... all options and files ...)  >autoinst.log 2>&1
+.Ve
+.SH "COPYRIGHT"
+.IX Header "COPYRIGHT"
+Copyright (c) 2005\-2009 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 "RECENT CHANGES"
+.IX Header "RECENT CHANGES"
+(See the source code for the full story.)
+.IP "\fI2009\-04\-09\fR" 12
+.IX Item "2009-04-09"
+Prefixed the filenames of  the included encoding files with
+`fontools_', to prevent name clashes with other packages.
+.IP "\fI2009\-04\-06\fR" 12
+.IX Item "2009-04-06"
+A small patch to the make_ornament_encoding subroutine;
+it now also recognises the \fIbullet.xxx\fR ornament glyphs 
+in Adobe's Kepler Pro.