
REQUIREMENTS

Civil in itself requires the following:

   * pygame >= 1.5.5
   * python-xml
   * python-pqueue (optional, works without it)

Pygame in turn requires a few other packages:

   * Python-2.2 or higher
   * SDL  
   * SDL_image
   * SDL_ttf
   * SDL_mixer

The actual versions will vary depending on the Pygame version and the used OS.


DEBIAN INSTALLATION

If you run a Debian system (unstable or testing) you can download Debian 
packages from the Civil homepage at http://civil.sf.net/ 
You will need the following packages for basic play:

    civil_X.Y-1_i386.deb
    civil-graphics_X.Y-1_i386.deb
    civil-sounds_X.Y-1_i386.deb
    civil-scenariopack-default_X.Y-1_i386.deb
    civil-editor_X.Y-1_i386.deb

where X and Y are replace by the currently most recent version. At a later
time there will be more scenariopack:s to download. Install the packages using

    % dpkg --install <package>


REDHAT INSTALLATION

The RedHat RPM:s are created on a Redhat [TODO: version?]. You need the same
packages as for Debian, but of course as RPM version. Install normally.


GENERIC LINUX INSTALLATION 

If you installed from a Debian or RPM package, or if you're running
Windows you're done now. Civil is installed and ready to run. If you
have just unpacked and untarred the source distribution there is a few
simple steps to do if you want to install Civil globally so that all users 
can access it. If you just want to test Civil with one user see the section
DEVELOPMENT INSTALLATION below. The following instructions are valid for 
Linux/Unix. 

First you need to configure Civil. The only thing you need to know is
where you want to install. Then execute the following in the toplevel
directory of the source package:

    % ./configure --prefix=<path> 

Replace <path> with the full installation path. Civil is now
configured and can be installed. Do the following in the same
directory:

    % make install

Note that this requires root privileges. When this completes Civil is
installed and ready to be run.

To use another Python version than the default (currently 2.2) pass the 
wanted version to configure:

    % ./configure --with-python=<path-to-another-python> 


WINDOWS INSTALLATION

If you run Windows we recommend that you use the prebuilt package available
from the homepage. This installs nicely and requires no configuration. Just
make sure you have installed the required software packages.


OS X INSTALLATION

If you have checked out Civil from cvs, the easiest way to proceed with an 
install is to follow the Linux installation directions. This will install
Civil in a location of your choosing, and you can run Civil from the 
terminal as previously described.

To perform a "unix" style Civil install, cd to the Civil directory and
type the following:

    % autoconf
    % ./configure -prefix=/Users/<yourusername>/Games/Civil/
    % make install

The installation procedure may take a couple of minutes.

Please note; we will endeavour to produce a native .pkg installer for Civil
at a later date, barring changes to the Pygame distribution. This should also
remove the need for running Civil from the terminal. 


DEVELOPMENT INSTALLATION

If you want to use the CVS version or the source version you should not need
to do anything extra. The whole thing should work even without doing a full
'make install'. This works for Linux/Unix, OSX and Windows. You should however
run all programs from the 'src' directory. Such as:

    % cd src
    % ./civil.py

and not use the toplevel script, as they are used when doing a full install.

For Windows (and maybe OSX) you will also need to define an environment 
variable HOME to contain the name of a directory without the trailing slash. 
So something like this could be ok:

    c:\My Documents\Civil

The variable may already be defined, especielly if you've installed some other
software the comes from a Unix environment. In Civil this directory is used to
store saved games, custom scenarios and possibly other data. For binary
installs this will be taken care of automatically, and Unix systems always
have this variable predefined.

$Id: INSTALL,v 1.21 2003/06/03 09:34:05 chakie Exp $
