summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/autoinst.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/man/man1/autoinst.1')
-rw-r--r--Master/texmf/doc/man/man1/autoinst.172
1 files changed, 40 insertions, 32 deletions
diff --git a/Master/texmf/doc/man/man1/autoinst.1 b/Master/texmf/doc/man/man1/autoinst.1
index 1b26a2dd3f2..16635636e35 100644
--- a/Master/texmf/doc/man/man1/autoinst.1
+++ b/Master/texmf/doc/man/man1/autoinst.1
@@ -124,7 +124,7 @@
.\" ========================================================================
.\"
.IX Title "AUTOINST 1"
-.TH AUTOINST 1 "2010-04-23" "fontools" "fontools"
+.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
@@ -143,10 +143,12 @@ 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. All the user then needs
+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
-(\f(CW\*(C`$LOCALTEXMF/tex/latex/<Supplier>/<FontFamily>/\*(C'\fR being the
-canonical choice) and update TeX's filename database.
+(\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:
@@ -254,8 +256,7 @@ A typical name in this scheme is \fIMinionPro\-Regular\-osf\-sc\-ly1\fR.
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
+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"
@@ -293,8 +294,8 @@ 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).
+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)
@@ -330,11 +331,14 @@ 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, or even plain TeX's \f(CW\*(C`\efont\*(C'\fR primitive
-(and it's called `primitive' for a reason!)
+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
@@ -345,8 +349,6 @@ 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.
-(\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
@@ -398,11 +400,10 @@ 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.
+about the new font map files; see the documentation for how this is done.
.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
+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"
@@ -513,24 +514,22 @@ being interpreted as options to \fBautoinst\fR, it should be properly quoted.
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);
+on Windows, try ActivePerl (available from \fIhttp://www.activestate.com\fR)
+or Strawberry Perl (\fIhttp://strawberryperl.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.
+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
-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.
+John Owens' \fIotfinst\fR (available from \s-1CTAN\s0) is another wrapper
+around \fIotftotfm\fR, and may work when \fBautoinst\fR doesn't.
.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.
+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>
@@ -552,7 +551,6 @@ 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.
-.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"
@@ -564,6 +562,16 @@ but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty
.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,