#  $Id: INSTALL 83 2004-07-11 13:12:44Z henning $

Installation Instructions:
--------------------------

Prerequisites:
You need at least Python 2.3 with Tk 8.3 and Tkinter. You will also need the
Pmw Megawidget package (Pmw 1.2) and the Python Imaging Library (PIL).  Tk and
Tkinter are shipped with Python by default, so for Windows users: Just download
the current Python Distribution from http://www.python.org .
PyCoCuMa was tested on the following platforms:
- GNU/Linux Debian (Sarge), Python 2.3
- Windows 2000 with Python 2.3.3 and Pmw 1.2

INSTALLATION ON UNIX/LINUX:

1.) Unpack the tarball:
~/tmp$ tar -xzvf PyCoCuMa-<VER>.tar.gz 

2.) Enter the newly created directory:
~/tmp$ cd PyCoCuMa-<VER>

3.) Simply run the setup script:
~/tmp/PyCoCuMa-<VER>$ python setup.py install

Where <VER> is the version number of your downloaded package, e.g. 0.3.1.  This
will install the PyCoCuMa libraries into your local Python installation
(usually something like /usr/lib/python2.3/site-packages/) and copies the two
executable scripts 'pycocuma' and 'pycocuma-server' to your /usr/bin directory
(or /usr/local/bin, see below). 

Try 'setup.py --help install' for a list of available install options. If you
prefer installing to /usr/local rather than /usr, try
'setup.py install --prefix=/usr/local' for example.
 
To start PyCoCuMa run 'pycocuma'.

INSTALLATION ON WINDOWS:

1.) Unpack the tarball to any directory you like (e.g. c:\Program Files\)

2.) Double-clicking 'pycocuma.pyw' should do.
