GDC toolchain README

## Introduction

This provides a pre-built, binary GDC toolchain. GDC is a GCC based compiler for the D language.
Sources are available at github and more information is available on the wiki. Please
report bugs to our bugtracker.

## Installation

Simply extract this archive to some folder, but do not extract to your system root folder (/).

    cd /home/jpf
    wget http://gdcproject.org/downloads/binaries/x86_64-linux-gnu/arm-linux-gnueabi_2.064.2_gcc4.8.2_665978132e_20140312.tar.xz
    tar xf arm-linux-gnueabi_2.064.2_gcc4.8.2_665978132e_20140312.tar.xz

### Windows

Extract the archive with your favorite archive manager, e.g. 7zip. If it asks whether it should overwrite files,
answer yes. (The archives are built on case-sensitive filesystems, extracting on case-insensitive filesystems can cause these warnings).

## Usage

### Introduction

The compiler executable is called TARGET-gdc[.exe] and the full path is TARGET/bin/TARGET-gdc[.exe]. To compile a simple hello world:

    echo 'import std.stdio; void main(){writeln("Hello World!");}' > hello.d
    arm-gdcproject-linux-gnueabi/bin/arm-gdcproject-linux-gnueabi-gdc hello.d -o hello

    #or export the path
    export PATH=$PATH:$PWD/arm-gdcproject-linux-gnueabi/bin
    arm-gdcproject-linux-gnueabi-gdc hello.d -o hello

Windows users should replace arm-gdcproject-linux-gnueabi-gdc with arm-gdcproject-linux-gnueabi-gdc.exe.

More GDC usage information is available at http://wiki.dlang.org/GDC/Using_GDC ,
http://wiki.dlang.org/GDC and http://gdcproject.org .

### Advanced

The difficult part now is how to use third party libraries with cross-compilers.
The standard way to do this is to build all required libraries with this toolchain,
see crosstool-NG for more information.

A simpler way is to use the root filesystems of a real TARGET machine via SSH.
See http://wiki.dlang.org/GDC/Cross_Compiler/Existing_Sysroot for details.