= build-tool

* http://michael-jansen.biz/build-tool

== DESCRIPTION:

This project is inspired by kdesvn-build[http://kdesvn-build.kde.org/].

It help in building and maintaining a development environment. It downloads
and configures sources and updates them later.

== FEATURES/PROBLEMS:

The tool uses recipes to build software from scratch. It does
- Check out the sources from the repository (git, git-svn, svn).
- Update the sources.
- Set the build environment.
- Configure (qt, cmake, custom)
- Build
- Install

It's main purpose is supporting me in developing kde while having a complete
kde workspace from trunk. I would like to have reliable and reproducable
builds so i'm sure the code is the problem and not my environment if something
fails to build.

Additional features are:
- Open a shell with the environment used to build the sources.
- Provide sample xessions and kde.desktop files to use the result.

Currently the following recipes are provided:
- Qt 4.6 (either from the kde-qt or qtsoftware repositories.
- KDE 4.3
- KDE Trunk

== SYNOPSIS:

# Install a recipe
> build-tool recipe install kde
...
# Adapt the configuration
> vim ~/.build-tool/kde.yaml

# Build kdesupport/ modules and the base kde workspace
kde-build build kdesupport/ KDE/

== Documentation

http://michael-jansen.biz/build-tool

== REQUIREMENTS:

* logging >= 1.2.2
* sequel >= 3.8.0
* sqlite3-ruby >= 1.2
* ansi >= 1.2

== INSTALL:

gem install build-tool

== LICENSE:

(The GPL LICENSE)

Copyright (c) 2009-2010 Michael Jansen