Name                    Last modified       Size  Description

 Parent Directory        24-Jul-2008 15:34      -  
 GNUmakefile             04-Oct-2007 16:32     1k  
 TODO                    04-Oct-2007 16:32     4k  
 TODO.serialized         04-Oct-2007 16:32     1k  
 bin/                    04-Oct-2007 16:32      -  
 compilers.make          04-Oct-2007 16:32     3k  
 gub.make                04-Oct-2007 16:32     1k  
 gub/                    04-Oct-2007 16:32      -  
 librestrict/            04-Oct-2007 16:32      -  
 lilypond.make           04-Oct-2007 16:32    15k  
 mingit.make             04-Oct-2007 16:32     1k  
 nsis/                   04-Oct-2007 16:32      -  
 patches/                04-Oct-2007 16:32      -  
 sourcefiles/            04-Oct-2007 16:32      -  
 test-lily/              04-Oct-2007 16:32      -  

WHAT IS GUB
***********

Grand Unified Builder (GUB) is the mini packaging system that we
developed for building LilyPond binaries.  It cross-compiles several
packages and assembles them into a single package.  At the moment it
supports the following target platforms

darwin-ppc
   tar.bz2 file for Darwin 7 (MacOS 10.3)/PowerPC

darwin-x86
   tar.bz2 file for Darwin 8 (MacOS 10.4)/x86

mingw
   mingw executable for Windows32

linux-x86
   shar archive for Linux/x86

linux-64
   shar archive for Linux/x86_64

linux-ppc
   shar archive for Linux/PowerPC

freebsd-x86
   shar archive for FreeBSD 4/x86

freebsd-64
   shar archive for FreeBSD 6/x86_64

cygwin
   .tar.bz2 packages for Cygwin/Windows32 

arm
   shar archive for Linux/ARM (largely untested)

debian
   shar archive for Debian (largely untested)

LICENSE
*******

Gub is distributed under the terms of the GNU General Public License,
version 2 or later.   Gub comes with NO WARRANTY.


ACQUIRING
*********

The Git repository is at 

  http://git.sv.gnu.org/gitweb/?p=lilypond.git;a=log;h=gub

You can get it by doing 

  mkdir gub
  cd gub
  git init
  git pull git://git.sv.gnu.org/lilypond.git gub:


INSTALLING
**********

* You need 

  - about 9 GB of free space (for all platforms.)

  - A standard unix development environment with GCC and G++
  GNU Make

  - Python 2.4

* Prepare build environment

  make -f <package>.make bootstrap

  use mingit.make for building the MinGW version of Git.

* Build everything 

  make -f <package>.make all

this should leave installers and documentation in

  uploads/

USAGE
*****

Run these programs with --help argument for instructions

  bin/gpkg              - package manager 
  bin/gub               - build packages
  bin/installer-builder - build (platform dependent) installers
  bin/gub-tester        - build tester; integrates with
  			     Bazaar,CVS,Darcs,Git,SVN and gub
  bin/cygwin-packager   - roll cygwin package