authorgravatar for andrew@ziglang.orgAndrew Kelley <andrew@ziglang.org> 2023-11-06 13:18:04-07:00
committergravatar for andrew@ziglang.orgAndrew Kelley <andrew@ziglang.org> 2023-11-12 17:30:24-07:00
log910143e54cc1abf8069bf3a9727d76f50342bf8a
treebd1c1919be1f2d20977e49897338ce14d3a0f1b2
parent621e89a863152978834f2c2562971cca846f9b3e

README: make note of what features are missing without LLVM


1 files changed, 22 insertions(+), 4 deletions(-)

README.md+22-4
......@@ -66,9 +66,6 @@ page on the wiki.
6666
6767## Building from Source without LLVM
6868
69If you don't need your Zig compiler to have LLVM extensions enabled, you can
70follow these instructions instead.
71
7269In this case, the only system dependency is a C compiler.
7370
7471```
......@@ -76,10 +73,31 @@ cc -o bootstrap bootstrap.c
7673./bootstrap build
7774```
7875
79You can pass any options to this that you would pass to `zig build`.
76You can pass any options to this that you would pass to `zig build` (see
77`--help` for options).
78
79[Without LLVM extensions](https://github.com/ziglang/zig/issues/16270), a Zig
80compiler is missing these features:
81- Release mode optimizations
82- aarch64 machine code backend
83- `@cImport` / `zig translate-c`
84- Ability to compile C files
85- Ability to compile assembly files
86- [Some ELF linking features](https://github.com/ziglang/zig/issues/17749)
87- [Most COFF/PE linking features](https://github.com/ziglang/zig/issues/17751)
88- [Some WebAssembly linking features](https://github.com/ziglang/zig/issues/17750)
89- [COFF linking](https://github.com/ziglang/zig/issues/17751)
90- [Ability to output LLVM bitcode](https://github.com/ziglang/zig/issues/13265)
91- [Windows resource file compilation](https://github.com/ziglang/zig/issues/17752)
92- [Ability to create import libs from def files](https://github.com/ziglang/zig/issues/17807)
93- [Automatic importlib file generation for Windows DLLs](https://github.com/ziglang/zig/issues/17753)
94- [Ability to create static archives from object files](https://github.com/ziglang/zig/issues/9828)
95- Ability to compile C++, Objective-C, and Objective-C++ files
8096
8197## Contributing
8298
99[Donate monthly](https://ziglang.org/zsf/).
100
83101Zig is Free and Open Source Software. We welcome bug reports and patches from
84102everyone. However, keep in mind that Zig governance is BDFN (Benevolent
85103Dictator For Now) which means that Andrew Kelley has final say on the design