diff options
| author | Andrew Kelley <andrew@ziglang.org> | 2023-11-06 13:18:04 -0700 |
|---|---|---|
| committer | Andrew Kelley <andrew@ziglang.org> | 2023-11-12 17:30:24 -0700 |
| commit | 910143e54cc1abf8069bf3a9727d76f50342bf8a (patch) | |
| tree | bd1c1919be1f2d20977e49897338ce14d3a0f1b2 | |
| parent | 621e89a863152978834f2c2562971cca846f9b3e (diff) | |
| download | zig-910143e54cc1abf8069bf3a9727d76f50342bf8a.tar.gz zig-910143e54cc1abf8069bf3a9727d76f50342bf8a.zip | |
README: make note of what features are missing without LLVM
| -rw-r--r-- | README.md | 26 |
1 files changed, 22 insertions, 4 deletions
@@ -66,9 +66,6 @@ page on the wiki. ## Building from Source without LLVM -If you don't need your Zig compiler to have LLVM extensions enabled, you can -follow these instructions instead. - In this case, the only system dependency is a C compiler. ``` @@ -76,10 +73,31 @@ cc -o bootstrap bootstrap.c ./bootstrap build ``` -You can pass any options to this that you would pass to `zig build`. +You can pass any options to this that you would pass to `zig build` (see +`--help` for options). + +[Without LLVM extensions](https://github.com/ziglang/zig/issues/16270), a Zig +compiler is missing these features: +- Release mode optimizations +- aarch64 machine code backend +- `@cImport` / `zig translate-c` +- Ability to compile C files +- Ability to compile assembly files +- [Some ELF linking features](https://github.com/ziglang/zig/issues/17749) +- [Most COFF/PE linking features](https://github.com/ziglang/zig/issues/17751) +- [Some WebAssembly linking features](https://github.com/ziglang/zig/issues/17750) +- [COFF linking](https://github.com/ziglang/zig/issues/17751) +- [Ability to output LLVM bitcode](https://github.com/ziglang/zig/issues/13265) +- [Windows resource file compilation](https://github.com/ziglang/zig/issues/17752) +- [Ability to create import libs from def files](https://github.com/ziglang/zig/issues/17807) +- [Automatic importlib file generation for Windows DLLs](https://github.com/ziglang/zig/issues/17753) +- [Ability to create static archives from object files](https://github.com/ziglang/zig/issues/9828) +- Ability to compile C++, Objective-C, and Objective-C++ files ## Contributing +[Donate monthly](https://ziglang.org/zsf/). + Zig is Free and Open Source Software. We welcome bug reports and patches from everyone. However, keep in mind that Zig governance is BDFN (Benevolent Dictator For Now) which means that Andrew Kelley has final say on the design |