Comprehensive TeX Archive Network

Direc­tory fonts/utilities/fontinst

README for fontinst

* What is it?

Fontinst is a program that helps with installing fonts
for (La)TeX. Since it is written entirely in TeX macros,
it is completely portable.

More precisely, fontinst helps mainly with the number 
crunching and shoveling parts of font installation. This
means in practice that it creates a number of files which
give the TeX metrics (and related information) for a font
family that (La)TeX needs to do any typesetting in these 
fonts. Fontinst furthermore makes it easy to create fonts 
containing glyphs from more than one base font, taking 
advantage of e.g. "expert" font sets.

Fontinst cannot examine files to see if they contain any 
useful information or work with binary file formats; those 
tasks must normally be done manually or with the help of 
some other tool, such as the pltotf and vptovf programs. 
Nor can fontinst automatically search for files, but if 
they are named according to the fontname scheme (Berry) 
then fontinst sometimes succeeds very well in guessing 
what the interesting files are called.

* Documentation

The doc directory contains pure documentation; in 
particular the doc/manual directory should be of 
interest, as it contains the fontinst manual. For questions 
about the meaning of fontinst commands, see this manual.

The manual is however not a tutorial on how to use fontinst.
Some alternative sources of information that you may find 
useful are:

 * Philipp Lehman's "The Font Installation Guide"
   Available on CTAN, at info/Type1fonts/fontinstallationguide/

 * intro98.tex - parts of the 1998 fontinst v1.8 manual
   that were split off during the v1.9 revision. These are 
   much more tutorial in style, although not entirely modern.

 * The fontinst mailing list and its archives
   (See below for relevant addresses.)

 * The fontinst Literate Programming sources (see 
   source/fisource.dvi). If a command isn't documented 
   anywhere else, there is probably a discussion of it 
   in the sources. They're thoroughly indexed.

The examples directory contains some examples (with 
comments) of using fontinst to install a font family.

* Installation

To use fontinst, you only need to make sure the inputs
directory and its subdirectories are on TeX's input path.
Usually you do this by moving it to a suitable location.
In a TDS texmf tree, the inputs directory is usually
made the ${TEXMF}/tex/fontinst directory.

You will probably also want to move the file fontdoc.sty
in the latex directory to some location where TeX will 
find it. Many of the .mtx and .etx files in the inputs
hierarchy are simultaneously fontinst input files and
LaTeX documents; the fontdoc package is needed to typeset
them as the latter. In a TDS texmf tree, the normal place
for fontdoc.sty is in the tex/latex/misc directory.

Also recall that some TeX implementations maintain a 
database over files that have been installed. If you've 
placed fontinst in a suitable place but TeX complains it 
cannot find the file fontinst.sty then the problem may 
be that you need to update this database of files. That 
is however nothing that is particular for fontinst.

* Latin and other scripts

The fontinst distribution includes the necessary encoding
definition (.etx) files for the latin script as used in
European languages, but there is nothing in fontinst as 
a program that restricts it to these languages. In the T2
bundle (CTAN:macros/latex/contrib/t2) there are 
corresponding fontinst files for the cyrillic scripts 
(and in the future it might become part of the main
fontinst distribution). 

* The test directory

This is mainly of interest for advanced fontinst users.
It collects some files that were written to test the new 
features in various versions of fontinst. 

* Mailing list

Questions and bug reports should be sent to the fontinst 
mailing list


General information about the mailing list is at:


22 August 2009,
Lars Hellstr\"om

Down­load the con­tents of this pack­age in one zip archive (1.8M).

fontinst – Help with in­stalling fonts for and

macros for con­vert­ing Adobe Font Met­ric files to met­ric and vir­tual font for­mat. Fon­tinst helps mainly with the num­ber crunch­ing and shov­el­ling parts of font in­stal­la­tion. This means in prac­tice that it cre­ates a num­ber of files which give the met­rics (and re­lated in­for­ma­tion) for a font fam­ily that needs to do any type­set­ting in these fonts. Fon­tinst fur­ther­more makes it easy to cre­ate fonts con­tain­ing glyphs from more than one base font, tak­ing ad­van­tage of (e.g.) "ex­pert" font sets.

Fon­tinst can­not ex­am­ine files to see if they con­tain any use­ful in­for­ma­tion, nor au­to­mat­i­cally search for files or work with bi­nary file for­mats; those tasks must nor­mally be done man­u­ally or with the help of some other tool, such as the pltotf and vp­tovf pro­grams.

Li­cense The Project Public Li­cense
Copy­right1998–2001 The fontinst main­te­nance team
Main­tainerLars Hell­ström
Se­bas­tian Rahtz (in­ac­tive)
Ul­rik Vi­eth (in­ac­tive)
Alan Jef­frey (in­ac­tive)
Con­tained inTeX Live as fontinst
MiKTeX as fontinst
Topics con­vert a font to a form us­able with
Guest Book Sitemap Contact Contact Author