INSTALL

   1 NUTRITIONAL FACTS
   2 -----------------
   3
   4 ACTIVE INGREDIENTS
   5     # apt-get install git-core python python-qt4
   6
   7 Python 2.4 or newer
   8     ~ http://python.org/
   9
  10 PyQt 4.1 or newer
  11     ~ http://www.riverbankcomputing.co.uk/software/pyqt/download
  12
  13
  14 ADDITIVES
  15     # apt-get install python-pyinotify
  16
  17 pyinotify >= 0.7.1 enables inotify support on Linux
  18     ~ http://pyinotify.sourceforge.net/
  19
  20
  21 BREWING INSTRUCTIONS
  22     # apt-get install pyqt4-dev-tools
  23
  24 Normally you can just do "make install" to install git-cola
  25 in your $HOME directory ($HOME/bin, $HOME/lib, etc).
  26 If you want to do a global install you can do
  27
  28     # make prefix=/usr install
  29
  30 The "install" target will by default include copies of
  31 simplejson and jsonpickle.  If your system already has these
  32 modules installed then you can specify standalone=true when running "make":
  33
  34     $ make prefix=/usr standalone=true install
  35
  36
  37 You don't need to install cola to run it.
  38 git-cola is designed to run directly out of its source tree.
  39
  40     $ make
  41     $ bin/git-cola
  42
  43
  44 MAC OS X INSTALLTION INSTRUCTIONS
  45
  46 Whether you install cola yourself with "make install" or
  47 use the "git-cola.app" bundle, you will need to install
  48 Qt and PyQt separately.
  49
  50 The easiest way to do this is to use brew.
  51
  52     ~ http://mxcl.github.com/homebrew/
  53     $ brew install git-cola
  54
  55 Once brew has installed git-cola (and its dependencies) you use
  56 git-cola.app or install from source using "make install".
  57 Installing these packages also gives you a PyQt development
  58 environment which can be used for building your own applications
  59 or hacking on cola itself.
  60
  61
  62 WINDOWS INSTALLATION
  63
  64 Download the latest stable Git, Python 2.6, and Py26-PyQt4 installers
  65     http://code.google.com/p/msysgit/
  66     http://python.org/download/
  67     http://www.riverbankcomputing.co.uk/software/pyqt/download
  68
  69 Download the latest git-cola-[version].exe Windows installer
  70     https://github.com/git-cola/git-cola/downloads
  71
  72 Once it's installed you can run it from the Start menu or
  73 from a Git Bash by typing 'cola'.
  74
  75 If you're developing cola on Windows you can run cola out of its source
  76 tree by using the 'win32/cola' shell script.
  77
  78     $ /c/Python26/python setup.py build
  79     $ win32/cola
  80
  81 Note: win32/cola assumes you've installed Python in /c/Python26 or /c/Python25.
  82 Adjust accordingly.
  83
  84 You can also add python to your path and run bin/git-cola directly.