Installing Mavric
-----------------

Mavric itself is easy to install, but it requires some additional
software and libraries.  These are:

* python 1.5.2 (http://www.python.org)

* PIL, the python imaging library (for PostScript tree printing)

* gnome-python (http://www.daa.com.au/~james/pygtk)

  * Note: If you don't want to install the full GNOME desktop
    environment, see http://www.baypiggies.org/10mintig.html for some
    instructions on installing the minimal set of packages needed for
    gnome-python (i.e., just gnome-libs and its dependencies.)

To install:

Mavric uses the distutils module that is distributed with python
1.5.2.  Assuming the distribution file Mavric-X.X.tar.gz:

bash$ tar xvfz Mavric-X.X.tar.gz && rm Mavric-X.X.tar.gz

bash$ cd Mavric-X.X

bash$ ./setup.py install

On my system (RH Linux 6.1) this byte-compiles and places the Mavric
module in /usr/lib/python1.5/site-packages.  If you don't have root
access and want to install Mavric in your home directory, you could
do, e.g.:

bash$ ./setup.py install --install-site-lib=$HOME/.python

where the directory $HOME/.python is in your PYTHONPATH environment
variable.

The executable script 'mavric', located in the bin/ subdirectory of
the source distribution, should be copied somewhere in your PATH,
e.g. /usr/local/bin, $HOME/bin, etc.

See the file README for hints on using mavric.
