Skip to content

Commit ed9ccc1

Browse files
committed
README: make note of what features are missing without LLVM
1 parent 2777aed commit ed9ccc1

File tree

1 file changed

+22
-4
lines changed

1 file changed

+22
-4
lines changed

README.md

Lines changed: 22 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -66,20 +66,38 @@ page on the wiki.
6666

6767
## Building from Source without LLVM
6868

69-
If you don't need your Zig compiler to have LLVM extensions enabled, you can
70-
follow these instructions instead.
71-
7269
In this case, the only system dependency is a C compiler.
7370

7471
```
7572
cc -o bootstrap bootstrap.c
7673
./bootstrap build
7774
```
7875

79-
You can pass any options to this that you would pass to `zig build`.
76+
You 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
80+
compiler 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+
83101
Zig is Free and Open Source Software. We welcome bug reports and patches from
84102
everyone. However, keep in mind that Zig governance is BDFN (Benevolent
85103
Dictator For Now) which means that Andrew Kelley has final say on the design

0 commit comments

Comments
 (0)