~ubuntu-branches/ubuntu/lucid/lcdf-typetools/lucid

« back to all changes in this revision

Viewing changes to otftotfm/otftotfm.1

  • Committer: Bazaar Package Importer
  • Author(s): C.M. Connelly
  • Date: 2009-04-06 16:49:02 UTC
  • mfrom: (1.2.8 upstream) (3.1.4 squeeze)
  • Revision ID: james.westby@ubuntu.com-20090406164902-9mu14sman9wo3112
Tags: 2.78-1
* New upstream release.
* t1lint: Report warnings when a font charstring command has too many
  arguments.
* Font library changes: correctly implement binary search in a couple
  places -- unexpected sizes could lead to overflow and bad behavior.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
'\"t
2
 
.ds V 2.69
 
2
.ds V 2.78
3
3
.de M
4
4
.BR "\\$1" "(\\$2)\\$3"
5
5
..
7
7
.if n .sp
8
8
.if t .sp 0.4
9
9
..
10
 
.de BUP
 
10
.de Bp
11
11
.IP \(bu 3n
12
12
..
13
13
.TH OTFTOTFM 1 "LCDF Typetools" "Version \*V"
109
109
file to
110
110
.I $HOME/texmf/web2c
111
111
and run
112
 
.M mktexlsr 1 .)
 
112
.M mktexlsr 1 .
 
113
On newer TeXLive installations, you may need to set the TEXMFVAR environment
 
114
variable.)
113
115
You can then run "\fBotftotfm\fR
114
116
.B \-a
115
117
.IR fontfile
498
500
.Sp
499
501
.TP 5
500
502
.BI \-\-altselector\-char= char
501
 
Set the font's alternate-selector character to
 
503
Set the font's alternate selector character to
502
504
.IR char ,
503
 
which should either be a single non-digit character, or a number between \-1
504
 
and 255.  Use an alternate selector if you want to choose between different
505
 
versions of a character from within a TeX file.  For instance, say that your
506
 
font provides three versions of "A".  If you want to access them all, pick a
507
 
character to be your alternate selector -- say "*".  Then give 
508
 
.B otftotfm
509
 
the \&'\-\-altselector\-char="*"'
510
 
option.  In TeX, "A" will produce the normal version, "A*" will produce the
511
 
first alternate, and "A**" will produce the second alternate.  Furthermore,
512
 
"s*t" will activate any discretionary "s_t" ligature in the font.
 
505
which should either be a single non-digit character, or a number between
 
506
\&\-1 and 255.  Alternate selectors let TeX authors explicitly choose
 
507
between versions of a character.  For instance, the
 
508
\&'\-\-altselector\-char="*"' option turns the "*" character into a special
 
509
switch that cycles between alternates.  For instance, the TeX input "A"
 
510
would produce the normal version of the "A" Unicode character, "A*" would
 
511
produce the first alternate, "A**" would produce the second alternate, and
 
512
so forth.  Furthermore, "s*t" will activate any discretionary "s_t"
 
513
ligature in the font.
513
514
.Sp
514
515
The
515
516
.B \-\-altselector\-char
516
517
mechanism uses the features specified by
517
518
.BR \-\-altselector\-feature
518
 
options.  You don't need to turn on those features if you use
519
 
.BR \-\-altselector .
 
519
options.
520
520
.Sp
521
521
The alternate-selector character may also be specified in the encoding; see
522
522
ENCODINGS, below.  See Sivan Toledo's article cited in the SEE ALSO section
819
819
.BI \-\-encoding\-directory= dir
820
820
.TP 5
821
821
.BI \-\-type1\-directory= dir
 
822
.TP 5
 
823
.BI \-\-truetype\-directory= dir
822
824
Set the directory used for various output types.  Each directory may be set
823
825
by an environment variable, and defaults to a TDS directory in automatic
824
826
mode, or to "." otherwise.  Environment variable names and default TDS
917
919
.nf
918
920
    % UNICODING pi1 =: uni03D6 ;
919
921
.fi
920
 
tells otftotfm that the character "/pi1" encodes as U+03D6 GREEK PI SYMBOL,
 
922
encodes the character "/pi1" as U+03D6 GREEK PI SYMBOL,
921
923
and
922
924
.nf
923
925
    % UNICODING Delta =: uni0394 uni2206 ;
924
926
.fi
925
 
tells it that U+0394 GREEK CAPITAL LETTER DELTA should be preferred to
926
 
U+2206 INCREMENT as an encoding for "/Delta".  You can also supply regular
 
927
makes U+0394 GREEK CAPITAL LETTER DELTA preferred to
 
928
U+2206 INCREMENT as an encoding for "/Delta".  You can also supply
927
929
glyph names:
928
930
.nf
929
931
    % UNICODING Delta =: Deltagreek Delta ;
