Autofont Installation
=====================

Autofont consists of three Perl 5 scripts and some library files required
by those scripts. The first three steps are similar to those for any Perl
module:

     1. Run 'perl Makefile.PL [OPTIONS]' to generate a Makefile.

	You will probably want to specify a prefix where the Autofont
 	scripts should be installed:

	PREFIX=[PFX] -- Places binaries in "[PFX]/bin". Depending on your
	    Perl version, this may also place Perl modules in
	    "[PFX]/lib/perl5/site_perl/[PERL_VERSION]" and manual pages in
	    "[PFX]/share/man/man1".

	Alternatively, you can set the directories separately:

	INSTALLBIN=[DIR] -- Places binaries in "[DIR]".

	INSTALLSITELIB=[DIR] -- Places Perl modules in "[DIR]".

	INSTALLMAN1DIR=[DIR] -- Places manual pages in "[DIR]".

     2. Run 'make'.

     3. Run 'make install'.

The remaining steps are Autofont-specific.

     4. Create symbolic links so that 'mktextfm' and 'mktexpk' run
	'autofont-mktextfm' and 'autofont-mktexpk', respectively.

	These scripts are designed to be run automatically by TeX-related
	programs. The most reliable way to get them run is to place them in
	your path with the names that TeX expects, namely 'mktextfm' and
	'mktexpk'. However, you should not replace your existing 'mktex'
	programs with Autofont scripts. Leave the existing programs in your
	path, but *after* the Autofont versions. Autofont will then run the
	old scripts when required.

	For example, if your PATH looks like
	'$HOME/bin:/usr/bin:/usr/local/bin', and the existing 'mktex'
	scripts are in /usr/bin, then you should add symbolic links to
	$HOME/bin so that '$HOME/bin/mktextfm' runs autofont-mktextfm, and
	similarly for mktexpk.

     5. Create a writable TeX Directory Structure, if you don't have one
	already.

	This may be as simple as running 'mkdir ~/.texmf-var', since some
	Unix TeX installations set '~/.texmf-var' to a writable directory
	structure by default. Run "kpsewhich --expand-path='$TEXMFVAR'" to
	check. If your '~/.texmf-var' directory is not listed, set your
	TEXMFVAR environment variable to include it. Then make sure that
	"kpsewhich --expand-path='$TEXMF'" finds this path as well.

     6. Ensure that TeX can find your PostScript fonts. Usually, it is
	sufficient to set your T1FONTS environment variable to a path
	including all necessary font directories.

     7. [Multiple master fonts only] Download and install mmafm.

	Autofont requires the mmafm program to process multiple-master
	fonts. It is available as part of the lcdf-typetools package from
	http://www.lcdf.org/type/

     8. Create 'PSres.upr' files.

	Change into each directory on your system that contains PostScript
	fonts and font metric files and run the 'autofont-mkpsres' script.
	You should rerun this script every time you install a new
	PostScript font.

     9. [Optional] Add 'autofont.map' to dvips's PostScript map files.

	Autofont will automatically add entries to 'autofont.map' for fonts
	it creates. You should tell dvips about 'autofont.map' by adding a
	line like "p +autofont.map" to your '~/.dvipsrc' file, or your
	'config.ps' file.

Of course, you will also want to use Autofont font names in TeX. This
distribution includes LaTeX '.fd' files showing how you might use Autofont
in practice.
