diff options
Diffstat (limited to 'Master/texmf/doc/man/man1/otftotfm.1')
-rw-r--r-- | Master/texmf/doc/man/man1/otftotfm.1 | 84 |
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 |