pu6e Ultima 6 Editor install instructions
-----------------------------------------

Prerequisites (these are what I used):
	Python 2.2 (python.org)
	wxPython 2.4.0.3 (wxpython.org)
	PyOpenGL 2.0.0.44 (pyopengl.sf.net)
	NumPy 22.0 (sf.net/projects/numpy)
	SWIG 1.3.17 (www.swig.org)

Linux
-----

1. make

If the prerequisites are installed, you should just be able to type "make" in
the top-level directory, and have everything built for you.  Then edit the
configuration file (pu6e.conf) and simply run the program (pu6e.py) from there.
There's no global installer; pu6e is self-contained and should probably hang
out somewhere under your home directory.

Windows
-------

First, install the prerequisites.  Then, you may need to set up a development
environment, because pu6e comes with Python extensions in C.  I don't have 
Visual C++, so I used mingw32.

Following the instructions at http://sebsauvage.net/python/mingw.html:

1. Download and install MinGW-2.0.0-3.exe from mingw.org.  The webpage says to
   use 1.1, but 2.0 works fine.
2. Download pexport from sebsauvage.  Extract .exe into mingw\bin.  
   Use pexport to extract c:\python22\python22.dll to c:\python22\libs\libpython22.a.
3. Edit distutils' build_ext.py, if necessary.

MinGW32 version 2 contains the OpenGL headers, but they're also available at
http://www.libsdl.org/extras/win32/common/opengl-devel.tar.gz should you need them.

Now you're ready to build pu6e:

4. Set ARCH environment variable to mingw32 ("set ARCH=mingw32")
5. mingw32-make

Run mingw32-make in the top-level directory.  Everything should be built for
you; after tweaking the config file (pu6e.conf), you can run the program
(pu6e.py) from that directory.

** Optional:

6. Download py2exe-0.3.3.win32-py2.2.exe from http://starship.python.net/crew/theller/py2exe/.
7. mingw32-make py2exe

This will create a directory called dist\pu6e with a binary distribution of pu6e,
which can run on machines without Python or the other prerequisites.  Then,

8. Copy the directory C:\Python22\Lib\site-packages\OpenGL to dist\pu6e.

You have to manually copy over the OpenGL extension because OpenGL doesn't play
well with py2exe.  Since the OpenGL package is rather large (5.5M), you can
remove unnecessary extensions.  What needs to be kept is: __init__.py,
glut32.dll and GLUT.pyd (the gl version imports GLUT), GL (delete everything
under here except __init__.py*), GLU (delete everything again except
__init__.py*).  This reduces the footprint to 750k.  Don't worry, you only
have to perform this step once.

Et voila!
