summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/autoinst.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-01-04 23:43:17 +0000
committerKarl Berry <karl@freefriends.org>2014-01-04 23:43:17 +0000
commit8022124f48acd9f4ed4ed26360a387430d106bae (patch)
treee6782af8db073e4d44555ada6e43c743771c998b /Master/texmf-dist/doc/man/man1/autoinst.1
parent8c5c1f73c2baa1475314d9ac23b6361e1a70e5e9 (diff)
fontools (4jan14)
git-svn-id: svn://tug.org/texlive/trunk@32573 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/autoinst.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/autoinst.184
1 files changed, 44 insertions, 40 deletions
diff --git a/Master/texmf-dist/doc/man/man1/autoinst.1 b/Master/texmf-dist/doc/man/man1/autoinst.1
index 12d17b13ae9..ebdf80dfa6c 100644
--- a/Master/texmf-dist/doc/man/man1/autoinst.1
+++ b/Master/texmf-dist/doc/man/man1/autoinst.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "AUTOINST 1"
-.TH AUTOINST 1 "2013-10-31" "fontools" "Marc Penninga"
+.TH AUTOINST 1 "2014-01-03" "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
@@ -431,7 +431,7 @@ 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\*(R"\s0 below) to specify a \s-1TEXMF\s0 tree.
.PP
-Also, some OpenType fonts lead to \fIpl\fR and \fIvpl\fR files that
+Also, some OpenType fonts may 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.
@@ -445,6 +445,12 @@ You may use either one or two dashes before options,
and option names may be shortened to a unique prefix
(e.g., \fB\-encoding\fR may be abbreviated to \fB\-enc\fR or even \fB\-en\fR,
but \fB\-e\fR is ambiguous (\fB\-encoding\fR, \fB\-extra\fR).
+.IP "\fB\-dryrun\fR" 4
+.IX Item "-dryrun"
+Don't actually generate any fonts and files, only create a logfile
+showing which fonts would be generated.
+By default, this information is written to \fIautoinst.log\fR;
+use the \fB\-logfile\fR option to specify a different filename.
.IP "\fB\-encoding\fR=\fIencoding[,encoding]\fR" 4
.IX Item "-encoding=encoding[,encoding]"
Generate the specified encoding(s) for the text fonts. The default is \*(L"\s-1OT1,T1,LY1\*(R".\s0
@@ -473,6 +479,22 @@ Install the font as a typewriter font, accessed via \f(CW\*(C`\ettfamily\*(C'\fR
\&\f(CW\*(C`\etexttt\*(C'\fR.
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\-lining\fR / \fB\-nolining\fR" 4
+.IX Item "-lining / -nolining"
+Control the creation of fonts with lining figures. The default is
+\&\fB\-lining\fR.
+.IP "\fB\-oldstyle\fR / \fB\-nooldstyle\fR" 4
+.IX Item "-oldstyle / -nooldstyle"
+Control the creation of fonts with oldstyle figures. The default is
+\&\fB\-oldstyle\fR.
+.IP "\fB\-proportional\fR / \fB\-noproportional\fR" 4
+.IX Item "-proportional / -noproportional"
+Control the creation of fonts with proportional figures. The default is
+\&\fB\-proportional\fR.
+.IP "\fB\-tabular\fR / \fB\-notabular\fR" 4
+.IX Item "-tabular / -notabular"
+Control the creation of fonts with tabular figures. The default is
+\&\fB\-tabular\fR.
.IP "\fB\-smallcaps\fR / \fB\-nosmallcaps\fR" 4
.IX Item "-smallcaps / -nosmallcaps"
Control the creation of small caps fonts. The default is
@@ -500,12 +522,18 @@ The default is \fB\-nofractions\fR.
Control the creation of ornament fonts. The default is \fB\-ornaments\fR.
.IP "\fB\-verbose\fR" 4
.IX Item "-verbose"
-Verbose mode; print detailed info about what \fBautoinst\fR thinks it's doing.
-.IP "\fB\-lining\fR / \fB\-oldstyle\fR" 4
-.IX Item "-lining / -oldstyle"
+Verbose mode; print detailed information about which fonts \fBautoinst\fR
+is generating. By default, this information is written to \fIautoinst.log\fR;
+a different filename can be specified using the \fB\-logfile\fR option.
+Repeat this option for even more detailed information.
+.IP "\fB\-logfile\fR=\fI\s-1LOGFILE\s0\fR" 4
+.IX Item "-logfile=LOGFILE"
+Write the logging information to \fI\s-1LOGFILE\s0\fR instead of \fIautoinst.log\fR.
+.IP "\fB\-defaultlining\fR / \fB\-defaultoldstyle\fR" 4
+.IX Item "-defaultlining / -defaultoldstyle"
.PD 0
-.IP "\fB\-tabular\fR / \fB\-proportional\fR" 4
-.IX Item "-tabular / -proportional"
+.IP "\fB\-defaulttabular\fR / \fB\-defaultproportional\fR" 4
+.IX Item "-defaulttabular / -defaultproportional"
.PD
Tell \fBautoinst\fR which figure style is the current font family's default
(i.e., which figures you get when you don't specify any OpenType features).
@@ -513,7 +541,8 @@ Tell \fBautoinst\fR which figure style is the current font family's default
\&\fIDon't use these options unless you are certain you need them!
They are only needed for fonts that don't provide OpenType features
for their default figure style; and even in that case,
-the default values (\f(BI\-lining\fI and \f(BI\-tabular\fI) are usually correct.\fR
+the default values (\f(BI\-defaultlining\fI and \f(BI\-defaulttabular\fI)
+are usually correct.\fR
.IP "\fB\-figurekern\fR / \fB\-nofigurekern\fR" 4
.IX Item "-figurekern / -nofigurekern"
Some fonts provide kerning pairs for tabular figures.
@@ -602,7 +631,7 @@ from running \fBautoinst\fR with the \fI\-verbose\fR option.
Please include all (if any) error messages as well.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
-Copyright (C) 2005\-2013 Marc Penninga.
+Copyright (C) 2005\-2014 Marc Penninga.
.SH "LICENSE"
.IX Header "LICENSE"
This program is free software; you can redistribute it and/or modify
@@ -620,6 +649,12 @@ but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
.SH "RECENT CHANGES"
.IX Header "RECENT CHANGES"
(See the source code for the rest of the story.)
+.IP "\fI2014\-01\-03\fR" 12
+.IX Item "2014-01-03"
+Added the \fI\-dryrun\fR and \fI\-logfile\fR options; changed which info is logged.
+Added the \fI\-lining\fR, \fI\-oldstyle\fR, \fI\-tabular\fR and \fI\-proportional\fR
+options; the old options with those names have been renamed to
+\&\fI\-defaultlining\fR, \fI\-defaultoldstyle\fR etc.
.IP "\fI2013\-10\-31\fR" 12
.IX Item "2013-10-31"
The previous change required Perl v5.14 or newer;
@@ -641,34 +676,3 @@ the \*(L"vendor\*(R" instead of the \*(L"typeface\*(R".
.IX Item "2013-01-03"
Added extra \*(L"ssub\*(R" rules to the \fIfd\fR files that substitute \*(L"b\*(R" for \*(L"bx\*(R".
Verbose mode now also prints all generated commands before they're executed.
-.IP "\fI2012\-10\-25\fR" 12
-.IX Item "2012-10-25"
-Added extra \*(L"ssub\*(R" rules to the \fIfd\fR files that substitute italic
-shapes for slanted ones.
-.IP "\fI2012\-09\-25\fR" 12
-.IX Item "2012-09-25"
-Added the \fI\-vendor\fR, \fI\-typeface\fR and \fI\-(no)updmap\fR command line options.
-.IP "\fI2012\-07\-06\fR" 12
-.IX Item "2012-07-06"
-Documentation update.
-.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, T1\s0 and \s-1LY1\s0 encoded text fonts by default.
-Made \fI\-titling\fR a default option (instead of \fI\-notitling\fR).
-Updated the documentation.