README

   1 ugit: A PyQt-based git gui
   2
   3 Copyright (C) 2007 David Aguilar
   4
   5 This program is free software: you can redistribute it and/or modify
   6 it under the terms of the GNU General Public License as published by
   7 the Free Software Foundation, either version 2 of the License, or
   8 (at your option) any later version.
   9
  10 This program is distributed in the hope that it will be useful,
  11 but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 GNU General Public License for more details.
  14
  15 You should have received a copy of the GNU General Public License
  16 along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17
  18
  19 REQUIREMENTS
  20
  21 Python 2.4 or newer
  22 PyQt 4.3 or newer
  23
  24
  25 INSTALLATION
  26
  27 If you downloaded a tarball, add /path/to/ugit/bin
  28 to your $PATH and type:
  29
  30         git ugit
  31
  32
  33 BUILDING FROM SOURCE
  34
  35 You will need the PyQt development tools (v4.3 or greater):
  36
  37 Synopsis:
  38         sudo apt-get install pyqt4-dev-tools
  39
  40         git clone git://repo.or.cz/ugit.git
  41         cd ugit
  42                 ./configure --prefix=/usr
  43                 make
  44                 sudo make install
  45
  46         cd my/git/repo
  47                 git ugit
  48
  49 WINDOWS SUPPORT
  50
  51 Windows support once was quite experimental with git.
  52 These days it's actually quite good and only getting better
  53 everyday.  As git's windows support improves, so does ugit's.
  54
  55 The following is the combination that "works for me" (TM)
  56 as of late 2007:
  57
  58 1) Install the native Python2.5 and PyQt4 installers (in that order):
  59
  60         http://python.org/download/
  61         http://www.riverbankcomputing.co.uk/pyqt/download.php
  62
  63 3) Install git (the author had the best luck with msysgit):
  64
  65         http://git.or.cz/gitwiki/WindowsInstall
  66
  67 4) Download and unpack ugit:
  68         http://ugit.sf.net/releases/
  69
  70 Grab the latest win32 tarball and run ugit-win32.sh from
  71 within an msysgit or cygwin shell.
  72
  73 The script assumes the you have Python/PyQt4 installed in C:/Python25.
  74 If this is not the case, edit the script accordingly.
  75
  76 voila, ugit on Windows.