Difference between revisions of "LDC"
Klickverbot (talk | contribs) (→Contributing) |
Klickverbot (talk | contribs) (→Getting started) |
||
| Line 10: | Line 10: | ||
* [[Building and hacking LDC on Windows using MSVC]] | * [[Building and hacking LDC on Windows using MSVC]] | ||
* [[Installing LDC on Gentoo]] | * [[Installing LDC on Gentoo]] | ||
| + | * [[Using LDC]] | ||
== Project status == | == Project status == | ||
Revision as of 21:28, 16 December 2012
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).
Contents
Getting started
- Building LDC from source
- Building and hacking LDC on Windows using MSVC
- Installing LDC on Gentoo
- Using LDC
Project status
In general, LDC should work fine on most x86/x86-64 Unix-like systems, including Linux, OS X 10.7+ and most BSD flavors. Code generation should work for other platforms supported by the LLVM MC codegen infrastructure (for example ARM), but druntime/Phobos support will most likely be lacking.
OS X version prior to 10.7 (Lion) are currently not supported by the D2 compiler, because LLVM's support for thread-local storage depends on functionality which first appeared in 10.7.
x86-64 Windows using MSVC
- LDC/LDC2 from master branch compiles without patches.
- See Building and hacking LDC on Windows using MSVC for detailed instructions.
- LLVM 3.1 is required (3.0 does not work because of missing TLS support); LLVM 3.2 is supported, too.
- druntime and Phobos compile but linker errors are still possible.
- Exception handling still needs work (see here for a first patch; the llvm-objdump part of the patch is here and was commited in LLVM 3.3)
- Contact: kai@redstar.de
ARM
- Code generation is known to work.
- Some initial work has been done on druntime, but support is not yet complete – see issue #116.
Contributing
LDC is an entirely community-driven effort, so all contributions are warmly welcomed. The easiest way to help with development is to write high-quality bug reports for any issues you run into. For a quick guide on what a useful report should contain, please see Reporting LDC issues.
If you are interested in getting into compiler development, anecdotal evidence suggests that hacking on LDC might be a nice first step, particularly because the LLVM backend is very comfortable to work with. To get started, just browse through the issue list, find a ticket that tickles your fancy (some of them are specifically marked as "junior jobs"), and work on a fix – and of course don't hesitate to ask for advice at the mailing list or on IRC. An LDC contributor's guide is planned.
We would also be excited to see LDC packages in more OS distributions, particular Debian and its derivatives. So, if you think you might be able to help, please just drop us a line at the development mailing list. We will actively try to make packaging as smooth as possible, but besides the fact that upstream-maintained packages are sometimes discouraged, it is hard to build good packages for a system you don't know well, so we need to rely on external contributors here.
