INSTALLATION
------------

Debian and RPM users can download freshly built binaries here:

    http://cola.tuxfamily.org/releases/

If you downloaded a tarball add /path/to/cola/bin to your $PATH.


REQUIREMENTS
    # apt-get install git-core python python-qt4

Python 2.4 or newer
    http://python.org/

PyQt 4.3 or newer
    http://www.riverbankcomputing.co.uk/software/pyqt/intro


ADDITIONAL REQUIREMENTS (optional)
    # apt-get install python-pyinotify simplejson

pyinotify (enables inotify support on Linux -- highly recommended)
    http://pyinotify.sourceforge.net/

simplejson (enables bookmarks)
    http://pypi.python.org/pypi/simplejson



BUILDING FROM SOURCE
    # apt-get install pyqt4-dev-tools

Normally you can just do "make install" to install git-cola
in your $HOME directory ($HOME/bin, $HOME/lib, etc).
If you want to do a global install you can do

    # make prefix=/usr install

You can also run git-cola without installing it.
It is designed to run directly out of the source tree
This is the best way to run git-cola when you're
modifying the code.

    $ make
    $ bin/git-cola

If you're developing cola on windows then you can do:

    $ python setup.py build
    $ win32/cola


WINDOWS INSTALLATION

Install Git, Python, and PyQt4
    http://git.or.cz/gitwiki/WindowsInstall
    http://python.org/download/
    http://www.riverbankcomputing.co.uk/pyqt/download.php

Install simplejson (optional)
    http://pypi.python.org/pypi/simplejson

Install and run cola from a Git bash:
    http://cola.tuxfamily.org/releases/win32/

    $ tar xvfz cola-*.tar.gz
    $ cola-*/bin/cola

    If you add the cola-*/bin directory to your $PATH then
    you can launch cola by simply typing 'cola'.


voila, cola on Windows.


NOTE: Windows is not the developer's primary platform.
Patches are greatly appreciated.
