guitone - a Qt-Frontend for monotone
====================================

guitone is a very basic frontend to monotone. It currently only allows
to browse through the workspace contents just like a normal file 
browser, but by displaying additional file status information.

You need Qt >= 4.2 to build and monotone >= 0.32 (or a monotone with
an interface version of 4.0 or greater) to run guitone. Earlier
versions do not have all the infrastructure for certain functionalities
available, but might still work in some areas.

To build under Linux / MacOS X just do

 $ cd /path/to/guitone
 $ ./build.sh

On MacOS X you can build guitone also with Xcode. For this to work you should
have a recent version of XCode installed (>= 2.3 because of gcc) which is
usually found somewhere on the installation DVD. Then you can create a XCode
project file with

 $ qmake -spec macx-xcode

and open this with XCode. If you need to tweak settings (i.e. architecture)
in the Qt project file (guitone.pro), remember to redo this step.

The created binary is monolithic can be found in guitone/bin. 

If you like to build on Windows, all you need is a working version of 
Qt 4.2.x. Please check the docs at trolltech.com for assistance how to
build Qt on Windows. 
After that get the sources of guitone, unpack them into some directory
and run qmake in it. Then start your favourite make tool and you're done.


The most recent version can always be obtained from the monotone 
repository on venge.net/monotone. guitone is located in the branch 
net.venge.monotone.guitone.


Platform Notes
==============

* If you like to compile guitone on OSX, make sure you've
  updated your gcc to 4.0.1 or newer which comes with XCode
  2.2 or later. Otherwise you'll get a "Bus error" on runtime
  due to a bug in gcc 4.0.0

* If you encounter icon problems on Linux and use an early
  version of Qt such as 4.1.0 consider updating to a later
  version. Apparently in 4.1.4 the problem is gone.

Authors
=======

Thomas "TommyD" Keller <me AT thomaskeller DOT biz>
Ingo "Slinky" Maindorfer <ingo AT liquidcooling DOT de>

Contributions are very welcome, we're usually hanging around in the monotone
IRC at irc://irc.oftc.net/#monotone so don't hesitate to contact us!