
HFM - Hamster Font Manager v1.01
--------------------------------

HFM is a font manager for Unix systems. With it you can control the
avaliability of fonts in all of the supported applications from a central
place. Currently included are modules to support:

  - X-Window
  - Ghostscript
  - TeX

A PostScript module handles PS Fonts.  Other fonts remain untouched by this
program.


OFFICIAL HOME PAGE
------------------

The official homepage for Hamster is at:

  http://www.informatik.uni-stuttgart.de/ifi/se/service/hamster/


REQUIREMENTS
------------

HFM requires an Unix system with a 'tixwish' interpreter. This is a TCL/Tk
Interpreter compiled with Tix extensions. Most current Linux distributions
come with this interpreter.

To parse the binary distributed PostScript Fonts (pfb), the tool 'pfbtops'
is also needed. This is part of the 'groff' package, and is also included in
the standard installation of most distributions.


INSTALLATION
------------

HFM can be installed by simply running the 'doinstall' script. It will ask
where you want to place the files.  The meaning of the questions:

- "Enter the top level installation directory"
   This is place (a directory) where you want to store all HFM library code,
   bitmaps and also all fonts. So make sure you have plenty of free space on
   that directory.

- "Enter the directory where you want the program file"
   This is the directory where the 'hfm' starter program will be. Make sure 
   this is a directory you have in your PATH, so that you can start 'hfm' 
   from anywhere on your system.

Then you will see the script installing the proper files. After that, hfm
will be ready to use!


FIRST TIME START
----------------

When HFM is first started, it will first need to adjust itself to the
environment on your system.  This means that it will first try to find out
what applications that HFM supports you have installed.  It will show you
the config dialog where you can confirm, change and add the information it
could not get for itself.

Confirming this dialog will then start the font scanning process. All fonts
that you have installed in the various applications will be scanned and
those that are supported will then be moved to HFM's fonts directory. This
is made to assure that all fonts are managed from just one central place.
You will have to wait a bit, since this process can take a couple of
minutes.

On finishing that, you will be presented with HFM's main Window, showing all
avaliable fonts and also in which application each one is installed.

You can now start playing with your fonts! Have fun!


AUTHORS
-------

by Guenter Bartsch <bartscgr@trick.informatik.uni-stuttgart.de>
   Ernesto Baschny <ernst@studbox.uni-stuttgart.de>
   Markus Fischer <fischems@trick.informatik.uni-stuttgart.de>
   Alexander Miller <millerar@trick.informatik.uni-stuttgart.de>

Made as "Software Praktikum"
Institut fuer Informatik - Universitaet Stuttgart
Supervision by Stefan Krauss <Stefan.Krauss@informatik.uni-stuttgart.de>
