INSTALL

   1 INSTALLATION
   2 ------------
   3
   4 Debian and RPM users can download freshly built binaries here:
   5
   6     http://cola.tuxfamily.org/releases/
   7
   8 If you downloaded a tarball add /path/to/cola/bin to your $PATH.
   9
  10
  11 REQUIREMENTS
  12
  13 Python 2.4 or newer
  14     http://python.org/
  15     apt-get install python
  16
  17 PyQt 4.3 or newer
  18     http://www.riverbankcomputing.co.uk/software/pyqt/intro
  19     apt-get install pyqt4-dev-tools
  20
  21
  22 ADDITIONAL REQUIREMENTS (optional)
  23
  24 pyinotify (enables inotify support on Linux -- highly recommended)
  25     http://pyinotify.sourceforge.net/
  26     apt-get install python-pyinotify
  27
  28 simplejson (enables bookmarks)
  29     http://pypi.python.org/pypi/simplejson
  30     apt-get install python-simplejson
  31
  32
  33 BUILDING FROM SOURCE
  34
  35 Normally you can just do "make" followed by "make install", and that
  36 will install the git programs in your own ~/bin/ directory.  If you want
  37 to do a global install, you can do
  38
  39     $ make
  40     # make prefix=/usr install
  41
  42
  43 WINDOWS INSTALLATION
  44
  45 1) Install the native Python2.5 and PyQt4 installers (in that order):
  46
  47     http://python.org/download/
  48     http://www.riverbankcomputing.co.uk/pyqt/download.php
  49
  50 3) Install msysgit:
  51
  52     http://git.or.cz/gitwiki/WindowsInstall
  53
  54 4) Install the GnuWin32 'file' command:
  55
  56     http://gnuwin32.sourceforge.net/packages/file.htm
  57
  58     Add the installed directory (default: c:\GnuWin32\bin) to your path.
  59
  60 5) Install simplejson
  61
  62     http://pypi.python.org/pypi/simplejson
  63
  64 6) Download cola:
  65
  66     http://cola.tuxfamily.org/releases/
  67
  68 7) Install cola (from a Git Bash):
  69
  70     cd /c/Python25/Lib/site-packages
  71     tar xvfz /path/to/cola-win32-*.tar.gz
  72     mv cola-win32-* cola
  73
  74 8) Create an executable in your path for bash, cmd.exe, or both:
  75
  76     echo '/c/Python25/python.exe /c/Python25/Lib/site-packages/cola/bin/git-cola' >> /usr/bin/cola
  77     echo 'c:\\Python25\\python.exe c:\\Python25\\Lib\\site-packages\\bin\\git-cola' > /c/Windows/System32/cola.bat
  78
  79 This assumes the you have Python/PyQt4 installed in C:/Python25.
  80 If this is not the case simply edit the commands accordingly.
  81
  82 voila, cola on Windows.
  83
  84
  85 NOTE: Windows is not the developer's primary platform.
  86 Patches are greatly appreciated.