STM32 C/C++ COMPILER SOURCE PACKAGE FOR MAC OS X

If you received this file as part of the complete source archive, everything
is here and ready to build (assuming prerequisite software has been installed)
and you can proceed to the next paragraph.  If instead you chose to download
only the build script and patch file (to be applied to the G++ Lite 2008q3
source code package downloaded from www.codesourcery.com), first extract the
latter file (arm-2008q3-39-arm-none-eabi.src.tar.bz2.tar), which will create
a directory itself containing several more archives.  Extract the three
archives 'binutils-2008q3-39.tar.bz2', 'gcc-2008q3-39.tar.bz2' and
'newlib-2008q3-39.tar.bz2' within that directory to create the subdirectories
'binutils-stable', 'gcc-4.3' and 'newlib-stable', then move or copy these
newly-extracted directories into the empty 'src' directory located alongside
this README file.  You will also need to acquire source code for the open
source GMP and MPFR libraries (from gmplib.org and www.mpfr.org respectively),
and likewise extract and place the resulting source directories into 'src'.

To build and install the STM32 C compiler and related tools for Mac OS X 10.5,
execute the script 'build.sh' as root, e.g.:

	sudo sh ./build.sh

A full build may take 30 minutes or more to complete; if you've had a lot
sweets today, this may be a good opportunity to go get something salty.

Upon successful completion, the directory /usr/local/stm32 will contain all
related subdirectories and files.  Before using the C compiler, it may be
helpful to execute the following command and/or add it to your .profile:

	export PATH=$PATH:/usr/local/stm32/bin

For examples of proper invocation of the compiler, linker, etc., see the
FatFryer project (stm32circle.com), in particular the output of the
fatfryer-start script.

I have not tested the build process on PowerPC Macs or prior OS X releases.

This project is legitimately derived from a commercial open-source product,
Sourcery G++ Lite 2008q3-39 (www.codesourcery.com), in accordance with the
license terms for that software.  Please note however that this build does NOT
constitute a CodeSourcery(tm) product, and they must not be burdened with any
support issues that result.  If you encounter any problems in compilation or
use, either contact the build script author (pburgess@dslextreme.com), examine
the source code and Makefiles, or you may find answers by searching various
online microcontroller development forums.  Also note that the included source
comprises only a subset of the full Sourcery G++ Lite package, but that each
included subcomponent (binutils, GCC, Newlib, etc.) is preserved verbatim in
its whole and original form, including all applicable license files, adhering
to the terms within.  The file 'COPYING' and its variants, appearing in
several locations throughout the source code, detail license restrictions,
requirements, and legal disclaimers.
