Aros-gcc-1.0

PURPOSE
Create aros gcc, g++, objc cross compilers, create compiler that is able to
build linux powerpc hosted version of AROS.

SUPPORTED GCC VERSIONS
3.4.6

BUILD ENVIRONMENT
Of course, the build host you are running must be able to compile gcc. AROS
itself currently is not. These are most Un*x like systems like Linux, the
BSD variants or Cygwin. Your also need to have the tools wget and curl
available. Because almost everything is fetched from the net you also need
an active internet connection.

TESTED BUILD HOSTS
- Debian Linux PowerPc          system and cross targets
- Cygwin                        cross targets
- Gentoo Linux 32 bit on PS3    system and cross targets

USAGE
[PREFIX=<install-dir>] [TARGET=<target>] make build-gcc

During the build of collect-aros, we already need installed binutils,
so the user issuing the above command must have write permission in
<install-dir>.

INSTALLATION
[PREFIX=<install-dir>] [TARGET=<target>] make install

By default we install into /usr/local.

!!!!!!
On a system that compiles its own updates with a newer gcc version like
Gentoo Linux, PLEASE know what you do, otherwise you might mess up your
system. In order to disable this custom gcc I do
mv /usr/local/bin /usr/local/bin_
mv /usr/local/lib /usr/local/lib_
to move it out of the search path. After that you might have to use a
new shell or reboot.
!!!!!!

TARGETS
system      default target
            Builds a patched system compiler, e.g. on a linux system, that is
            able to build linux hosted version of AROS. Currently, this makes
            only sense on a powerpc host.

i386        cross target
            Builds a cross compiler that is generating code for i386 AROS
            and is running on the current host, ie. the host system it is
            built on.

powerpc     cross target
            Same as i386 for powerpc.

EXAMPLES
Build and install powerpc cross compiler.
TARGET=powerpc make build-gcc
TARGET=powerpc make install

Build and install system compiler.
make build-gcc
make install

LIST OF FILES
patches/binutils-2.16.1-aros.diff       Patch to build AROS cross binutils.
patches/gcc-3.4.6-aros.diff             Patch to build the mentioned
                                        compilers.
README                              *   This file.
Makefile                            *   Makefile to build and install the
                                        mentioned compilers.
configure.ac                        *   autotool input file
configure                               Configure script needed to build
                                        collect-aros. Generated by autoconf.
acinclude.m4                            Autotool input file, taken from
                                        AROS source tree and modified.
aclocal.m4                              Generated by aclocal.
get_sdk_archive.sh                  *   Helper script to download needed sdk.

LICENSE
For all the files I have created (marked with *)
the AROS PUBLIC LICENSE Version 1.1 shall apply.

TODO
- Update installed SDK.
- Add gdc to the list of supported languages.
- Use newer versions of gcc.
- Use newer versions of binutils.
- Improve documentation.
- Use gnu mirrors.
- Use something like make config or make menuconfig.
- Create native compilers, ie. compilers running inside of AROS.
- Although tests were done in a 32 bit environment on PS3 which is
  a 64 bit machine, this release might not build everything correctly
  on such systems.

Any feedback to weissms()aros.org is welcome.
ciao, Markus