Short:        GCC-based development toolchain
Author:       GNU and adtools authors
Uploader:     mail sebastianbauer info (Sebastian Bauer)
Type:         dev/gcc
Version:      20180502-559
Architecture: ppc-amigaos >= 4.1.0
Kurz:         GCC-basierte Toolchain für AmigaOS 4.x

This archive includes native AmigaOS 4.1 compiles of
 * binutils 2.23.2,
 * gcc 8.1.0, and
 * coreutils 5.2.1
based on https://github.com/sba/sba1/adtools version 20180502-559
commit 26c39450e024418c9bfa2b410f0ba3c397a9132c.

In order to install it on your Amiga, extract the archive to a destination of your
choice. Then establish a GCC: assignment to the extracted folder and add the contained
bin folder to the command search path
  1> ASSIGN GCC: <extracted folder>
  1> PATH GCC:bin add

Furthermore, you need to have an SDK: assign as in the original SDK.

Note that if you use the APPDIR: feature you should flush its contents. Otherwise, you
may observe unexpected behaviour. Most easily this can be achieved by entering

 1> delete APPDIR:#?

This is a preliminary version and as such it will contain still many bugs. Please use
the issue tracker at https://github.com/sba1/adtools/issues for reporting bugs.

Note that the plan is to split the project and move the parts to separate subprojects
at https://github.com/adtools/. One other goal is to include the projects or updated
ones as part of one of the next AmigaOS SDK.

About the C++ support
=====================

C++-support using clib2 clib (enabled via -mcrt=clib2) is much better than with
the newlib clib at the moment. If you encounter any errors when compiling C++
projects using newlib, also try clib2. To be successful, you should use the
accompanying clib2 release archive adtools-os4-clib2-20180502-559.lha and install its
contents into the SDK: folder. You can find this (unofficial) archive at
https://dl.bintray.com/sba1/adtools-native/.

Also for C++, it is recommended not to use the shared objects feature (aka
dynload) for now. The reason is that the C++-ABI may change in the future.

Changes of the AmigaOS version
==============================

In the doc folder, there is some usual gcc documentation provided. This is actually
a diff of the original documentation, so AmigaOS-relevant changes are easily
recognizable.