mirror of
https://github.com/xomboverlord/ldc.git
synced 2026-01-11 18:33:14 +01:00
2d3de4a3d4
We can't simply use the C calling convention, as the D(MD) ABI is callee-pop, and this is hardcoded in naked functions with stack parameters. The \1 "trick" is normally used to avoid prefixes added by LLVM; on the 3.2 release, a patch is needed to make it work for the @<n> stdcall suffixes as well.
LDC – the LLVM D Compiler
=========================
The LDC project aims to provide a portable D programming language
compiler with modern optimization and code generation capabilities.
The compiler uses the official DMD frontends to support both D1 and D2,
and relies on the LLVM Core libraries for code generation.
LDC is fully Open Source; the parts of the code not taken/adapted from
other projects are BSD-licensed (see the LICENSE file for details).
Please consult the D wiki for further information:
http://wiki.dlang.org/LDC
Installation
------------
In-depth material on building and installing LDC and the standard
libraries, including experimental instructions for running LDC on
Windows, is available on the project wiki, at
http://wiki.dlang.org/Building_LDC_from_source.
For the impatient, a quick guide for building on *nix systems:
1) Make sure your system has the necessary prerequisites:
- a working C++ build environment,
- CMake,
- LLVM 3.0+ (3.2 preferred),
- libconfig++ (http://hyperrealm.com/libconfig/libconfig.html).
2) Check out the library submodules, if you have not already:
$ cd ldc
$ git submodule update --init
3) Build and install LDC:
$ mkdir build && cd build # Out-of-source builds are recommended.
$ cmake .. # Use -DD_VERSION=1 to build the D1 compiler.
$ make
$ make install # Or run LDC directly from the bin/ directory.
In case the above steps do not work, please first visit the extended
documentation under the aforementioned URL.
Some Linux distributions are also packaging a recent version of LDC,
so building it manually might not be necessary.
Contact
-------
The best way to get in touch with the developers is either via the
digitalmars.D.ldc forum/newsgroup/mailing list (http://forum.dlang.org)
or the #ldc IRC channel on FreeNode.
For further documentation, contributor information, etc. please see the
D wiki: http://wiki.dlang.org/LDC
Feedback of any kind is very much appreciated!