New Build System: Quickstart
============================

This is (very) brief introduction to new build system based on
scratchbox2 path mapping application.

"sbs" is the script responsible for setting environment up,
compiling packages and creating binary images.  Note that this script
can be run only as normal user, not root.

Creating environment from scratch
=================================

To create environment one needs to meet following requirements:

  - recent Debian/Ubuntu system for i386/x86_64 architecture
  - scratchbox2 version 1:2.1-0slp2+s1 (provided by our team)
  - debootstrap, qemu-arm
  - access to Debian and Tizen's mirrors

By default packages are installed from local repositories, if needed
one could change following:

  - SBS_TOOLS_MIRROR - http/ftp mirror to Debian squeeze repository
    for i386/x86_64.  Change by e.g.:

    export SBS_TOOLS_MIRROR=http://ftp.uk.debian.org/debian

  - SBS_TARGET_MIRROR - http/ftp mirror to Tizen's repository of
    ARM packages.  You might need to change it to http://127.0.0.1/apt

  - SBS_CROSS_MIRROR - http/ftp mirror to Tizen's repository of
    cross-compilers and related tools.  You might need to change it to
    http://127.0.0.1/apt

To create environment please type (as user, not as root!):

  sbs --create

This will try to setup complete build environment at $HOME/sbs.
To change default directory please do:

  export SBS_ROOTDIR=/requested/path

To completely remove environment please type:

  sbs --kill


Building packages
=================

With pre-setup environment following operations should succeed.

  1.  To compile Debian package PKG given prepared sources please run:

          sbs --build PKG.dsc

      This will try to build package using (preliminary) automatic
      builder.  Missing dependencies will be satisfied and installed
      if possible.

      You can download appropriate sources for given PKG by running:

          apt-get source PKG


  2.  To enter build environment please run:

      	  sbs --execute

      This will login you into environment where you can build
      packages.  Typical commands like ./configure, make, gcc,
      etc. should all work as in normal environment (but produce
      ARM-architecture binaries).

      To satisfy missing build dependencies you need to install
      required packages.  Please run:

      	  sbs --execute-target apt-get install PKG1 PKG2

      to install missing packages for ARM.

      You *CAN'T* install packages in mode designed for building
      packages.  For full discussion please see provided usage
      documentation (sbs-usage.ppt).


Following doesn't require setup environment but working package
repositories:

  N.  To create binary filesystem/kernel image for Aquila board
      please type:

          sbs --makeimage TESTIMAGE --board aquila