# # # patch "README" # from [eb7e0125823210303e2588a208985c2b671da2da] # to [4830639f1ddbe6040d9f86d1ec6b7bc53ced2ca0] # ============================================================ --- README eb7e0125823210303e2588a208985c2b671da2da +++ README 4830639f1ddbe6040d9f86d1ec6b7bc53ced2ca0 @@ -9,17 +9,17 @@ You need Qt >= 4.2 to build and monotone >= 0.34 (or a monotone with an interface version of 4.1 or greater) to run guitone. Earlier versions do not have all the infrastructure for certain functionalities -available, but might still work in some areas. (You have to lower the +available, but might still work in some areas. (You have to lower the requirements in Monotone.cpp before to make it actually work with older versions.) -To build under Linux / Mac OS X just do +To build under Linux / Mac OS X, just do $ cd /path/to/guitone $ ./build.sh On Mac OS X you need the Sparkle framework (http://sparkle.andymatuschak.org/) -installed to build guitone. Make sure it does reside outside +installed to build guitone. Make sure it does reside outside /System/Library/Frameworks if you plan to build with the univsersal SDK (the default). You can also build guitone with Xcode on Mac OS X. For this to work you should @@ -32,24 +32,25 @@ 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 can be found in bin/. +The created binary can be found in bin/. -If you like to build on Windows, all you need is a working version of +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. +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 guitone +repository at thomaskeller.biz. guitone is located in the branch +net.venge.monotone.guitone: -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. + $ mtn pull -d mydb.mtn thomaskeller.biz "net.venge.monotone.guitone*" Program Notes ============= -* If you encounter crashes, make sure that you've cleaned out any old +* If you encounter crashes, make sure that you've cleaned out any old settings directory, usually under .config/GUITONE or (in newer versions) under .config/Thomas\ Keller\. Newer versions of guitone save their settings according to their platform, that means that the config file @@ -79,8 +80,8 @@ The only known workaround here is to run guitone with administration privileges. -* On Qt 4.3.2 the generation of a valid Xcode project fails because - of problems with escaped characters in the project file. This has +* On Qt 4.3.3 and earlier the generation of a valid Xcode project fails + because of problems with escaped characters in the project file. This has been reported to Trolltech - in the meantime you should do $ qmake -spec macx-xcode guitone.pro @@ -88,6 +89,7 @@ $ sed -e 's/\\\\\"/\\\"/g' < project.pbxproj > project.pbxproj.new \ && mv project.pbxproj.new project.pbxproj + Known Bugs ========== @@ -100,19 +102,25 @@ meantime you just have to reload your workspace after a commit. * The Update Workspace dialog is currently a stub for the same reason and - won't do anything. + won't do anything. Other workspace commands like add, drop, rename and setup + are not supported yet in the automation interface as well. -* if your problem is not described here, take a look at the task list on +* If your problem is not described here, take a look at the task list on http://guitone.thomaskeller.biz/g/tracker -Authors -======= +Author +====== Thomas "TommyD" Keller + + +Contributors +============ + Ingo "Slinky" Maindorfer Jean-Louis "Ganwell" Fuchs -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! +Contributions are very welcome, I'm usually hanging around in the monotone +IRC at irc://irc.oftc.net/#monotone so don't hesitate to contact me!