
Readme for mkfontdb.py
======================

mkfontdb.py is a script that scans Type1 afm files and creates 'font
database' files for X11, ghostscript and Sketch.

mkfontdb.py is distributed as part of Sketch and individually. Version
1.0 was the first version available independently from Sketch and it
replaced mkfontdir.py from Sketch 0.5.3 and earlier. I've changed the
name to avoid confusion with X's mkfontdir program.

Both mkfontdb.py and Sketch are available from the Sketch homepage at
http://sketch.sourceforge.net/

If you find bugs or have some comments or suggestions, contact me at
bernhard@users.sourceforge.net.


Usage:
======

If the python interpreter is on your $PATH, you should be able to
execute the script directly. 'mkfontdb.py -h' prints a help message.

For a description of the heuristics used to extract the information
needed to build fonts.scale files from AFM-file, see the comments in
mkfontdb.py.


History:
========

Version 1.3:
------------

 - Added support for ghostscript Fontmap files, contributed by Jeffrey
   Boser.

 - The code to handle multiple outputfiles is much cleaner now.


Version 1.2:
------------

 - it reconizes some more foundries

 - a new commandline option '-f' to specify the foundry used when it
   can't be determined from the afm-file. The default is 'adobe'.

 - Bug fixes to accept afm-files with empty lines or lines with a
   keyword but no associated value.


Version 1.1:
------------

 - X fonts.scale files now contain the number of fonts in the first line

 - Bug fixes


Version 1.0:
------------

This is a cleaner implementation of the mkfontdir.py script distributed
with Sketch 0.5.3 and earlier. It uses the same heuristics as before, so
it should produce the same output as before.

The main difference from the user's point of view is that the script now
produces fonts.scale files by default, not sfd-files. The commandline
options are also different.



TODO:
-----

 - fonts.sfd might be a better name than std.sfd

 - command line options to specify the output filenames even if several
   files ar generated simultaneously
