summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/otftotfm.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/man/man1/otftotfm.1')
-rw-r--r--Master/texmf/doc/man/man1/otftotfm.184
1 files changed, 51 insertions, 33 deletions
diff --git a/Master/texmf/doc/man/man1/otftotfm.1 b/Master/texmf/doc/man/man1/otftotfm.1
index e1d87b48cf6..1d46a440063 100644
--- a/Master/texmf/doc/man/man1/otftotfm.1
+++ b/Master/texmf/doc/man/man1/otftotfm.1
@@ -1,5 +1,5 @@
'\"t
-.ds V 2.69
+.ds V 2.79
.de M
.BR "\\$1" "(\\$2)\\$3"
..
@@ -7,7 +7,7 @@
.if n .sp
.if t .sp 0.4
..
-.de BUP
+.de Bp
.IP \(bu 3n
..
.TH OTFTOTFM 1 "LCDF Typetools" "Version \*V"
@@ -109,7 +109,9 @@ installations, you may first need to copy the system's
file to
.I $HOME/texmf/web2c
and run
-.M mktexlsr 1 .)
+.M mktexlsr 1 .
+On newer TeXLive installations, you may need to set the TEXMFVAR environment
+variable.)
You can then run "\fBotftotfm\fR
.B \-a
.IR fontfile
@@ -498,25 +500,23 @@ and 255. The default is taken from the encoding.
.Sp
.TP 5
.BI \-\-altselector\-char= char
-Set the font's alternate-selector character to
+Set the font's alternate selector character to
.IR char ,
-which should either be a single non-digit character, or a number between \-1
-and 255. Use an alternate selector if you want to choose between different
-versions of a character from within a TeX file. For instance, say that your
-font provides three versions of "A". If you want to access them all, pick a
-character to be your alternate selector -- say "*". Then give
-.B otftotfm
-the \&'\-\-altselector\-char="*"'
-option. In TeX, "A" will produce the normal version, "A*" will produce the
-first alternate, and "A**" will produce the second alternate. Furthermore,
-"s*t" will activate any discretionary "s_t" ligature in the font.
+which should either be a single non-digit character, or a number between
+\&\-1 and 255. Alternate selectors let TeX authors explicitly choose
+between versions of a character. For instance, the
+\&'\-\-altselector\-char="*"' option turns the "*" character into a special
+switch that cycles between alternates. For instance, the TeX input "A"
+would produce the normal version of the "A" Unicode character, "A*" would
+produce the first alternate, "A**" would produce the second alternate, and
+so forth. Furthermore, "s*t" will activate any discretionary "s_t"
+ligature in the font.
.Sp
The
.B \-\-altselector\-char
mechanism uses the features specified by
.BR \-\-altselector\-feature
-options. You don't need to turn on those features if you use
-.BR \-\-altselector .
+options.
.Sp
The alternate-selector character may also be specified in the encoding; see
ENCODINGS, below. See Sivan Toledo's article cited in the SEE ALSO section
@@ -819,6 +819,8 @@ Do not generate a font map line for the font.
.BI \-\-encoding\-directory= dir
.TP 5
.BI \-\-type1\-directory= dir
+.TP 5
+.BI \-\-truetype\-directory= dir
Set the directory used for various output types. Each directory may be set
by an environment variable, and defaults to a TDS directory in automatic
mode, or to "." otherwise. Environment variable names and default TDS
@@ -917,28 +919,32 @@ semicolons. For example,
.nf
% UNICODING pi1 =: uni03D6 ;
.fi
-tells otftotfm that the character "/pi1" encodes as U+03D6 GREEK PI SYMBOL,
+encodes the character "/pi1" as U+03D6 GREEK PI SYMBOL,
and
.nf
% UNICODING Delta =: uni0394 uni2206 ;
.fi
-tells it that U+0394 GREEK CAPITAL LETTER DELTA should be preferred to
-U+2206 INCREMENT as an encoding for "/Delta". You can also supply regular
+makes U+0394 GREEK CAPITAL LETTER DELTA preferred to
+U+2206 INCREMENT as an encoding for "/Delta". You can also supply
glyph names:
.nf
% UNICODING Delta =: Deltagreek Delta ;
.fi
-Supply zero choices to remove a glyph from the input encoding. For
-instance:
+A mapping with no Unicode values removes that glyph from the input
+encoding. For instance, this erases any f-ligature characters from the
+encoding:
.nf
% UNICODING ff =: ; fi =: ; fl =: ; ffi =: ; ffl =: ;
.fi
-The f-ligatures will be added back to the encoding, preferably at their
-original locations, if some font feature requires them. Finally, map a
-glyph to \&'emptyslot' if you don't want
+The slots are available for
+.BR otftfm 's
+own use, for example for other characters required by the font. (If the
+f-ligatures themselves are required by the font, for instance by a \&'liga'
+feature, then they will be stored into their old slots when possible.) Map
+a glyph to \&'emptyslot' if you don't want
.B otftotfm
-to use the slot for a ligature character. For example, this will leave the
-\&'ff' slot unused if the font has no \&'ff' glyph:
+to use the slot. For example, this will leave the \&'ff' slot unused if
+the font has no \&'ff' glyph:
.nf
% UNICODING ff =: ff emptyslot ;
.fi
@@ -1180,17 +1186,17 @@ options, and their
and
.B \-\-*\-filter
variants, accept the following types of pattern.
-.BUP
+.Bp
Glyph names. Example: "Aacute". For PostScript-flavored fonts, use
.M otfinfo 1 's
.B \-g
option to see a font's glyph names, and "\fBcfftot1\fR \fIfont\fR.otf |
\fBt1testpage\fR" to generate a PostScript file showing each glyph.
-.BUP
+.Bp
Glyph name patterns using the shell-style glob-matching rules: "*" matches
any number of characters, "?" matches any single character, and "[...]"
matches any character in a set. Example: "*.end".
-.BUP
+.Bp
Unicode category properties in angle brackets. Examples: "<Letter>",
"<UppercaseLetter>", "<Lu>". The complete list of both short and long
names: Letter/L, UppercaseLetter/Lu, LowercaseLetter/Ll,
@@ -1204,7 +1210,7 @@ EnclosingMark/Me, NonspacingMark/Mn; Separator/Z, SpaceSeparator/Zs,
LineSeparator/Zl, ParagraphSeparator/Zp; Other/C, Surrogate/Cs, Format/Cf,
Control/Cc, PrivateUse/Co, Unassigned/Cn. Category values current as of
Unicode 4.0.
-.BUP
+.Bp
Unicode ranges. Example: "U+007f-U+008C".
.PP
The "!" prefix negates a pattern, and you can separate multiple patterns by
@@ -1308,7 +1314,9 @@ translating regular "s" to long "s". Supported.
.TP 5
.IR kern ", Kerning"
Adjusts the space between characters (pair kerning). Generally supported,
-and you should probably turn it on.
+and you should probably turn it on. As a special case, "\fB\-f\fRkern" can
+also read kerning information from the "kern" table in conventional
+TrueType fonts.
.TP 5
.IR liga ", Standard Ligatures"
Activates common ligatures, such as "f_f", "f_i", "f_f_j", and (in some
@@ -1484,6 +1492,17 @@ features, or by using an encoding with more empty slots, such as the 7t.enc
encoding distributed with
.BR otftotfm .
'
+.TP 5
+The \&'\fB\-a\fR' option did not install my font correctly.
+'
+Try again with the \&'\fB\-\-verbose\fR' option, which causes
+.BR otftotfm
+to explain its behavior. Note that by default,
+.BR otftotfm
+will not re-install files already present in your system's TeX search paths
+(in the current directory, for instance). Use \&'\fB\-\-force\fR' to
+override this behavior.
+'
.SH "FREQUENTLY ASKED QUESTIONS"
.TP 5
How can I get a small-caps "SS" in place of the German sharp-S?
@@ -1530,7 +1549,6 @@ How can I get lining figures (that is, normal line-height digits) with small cap
Many fonts use old-style figures by default with small caps. Since the
default is not specified, it's wise to explicitly supply \&'\fB\-f\fRlnum' or
\&'\fB-f\fRonum'.
-
'
.SH "BUGS"
.\" .LP
@@ -1590,7 +1608,7 @@ used to translate glyph names to Unicode code points.
http://partners.adobe.com/public/developer/opentype/index_glyph.html
'
.SH AUTHOR
-Eddie Kohler (kohler@cs.ucla.edu)
+Eddie Kohler (ekohler@gmail.com)
.PP
Thanks to Karl Berry, Marco Kuhlmann, Adam Lindsay, Bruce D'Arcus, Thomas
Esser, Claire Connelly, Nelson H.F. Beebe, and Ryuji Suzuki for