summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/autoinst.1
blob: 16635636e35578184a52d804fd097ea29d73c9a8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
.\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.05)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "AUTOINST 1"
.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
.nh
.SH "NAME"
autoinst \- wrapper script around the \fI\s-1LCDF\s0 TypeTools\fR, 
for installing OpenType fonts in LaTeX.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
autoinst [options] \fIfontfile\fR [\fIfontfile\fR ...]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Eddie Kohler's \fITypeTools\fR, especially \fIotftotfm\fR, are great tools for 
installing OpenType fonts for use with LaTeX, but their use (even in 
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.
.PP
All the user then needs
to do is move these files to a suitable location 
(\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:
.RS 2
.IP "\fB\-\fR" 2
.IX Item "-"
Four text families (with lining and oldstyle figures, in tabular and 
proportional variants), each with the following shapes:
.RS 2
.RS 2
.IP "\fIn\fR" 4
.IX Item "n"
Roman text
.IP "\fIsc\fR" 4
.IX Item "sc"
Small caps
.IP "\fInw\fR" 4
.IX Item "nw"
`Upright swash'; usually normal text with some extra `oldstyle' ligatures, 
such as ct, sp and st.
.IP "\fItl\fR" 4
.IX Item "tl"
Titling shape. Meant for all-caps text only (even though it sometimes contains 
lowercase glyphs as well), where letterspacing and the positioning of 
punctuation characters have been adjusted to suit all-caps text. 
This shape is generated only for the families with lining figures.
.IP "\fIit\fR" 4
.IX Item "it"
Italic or oblique text
.IP "\fIscit\fR" 4
.IX Item "scit"
Italic small caps
.IP "\fIsw\fR" 4
.IX Item "sw"
Swash
.IP "\fItlit\fR" 4
.IX Item "tlit"
Italic titling
.RE
.RS 2
.RE
.RE
.RS 2
.RE
.IP "\fB\-\fR" 2
.IX Item "-"
For each text family: a family of TS1\-encoded symbol fonts, 
in roman and italic shapes.
.IP "\fB\-\fR" 2
.IX Item "-"
Four families with superiors, inferiors, numerators and denominators,
in roman and italic shapes.
.IP "\fB\-\fR" 2
.IX Item "-"
An ornament family, in roman and italic shapes.
.RE
.RS 2
.RE
.PP
Of course, if the font doesn't contain oldstyle figures, small caps etc.,
the corresponding shapes or families are not created; 
furthermore, the creation of most families and shapes can be controlled by 
command-line options (see below).
.PP
The generated font families are named \fI<FontFamily>\-<Suffix>\fR, 
where \fI<Suffix>\fR is one of
.IP "\fI\s-1LF\s0\fR" 8
.IX Item "LF"
proportional (i.e., figures have varying widths) lining figures
.IP "\fI\s-1TLF\s0\fR" 8
.IX Item "TLF"
tabular (i.e., all figures have the same width) lining figures
.IP "\fIOsF\fR" 8
.IX Item "OsF"
proportional oldstyle figures
.IP "\fITOsF\fR" 8
.IX Item "TOsF"
tabular oldstyle figures
.IP "\fISup\fR" 8
.IX Item "Sup"
superior characters (many fonts only have an incomplete set
of superiors: figures, some punctuation and the letters 
\&\fIabdeilmnorst\fR; normal forms will be used for the other characters)
.IP "\fIInf\fR" 8
.IX Item "Inf"
inferior characters; usually only figures and punctuation, 
normal forms for the other characters
.IP "\fIOrn\fR" 8
.IX Item "Orn"
ornaments
.IP "\fINumr\fR" 8
.IX Item "Numr"
numerators
.IP "\fIDnom\fR" 8
.IX Item "Dnom"
denominators
.PP
The generated fonts are named \fI<FontFile>\-<suffix>\-<shape>\-<enc>\fR,
where \fI<FontFile>\fR is the name of the OpenType file, \fI<suffix>\fR 
is the same as above (but in lowercase), \fI<shape>\fR is either empty, 
`sc', `swash' or `titling', and \fI<enc>\fR is the encoding.
A typical name in this scheme is \fIMinionPro\-Regular\-osf\-sc\-ly1\fR.
.SS "On the choice of text encoding"
.IX Subsection "On the choice of text encoding"
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.
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"
\&\fBautoinst\fR generates a style file for using the font in LaTeX documents, 
named `<\fIFontFamily\fR>.sty'. This style file also takes care of loading the 
\&\fIfontenc\fR and \fItextcomp\fR packages, if necessary.
To use the font, simply put \f(CW\*(C`\eusepackage{MinionPro}\*(C'\fR 
(or whatever the font is called) in the preamble of your document.
.PP
This style file defines a number of options:
.IP "\fIlining, oldstyle, tabular, proportional\fR" 4
.IX Item "lining, oldstyle, tabular, proportional"
Choose which figures will be used for the text fonts. 
The defaults are `oldstyle' and `proportional' (if available).
.IP "\fIultrablack, ultrabold, heavy, extrablack, black, extrabold, demibold, semibold, bold\fR" 4
.IX Item "ultrablack, ultrabold, heavy, extrablack, black, extrabold, demibold, semibold, bold"
Choose the weight that LaTeX will use for the `bold' weight 
(i.e., the value of \f(CW\*(C`\ebfdefault\*(C'\fR).
.IP "\fIlight, medium, regular\fR" 4
.IX Item "light, medium, regular"
Choose the weight that LaTeX will use for the `regular' weight 
(i.e., the value of \f(CW\*(C`\emddefault\*(C'\fR).
.IP "\fIscaled=<scale>\fR" 4
.IX Item "scaled=<scale>"
Scale the font by a factor of \fI<scale>\fR. 
For example: to increase the size of the font by 5%, use the command
\&\f(CW\*(C`\eusepackage[scaled=1.05]{MyriadPro}\*(C'\fR.
.Sp
This option is only available when the \fIxkeyval\fR package is found
in your TeX installation.
.PP
The style file will also try to load the \fIfontaxes\fR package (part of 
the MinionPro for LaTeX project), which gives easy access to various font 
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 \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) 
and declarations (which don't take arguments, but affect all text up to 
the end of the current group) of its own:
.PP
.Vb 1
\&    DECLARATION     COMMAND         SHORT FORM OF COMMAND
\&    
\&    \etlshape        \etexttitling    \etexttl
\&    \esufigures      \etextsuperior   \etextsu 
\&    \einfigures      \etextinferior   \etextin
.Ve
.PP
In addition, the \f(CW\*(C`\eswshape\*(C'\fR and \f(CW\*(C`\etextsw\*(C'\fR commands are redefined to place
swash on the secondary shape axis (\fIfontaxes\fR places it on the primary 
shape axis); this allows the use of `upright swash'. 
Just saying \f(CW\*(C`\eswshape\*(C'\fR will still give normal (italic) swash, 
but \f(CW\*(C`\eswshape\eupshape\*(C'\fR results in upright swash.
.PP
Note that there is no separate command for accessing the italic titling shape;
but these commands behave properly when nested, so \f(CW\*(C`\etlshape\eitshape\*(C'\fR gives
italic titling.
There are also no commands for accessing the numerator and denominator
fonts; these can be selected using \fIfontaxes\fR' low-level commands, 
e.g., \f(CW\*(C`\efontfigurestyle{numerator}\eselectfont\*(C'\fR.
.PP
The style file also provides a command \f(CW\*(C`\eornament{\f(CI<number>\f(CW}\*(C'\fR, 
where \f(CW\*(C`\f(CI<number>\f(CW\*(C'\fR is a number from 0 to the total number of 
ornaments minus one. Ornaments are always typeset using the current family, 
series and shape. A list of all ornaments in a font can be created by
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.
.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
all fonts were installed using the same version of \fBautoinst\fR.
\&\fBautoinst\fR has seen some non-backward-compatible changes in the past,
and \fI.sty\fR and \fI.fd\fR files that were generated by different versions 
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.
\&\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 
name clashes for font families with many different widths and weights
(such as Helvetica Neue).
.PP
.Vb 1
\&    WEIGHT                              WIDTH                               
\&    
\&    Thin           t                    Ultra Condensed    uc               
\&    Ultra Light    ul                   Extra Condensed    ec               
\&    Extra Light    el                   Condensed          c                
\&    Light          l                    Semicondensed      sc               
\&    Book                 [1]            Regular                  [1]        
\&    Regular              [1]            Semiextended       sx               
\&    Medium         mb                   Extended           x                
\&    Demibold       db                                                       
\&    Semibold       sb                                                       
\&    Bold           b                            
\&    Extra Bold     eb                   SHAPES                              
\&    Black          a                                                        
\&    Extra Black    ea                   Roman              n                
\&    Heavy          h                    Italic             it               
\&    Ultra          ub                   Oblique            it    [2]                                    
\&    Ultra Bold     ub                   RomanI             n     [3]           
\&    Ultra Black    ua                   RomanII            it    [3]
.Ve
.IP "[1]" 4
.IX Item "[1]"
When \fIboth\fR weight and width are empty, the `series' attribute becomes `m'.
.IP "[2]" 4
.IX Item "[2]"
Mapping the `Oblique' shape to `it' instead of the canonical `sl' simplifies
\&\fBautoinst\fR. Since font families with both `Italic' and `Oblique' shapes 
probably do not exist (apart from Computer Modern), 
this shouldn't cause problems in real life.
.IP "[3]" 4
.IX Item "[3]"
To the best of my knowledge, the only font family that has two `Roman' shapes 
is Silentium; since this has no `Italic' shape, 
the `it' code is (ab)used for the `RomanII' shape.
.SS "A note for MikTeX users"
.IX Subsection "A note for MikTeX users"
Calling \fIotftotfm\fR with the \fB \-\-automatic\fR option (as \fBautoinst\fR does by
default) requires a TeX-installation that uses the \fIkpathsea\fR library; with 
TeX-installations that implement their own directory searching 
(such as MiKTeX) \fIotftotfm\fR might complain that it 
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; see the documentation for how this is done.
.PP
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"
.IX Header "COMMAND-LINE OPTIONS"
.IP "\fB \-\-encoding\fR=\fIencoding[,encoding]\fR" 4
.IX Item " --encoding=encoding[,encoding]"
Use the encoding \fIencoding\fR for the text fonts. The default is `\s-1LY1\s0'. 
A file named `<\fIencoding\fR>.enc' (in all \fIlowercase\fR) should be somewhere 
where \fIotftotfm\fR can find it. Suitable encoding files 
for \s-1LY1\s0, \s-1OT1\s0 and T1/TS1 come with \fIfontools\fR. (Note that these files are
called \fIfontools_xxx.enc\fR to avoid name clashes with other packages; 
the `fontools_' prefix doesn't need to be specified.)
.Sp
Multiple text encodings can be specified as well: \f(CW\*(C` \-\-encoding=OT1,T1,LY1\*(C'\fR. 
The encodings are passed to \fIfontenc\fR in the order specified, 
so the last one will be the default text encoding.
.IP "\fB \-\-sanserif\fR" 4
.IX Item " --sanserif"
Install the font as a sanserif font, accessed via \f(CW\*(C`\esffamily\*(C'\fR and \f(CW\*(C`\etextsf\*(C'\fR. 
Note that the generated style file redefines \f(CW\*(C`\efamilydefault\*(C'\fR, 
so including it will make this font the default text font.
.IP "\fB \-\-typewriter\fR" 4
.IX Item " --typewriter"
Install the font as a typewriter font, accessed via \f(CW\*(C`\ettfamily\*(C'\fR and 
\&\f(CW\*(C`\etexttt\*(C'\fR. 
Note that the generated style file redefines \f(CW\*(C`\efamilydefault\*(C'\fR, 
so including it will make this font the default text font.
.IP "\fB \-\-ts1\fR" 4
.IX Item " --ts1"
.PD 0
.IP "\fB \-\-nots1\fR" 4
.IX Item " --nots1"
.PD
Turn the creation of TS1\-encoded fonts on or off. The default is \fB \-\-ts1\fR 
if the text encodings (see \fI \-\-encoding\fR above) include T1, 
\&\fB \-\-nots1\fR otherwise.
.IP "\fB \-\-smallcaps\fR" 4
.IX Item " --smallcaps"
.PD 0
.IP "\fB \-\-nosmallcaps\fR" 4
.IX Item " --nosmallcaps"
.PD
Turn the creation of small caps fonts on or off. The default is 
\&\fB \-\-smallcaps\fR.
.IP "\fB \-\-swash\fR" 4
.IX Item " --swash"
.PD 0
.IP "\fB \-\-noswash\fR" 4
.IX Item " --noswash"
.PD
Turn the creation of swash fonts on or off. The default is \fB \-\-swash\fR.
.IP "\fB \-\-titling\fR" 4
.IX Item " --titling"
.PD 0
.IP "\fB \-\-notitling\fR" 4
.IX Item " --notitling"
.PD
Turn the creation of titling fonts on or off. The default is \fB \-\-notitling\fR.
.IP "\fB \-\-superiors\fR" 4
.IX Item " --superiors"
.PD 0
.IP "\fB \-\-nosuperiors\fR" 4
.IX Item " --nosuperiors"
.PD
Turn the creation of fonts with superior characters on or off. 
The default is \fB \-\-superiors\fR.
.IP "\fB \-\-inferiors\fR" 4
.IX Item " --inferiors"
.PD 0
.IP "\fB \-\-noinferiors\fR" 4
.IX Item " --noinferiors"
.PD
Turn the creation of fonts with inferior figures on or off. 
The default is \fB \-\-noinferiors\fR.
.IP "\fB \-\-fractions\fR" 4
.IX Item " --fractions"
.PD 0
.IP "\fB \-\-nofractions\fR" 4
.IX Item " --nofractions"
.PD
Turn the creation of fonts with numerators and denominators on or off. 
The default is \fB \-\-nofractions\fR.
.IP "\fB \-\-ornaments\fR" 4
.IX Item " --ornaments"
.PD 0
.IP "\fB \-\-noornaments\fR" 4
.IX Item " --noornaments"
.PD
Turn the creation of ornament fonts on or off. The default is \fB \-\-ornaments\fR.
.IP "\fB \-\-manual\fR" 4
.IX Item " --manual"
Manual mode. By default, \fBautoinst\fR immediately executes all \fIotftotfm\fR 
command lines it generates; with the \fB \-\-manual\fR option, these commands are 
instead written to a batch command file (named `<\fIfont\fR>.bat', to make things
easier for our friends on Windows). Also, the generated \fIotftotfm\fR command 
lines specify the \fI \-\-pl\fR option and leave out the \fI \-\-automatic\fR option; 
this causes human readable (and editable) \fIpl\fR and \fIvpl\fR files to be created 
instead of the default \fItfm\fR and \fIvf\fR files.
.IP "\fB \-\-verbose\fR" 4
.IX Item " --verbose"
Verbose mode; print detailed info about what \fBautoinst\fR thinks it's doing.
.IP "\fB \-\-extra\fR=\fItext\fR" 4
.IX Item " --extra=text"
Pass \fItext\fR as options to \fIotftotfm\fR. To prevent \fItext\fR from accidentily 
being interpreted as options to \fBautoinst\fR, it should be properly quoted.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Eddie Kohler's TypeTools (\fIhttp://www.lcdf.org/type\fR).
.PP
Perl is usually pre-installed on Linux and Unix systems;
on Windows, try ActivePerl (available from \fIhttp://www.activestate.com\fR)
or Strawberry Perl (\fIhttp://strawberryperl.com\fR).
.PP
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
John Owens' \fIotfinst\fR (available from \s-1CTAN\s0) is another wrapper 
around \fIotftotfm\fR, and may work when \fBautoinst\fR doesn't.
.PP
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>
.PP
When sending a bug report, please give as much relevant information as 
possible; this usually includes (but may not be limited to) the output from 
running \fBautoinst\fR with the \fB \-\-verbose\fR option. 
Please make sure that this output includes all error messages (if any);
this can be done using the command
.PP
\&\f(CW\*(C`autoinst \f(CI(... all options and files ...)\f(CW  >autoinst.log 2>&1\*(C'\fR
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2005, 2006, 2007, 2009, 2010 Marc Penninga.
.SH "LICENSE"
.IX Header "LICENSE"
This program is free software; you can redistribute it and/or modify
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.
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"
.IX Header "DISCLAIMER"
This program is distributed in the hope that it will be useful,
but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of
\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0. See the
\&\s-1GNU\s0 General Public License for more details.
.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,
even if the font doesn't have a \fIkern\fR feature; 
this will make \fIotftotfm\fR use the \fIkern\fR table if present.
For fonts without a \fIliga\fR feature, add \f(CW\*(C` \-\-ligkern\*(C'\fR
options for the common f\-ligatures to the \fIotftotfm\fR command line,
so that any ligatures present in the font will still be used.
Bug fix: the generated \fI.sty\fR files now work for font families
with names containing digits.
.IP "\fI2009\-04\-09\fR" 12
.IX Item "2009-04-09"
Prefixed the filenames of  the included encoding files with
\&\fIfontools_\fR, to prevent name clashes with other packages.
.IP "\fI2009\-04\-06\fR" 12
.IX Item "2009-04-06"
A small patch to the \f(CW\*(C`make_ornament_encoding\*(C'\fR subroutine;
it now also recognises the \fIbullet.xxx\fR ornament glyphs 
in Adobe's Kepler Pro.