amigaos-cross-toolchain/README

Info: m68k-amigaos gcc/binutils toolchain bootstrap.
Author: Krystian Bacławski <firstname [dot] lastname [at] gmail [dot] com>

This project enables one to build m68k-amigaos toolchain on your un*x like
platform with minimum hassle. Thanks to it you should get complete environment
targeting m68k-amigaos with:
 * gcc 2.95.3
 * g++ 2.95.3 + libstdc++
 * binutils 2.9.1 (assembler, linker, etc.)
 * libnix 2.1 (standard ANSI/C library replacement for AmigaOS)
 * libm 5.4 (provides math library implementation for non-FPU Amigas)
 * AmigaOS headers & libraries (for AmigaOS 3.9)
 * ixemul.library 48.2
 * vbcc 0.9b + vclib
 * vasm 1.5c
 * vlink 0.14a

Patches are welcome!

Tested on:
 * Ubuntu 10.04 32-bit (gcc 4.4.3)
 * MacOS X 10.7 (gcc 4.2.1 (build 5658) (LLVM build 2336.1.00))

Prerequisites (look at bootstrap.conf file):
 * installed locally:
   - gcc
   - flex
   - make
   - lha
   - perl 5.10
 * sources from GNU project:
   - gcc 2.95.3
   - binutils 2.9.1
   - bison 1.35
   - gawk 1.3.8
 * Amiga specific sources & binaries:
   - libnix 2.1
   - libm 5.4
   - AmigaOS NDK 3.9
   - sfdc 1.4
   - libamiga-bin
 * VBCC related sources & binaries:
   - vbcc 0.9b
   - vasm 1.5c
   - vlink 0.14a
   - vbcc m68k-amigaos target files

Usage:
  1) Download sources (use fetch.sh script in archives directory).
  2) Run bootstrap.sh script (with --prefix option to tell where the toolchain
     should be installed - note that the path has to be writable).
  3) Wait for the result.
  ?) If something fails, you can try to reach me.

TODO:
  * Testing on:
    - Cygwin
  * Remove dependencies:
    - libamiga-bin
  * Provide some rudimentary testing (C / C++ sources).
  * Add auxiliary tools: hunk2aout.
  * Build timezone data for ixemul (zic).