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

Build Guide for on
******************

     [file chapter.introduction.texi not included]

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

Building on is well supported. It is the reference platform for. The following are the recommended specifications for this platform; but is not necessarily the only configuration that is possible:

  * Mac Intel hardware

  * 10.5.7

  * Xcode-3.1.2

  * gcc 4.0.1 (Apple Inc. build 5490)

  * yasm 0.8.0.2194 (for i386 and x86_64 architectures)

     [file prerequisites.bundled.texi not included]
     [file prerequisites.common.texi not included]

     [file chapter.quickstart.texi not included]

Overview
********

The two general methods to build on are from terminal or Xcode.app. The preferred method for automated and repeatable builds is to use the terminal. Otherwise the choice is generally up to the individual. To be extra clear, building from the terminal by default actually invokes xcodebuild to build the very same targets contained in the Xcode project. Think of it as building with Xcode but without the GUI.

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

Universal Binaries
==================

This section outlines convenience procedures for creating Universal Binaries for all the architectures.

     The dummy (container) build configuration uses --disable-xcode; but the nested architecture builds will all make full use of Xcode.

Create a dummy (container) build configuration and use it to launch a nested-build for each architecture serially; optionally you may substitute make ub.build.serial for make ub.build.parallel if your machine has the horsepower:

     ./configure --disable-xcode
     cd build/
     make ub.build.serial
     make ub.combine

To specify a subset of architectures to be built first create/edit _SRC_/custom.defs with the following override to build UB for i386 and x86_64 before invoking make:

     ## prefer i386 (order is important)
     UB.archs = i386 x86_64

     [file chapter.via.xcode.texi not included]
     [file chapter.troubleshooting.texi not included]
     [file appendix.repo.texi not included]