texinfo
     [file article.texi not included]
     [file command.texi not included]

Guide to Building on
********************

     [file chapter.introduction.texi not included]

Prerequisites
*************

The following are the recommended specifications for building on; but is not necessarily the only configuration that is possible:

  * Intel 32-bit or 64-bit kernel

  * Ubuntu 8.0.4, gcc 4.3.0, yasm 0.7.1.2093

  * Ubuntu 8.10, gcc 4.3.2, yasm 0.7.1.2093

  * Fedora 9, gcc 4.3.0, yasm 0.7.1.2093

  * Fedora 10, gcc 4.3.2, yasm 0.7.1.2093

  * gcc 4.0.0 or higher is reported to work

     [file prerequisites.bundled.texi not included]

     [file prerequisites.common.texi not included]

The GTK UI introduces some significant extra build requirements. If you intend to disable building the GUI with configure --disable-gtk you will not need many of these packages installed:

Ubuntu 8.10 packages:

  * build-essential

  * autoconf (gui)

  * intltool (gui)

  * libtool (gui)

  * zlib1g-dev (gui)

  * libbz2-dev

  * libglib2.0-dev (gui)

  * libdbus-glib-1-dev (gui)

  * libgtk2.0-dev (gui)

  * libhal-dev (gui)

  * libhal-storage-dev (gui)

  * libgtkhtml3.14-dev (gui)

  * libgstreamer0.10-dev (gui)

  * libgstreamer-plugins-base0.10-dev (gui)

To install these packages:

     sudo apt-get install subversion yasm build-essential \
     autoconf intltool libtool zlib1g-dev libbz2-dev libglib2.0-dev \
     libdbus-glib-1-dev libgtk2.0-dev libhal-dev libhal-storage-dev \
     libgtkhtml3.14-dev libgstreamer0.10-dev libgstreamer-plugins-base0.10-dev

Fedora 10 package groups:

  * Development Tools

  * Development Libraries

  * X Software Development (gui)

  * GNOME Software Development (gui)

To install these package groups:

     sudo yum groupinstall "Development Tools" "Development Libraries" \
     "X Software Development" "GNOME Software Development"

Additional Fedora 10 packages:

  * zlib-devel (gui)

  * bzip2-devel

  * dbus-glib-devel (gui)

  * hal-devel (gui)

  * gtkhtml3-devel (gui)

  * gstreamer-devel (gui)

  * gstreamer-plugins-base-devel (gui)

To install these packages:

     sudo yum install yasm zlib-devel bzip2-devel \
     dbus-glib-devel hal-devel gtkhtml3-devel \
     gstreamer-devel gstreamer-plugins-base-devel

     [file chapter.quickstart.texi not included]

Overview
********

builds are performed from a terminal. There is no support for building from any IDEs.

     [file chapter.via.terminal.texi not included]