migrate forgotten text files from xo-strawberry

1 files changed, 60 insertions, 0 deletions

diff --git a/BUILDING b/BUILDING
new file mode 100644
index 0000000..a160283
--- /dev/null
+++ b/BUILDING
@@ -0,0 +1,60 @@
+Quickstart
+-------------
+git clone git://git.sugarlabs.org/soas/devxo.git xo-soas
+cd xo-soas
+git checkout -b xo-strawberry origin/xo-strawberry
+mkdir images cache
+echo "soasxo00" > images/lastbuild
+sudo ./build
+
+
+Introduction
+-------------
+
+This set of scripts is for people that want to build their own
+Sugar/Fedora image customised for the the OLPC XO-1.
+
+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
+
+
+Invocaton
+-------------
+
+Scripts are written assuming that "build" is being run by a cron job
+that does the following (note the cd into 'images' and its effect on
+relative paths):
+
+#!/bin/bash
+cd <git_checkout>
+./build
+
+
+
+
+Colophon
+-------------
+
+* a CD player is not a standard XO-1 accessory