[Introduction]

The Familiar project provides a simple configuration tool to ease the setup of its OpenEmbedded derived build system for developers and skilled end users. This document describes how to use it.

[Prerequisites]

Before you can begin with the setup please make sure to

install Git

get a copy of the Familiar build tree:

	git clone http://familiar.handhelds.org/git/familiar-build.git

install Zenity (usually included in a standard Gnome installation)

[Setup Procedure]

WARNING: Don't run any of the commands below as root! Some of the scripts that run during a build may contain bugs and write to the host filesystem which is likely to break your system!

You should have cloned the git tree by now (see above). Change into the toplevel directory of the tree and run the setup utility:

    cd /path/to/familiar-build
    sh setup/build-env.sh

The script will open a few dialogs as shown below. Some present default settings that you can change if you like to. Note that although the examples below show /var/tmp/familiar-build as the top level directory, you can choose to keep the tree wherever you like. When run from the top level directory, the script will auto-detect were the tree is located.

Now you can set up the shell environment variables and run a build:

    cd /path/to/newly/created/build/directory
    source conf/env.sh
    bitbake gpe-image