930
932
.fi
931
 
Supply zero choices to remove a glyph from the input encoding.  For
932
 
instance:
 
933
A mapping with no Unicode values removes that glyph from the input
 
934
encoding.  For instance, this erases any f-ligature characters from the
 
935
encoding:
933
936
.nf
934
937
    % UNICODING ff =: ; fi =: ; fl =: ; ffi =: ; ffl =: ;
935
938
.fi
936
 
The f-ligatures will be added back to the encoding, preferably at their
937
 
original locations, if some font feature requires them.  Finally, map a
938
 
glyph to \&'emptyslot' if you don't want
 
939
The slots are available for
 
940
.BR otftfm 's
 
941
own use, for example for other characters required by the font.  (If the
 
942
f-ligatures themselves are required by the font, for instance by a \&'liga'
 
943
feature, then they will be stored into their old slots when possible.)  Map
 
944
a glyph to \&'emptyslot' if you don't want
939
945
.B otftotfm
940
 
to use the slot for a ligature character.  For example, this will leave the
941
 
\&'ff' slot unused if the font has no \&'ff' glyph:
 
946
to use the slot.  For example, this will leave the \&'ff' slot unused if
 
947
the font has no \&'ff' glyph:
942
948
.nf
943
949
    % UNICODING ff =: ff emptyslot ;
944
950
.fi
1180
1186
and
1181
1187
.B \-\-*\-filter
1182
1188
variants, accept the following types of pattern.
1183
 
.BUP
 
1189
.Bp
1184
1190
Glyph names.  Example: "Aacute".  For PostScript-flavored fonts, use
1185
1191
.M otfinfo 1 's
1186
1192
.B \-g
1187
1193
option to see a font's glyph names, and "\fBcfftot1\fR \fIfont\fR.otf |
1188
1194
\fBt1testpage\fR" to generate a PostScript file showing each glyph.
1189
 
.BUP
 
1195
.Bp
1190
1196
Glyph name patterns using the shell-style glob-matching rules: "*" matches
1191
1197
any number of characters, "?" matches any single character, and "[...]"
1192
1198
matches any character in a set.  Example: "*.end".
1193
 
.BUP
 
1199
.Bp
1194
1200
Unicode category properties in angle brackets.  Examples: "<Letter>",
1195
1201
"<UppercaseLetter>", "<Lu>".  The complete list of both short and long
1196
1202
names: Letter/L, UppercaseLetter/Lu, LowercaseLetter/Ll,
1204
1210
LineSeparator/Zl, ParagraphSeparator/Zp; Other/C, Surrogate/Cs, Format/Cf,
1205
1211
Control/Cc, PrivateUse/Co, Unassigned/Cn.  Category values current as of
1206
1212
Unicode 4.0.
1207
 
.BUP
 
1213
.Bp
1208
1214
Unicode ranges.  Example: "U+007f-U+008C".
1209
1215
.PP
1210
1216
The "!" prefix negates a pattern, and you can separate multiple patterns by
1484
1490
encoding distributed with 
1485
1491
.BR otftotfm .
1486
1492
'
 
1493
.TP 5
 
1494
The \&'\fB\-a\fR' option did not install my font correctly.
 
1495
'
 
1496
Try again with the \&'\fB\-\-verbose\fR' option, which causes
 
1497
.BR otftotfm
 
1498
to explain its behavior.  Note that by default,
 
1499
.BR otftotfm
 
1500
will not re-install files already present in your system's TeX search paths
 
1501
(in the current directory, for instance).  Use \&'\fB\-\-force\fR' to
 
1502
override this behavior.
 
1503
'
1487
1504
.SH "FREQUENTLY ASKED QUESTIONS"
1488
1505
.TP 5
1489
1506
How can I get a small-caps "SS" in place of the German sharp-S?
1530
1547
Many fonts use old-style figures by default with small caps. Since the
1531
1548
default is not specified, it's wise to explicitly supply \&'\fB\-f\fRlnum' or
1532
1549
\&'\fB-f\fRonum'.
1533
 
 
1534
1550
'
1535
1551
.SH "BUGS"
1536
1552
.\" .LP
1590
1606
http://partners.adobe.com/public/developer/opentype/index_glyph.html
1591
1607
'
1592
1608
.SH AUTHOR
1593
 
Eddie Kohler (kohler@cs.ucla.edu)
 
1609
Eddie Kohler (ekohler@gmail.com)
1594
1610
.PP
1595
1611
Thanks to Karl Berry, Marco Kuhlmann, Adam Lindsay, Bruce D'Arcus, Thomas
1596
1612
Esser, Claire Connelly, Nelson H.F. Beebe, and Ryuji Suzuki for