FONTOOLS
========

This package provides tools to simplify the use of OpenType fonts with pdfTeX.

By far the most important program in this bundle is `autoinst`:

autoinst
: A wrapper script around Eddie Kohler's [LCDF TypeTools](https://lcdf.org/type).
`autoinst` aims to automate the installation of OpenType fonts in LaTeX
by calling the LCDF TypeTools (with the correct options) for all fonts
you wish to install, and generating the necessary .fd and .sty files.

In addition, this bundle contains a few other, less important utilities:

afm2afm
: Re-encode .afm files.

ot2kpx
: Extract kerning pairs from OpenType fonts.

splitttc
: Split an OpenType Collection file (.ttc or .otc) into individual fonts.


Requirements
------------

### Perl

The Fontools are written in Perl; any remotely recent version should work.
Perl is usually installed on Linux and Unix systems;
for Windows, try
[Strawberry Perl](https://strawberryperl.com)
or [ActivePerl](https://www.activestate.com/platform/supported-languages/perl/).


### LCDF TypeTools and T1Utils

Of course, `autoinst` needs the LCDF TypeTools and T1Utils
(available from <https://lcdf.org/type>; also on
[CTAN](https://ctan.org/pkg/lcdf-typetools)
and as part of TeX distributions such as TeXLive and MiKTeX).
These tools should be installed in a directory on your PATH;
most TeX distributions will do this automatically.


### Kpathsea

Automatically installing the fonts into a suitable TEXMF tree
(as `autoinst` does by default) requires a TeX-installation that uses
the Kpathsea library; with TeX distributions that implement their
own directory searching (such as MiKTeX), `autoinst` will complain that
it cannot find the `kpsewhich` program and install all generated files
into subdirectories of the current directory.

If you use such a TeX distribution, either move these files to their
destinations by hand, or use the `-target` command line option
(please see the manual for more information).


Installation
------------

When installing manually, the encoding files in the `share/` directory
should be moved to a "standard" location where `otftotfm` can find them.
What this location is depends on your TeX installation;
in TeXLive, it should be `$TEXMFLOCAL/fonts/enc/dvips/fontools` or,
if you don't have write permissions in `$TEXMFLOCAL`,
`$TEXMFHOME/fonts/enc/dvips/fontools`.

The scripts in the `bin` directory should be placed in a directory
on your PATH (or else you have to call them with their full path name).

Of course, when using a package manager (such as `tlmgr`) to do
the installation, all files will automatically be put in the right
location.


LICENSE & COPYRIGHT
-------------------

This software is copyright (C) 2005-2026 Marc Penninga.
It is released under the terms of the GNU General Public Licence;
see the file LICENSE for the license conditions.


DISCLAIMER
----------

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details.
