GUB -- LilyPond

INSTALLING

Get GUB

    git clone git://github.com/gperciva/gub.git
or
    wget http://github.com/gperciva/gub/tarball/master

In addition to the requirements for GUB, you need

A TeX installation
texinfo
zip

Build everything

  make lilypond

this leaves installers and documentation in

  uploads/lilypond-VERSION-RELEASE.darwin-ppc.tar.bz2
  uploads/lilypond-VERSION-RELEASE.darwin-x86.tar.bz2
  uploads/lilypond-VERSION-RELEASE.freebsd-64.shar.sh
  uploads/lilypond-VERSION-RELEASE.freebsd-x86.shar.sh
  uploads/lilypond-VERSION-RELEASE.linux-64.shar.sh
  uploads/lilypond-VERSION-RELEASE.linux-ppc.shar.sh
  uploads/lilypond-VERSION-RELEASE.linux-x86.shar.sh
  uploads/lilypond-VERSION-RELEASE.mingw.exe

  uploads/lilypond-VERSION-RELEASE.documentation.tar.bz2
  uploads/lilypond-VERSION-RELEASE.webdoc.tar.bz2
  uploads/webdoc/VERSION

  uploads/lilypond-VERSION-RELEASE.test-output.tar.bz2
  uploads/wbtest/VERSION

More examples

  * Make a LilyPond installer for your platform

      bin/gub lilypond-installer

    OR (old style)

      bin/gub lilypond  # package with dependencies
      bin/gib --branch=lilypond=git.sv.gnu.org--lilypond.git-master lilypond #installer

  * Build all LilyPond installers

      make lilypond
 
    this leaves installers for GNU/Linux (x86, x86_64, powerpc),
    Windows, MacOSX (x86 and powerpc), FreeBSD (x86, x86_64) and
    documentation in uploads/

  * Optional: Prepare build environment

      make -f lilypond.make bootstrap

TESTING

The test-lily directory contains scripts for running various tests. Run without arguments for instructions

  cron-builder.py - entry point from continuous crontab testing
  test-binary.py  - test binary builds
  with-lock.py    - run a command with a lockfile
  rsync-lily-doc.py
                  - prepare documentation for upload
  dist-check.py   - check tarball for anomalies
  cygwin-packager.py
                  - repackage GUB packages into Cygwin tarballs.

CRON USAGE

I have the following in my crontab

Hourly build of LilyPond subpackage for all platforms except native (native is darwin-pcc?)

test-lily/cron-builder.py --package\
  --test-options "--to lilypond-cvs@gnu.org --quiet --from hanwen@lilypond.org
                  --smtp smtp.xs4all.nl --repository downloads/lilypond.git"\
  darwin-x86 freebsd-x86 freebsd-64 mingw linux-x86 linux-64

Hourly build of native installer, to run documentation and dist check.

test-lily/cron-builder.py\
  --package --installer --tarball --docs\
  --test-options "--to lilypond-cvs@gnu.org --dependent --quiet\
                  --from hanwen@lilypond.org --smtp smtp.xs4all.nl --repository downloads/lilypond.git"\
  --unversioned\
  darwin-ppc

Nightly build of all installers, to be ready for shipping binaries in the morning.

test-lily/cron-builder.py\
  --installer\
  --test-options "--to lilypond-cvs@gnu.org --quiet --from hanwen@lilypond.org\
                  --smtp smtp.xs4all.nl --repository downloads/lilypond.git"\
  darwin-x86 freebsd-x86 freebsd-64 mingw linux-x86 linux-64 darwin-ppc