Quickstart
-------------
# TODO: clarify prerequisites like Fedora livecd-creator tools
git clone git://git.sugarlabs.org/soas/mainline.git xo-soas
cd xo-soas
mkdir images cache
echo "soas00" > images/lastbuild
sudo ./build
# output goes to images/soas01.buildlog

Introduction
-------------

This set of scripts is for people that want to build their own
Sugar/Fedora image customised for removeable devices like USB sticks
and for the the OLPC XO-1's NAND.

The created images are intended to be run from _writable_ media,
including:

- SD card
- USB stick
- XO-1 onboard NAND flash

The created images are not intended to be used to create LiveCDs for
running on the XO-1*.


Objectives
-------------

This set of scripts:

1a) creates a jffs2 .img, .crc, and .plc file set suitable for OFW's
    copy-nand and NANDBlaster image-copying methods

1b) creates a file that can be copied bit-for-bit (e.g., dd) onto a 4GB
    removable drive from which Sugar/F11 can be booted

2)  creates a livecd .ISO suitable for use booting an XO-1 with
    Sugar/F11 via Fedora's livecd-creator tool


Prerequisites
-------------

Currently SoaS builds on Fedora 11 and higher.  Patches for other
systems very welcome.

On Fedora, ensure you have the LiveCD and Appliance tools installed:

yum -y install livecd-tools appliance-tools



Colophon
-------------

* In case you asked "why no read-only media?", recall that a CD player
  is not a standard XO-1 accessory