PyCube

This file currently only describes the build process under Linux. If you
wish to build pyszg for other operating systems, contact me at
brinkman@math.uiuc.edu.

After you've checked illiMath04 out of the CVS repository, you'll see
a Makefile in the top directory. If you simply type make, the documentation
of our various projects will be built from LaTeX sources.

If you wish to compile and install the Python bindings and such, a few
additional steps are required.

Requirements:

    - Software
        - A recent installation of szg (from the CVS repository; the
          version posted on the ISL website doesn't cut it; if you want
          szg to work through firewalls, then you'll need my patched
          version that's installed in the grafixLab)
        - A recent version of Python (I've got Python 2.3 on my machine;
          Python 2.2 seems to be okay. I don't make any promises regarding
          anything that's older)
        - A recent version of SWIG (I'm using 1.3.21; I don't know which
          other versions might still work)
        - For the Master/Slave framework: PyOpenGL
    - Environment
        - SZGHOME must point to your szg directory
        - PYSZGLIB should point to some directory that you can write to,
          such as ~/lib
        - PYTHONPATH must include $PYSZGLIB; I accomplish this by saying
            export PYTHONPATH=$PYTHONPATH:$PYSZGLIB
        - If you have root on your machine, you can leave PYSZGLIB blank;
          in this case, the Makefile will install the Python modules in
          /usr/lib/python2.x/site-packages. There's no need to add this
          directory to PYTHONPATH since it's on there by default.


Installation:

In the top level directory, say

    make bin
    make test
    make install

The second step, make test, is optional as well as sort of pointless
at the moment as the testing suite, test.py, is still _very_ incomplete.

That's it! If nothing went wrong, you can now run all our programs.