Go to file
Michael Dusan fe254ea309 stage1: avoid building empty memory_profiling.cpp
During build an empty .o on macOS/Xcode emits warning:

    ranlib: file: zig_cpp/libcompiler.a(memory_profiling.cpp.o) has no symbols
    ranlib: file: zig_cpp/libcompiler.a(memory_profiling.cpp.o) has no symbols
2019-11-25 19:08:36 -05:00
.builds ci: avoid leaking oauth access token 2019-11-03 14:55:21 -05:00
.github funding: I've been accepted into the GitHub Sponsors program 2019-07-11 13:00:39 -04:00
ci ci: --no-mime-magic 2019-11-25 14:58:45 -05:00
cmake msvc: reduce inlining aggressivity to workaround a codegen bug in cl.exe cf. #3024 2019-10-16 19:04:50 -04:00
deps Revert LLD patch 2019-10-12 10:57:11 +02:00
doc rename std.heap.direct_allocator to std.heap.page_allocator 2019-11-25 17:25:06 -05:00
lib move logic to the appropriate layers; add new compile error 2019-11-25 18:46:17 -05:00
src move logic to the appropriate layers; add new compile error 2019-11-25 18:46:17 -05:00
src-self-hosted rename std.heap.direct_allocator to std.heap.page_allocator 2019-11-25 17:25:06 -05:00
test move logic to the appropriate layers; add new compile error 2019-11-25 18:46:17 -05:00
tools rename std.heap.direct_allocator to std.heap.page_allocator 2019-11-25 17:25:06 -05:00
.gitattributes git, I love you, but please stop mangling my files 2019-09-22 18:11:55 -04:00
.gitignore fix .gitignore file and add commit missing std lib file 2019-02-26 18:33:27 -05:00
CMakeLists.txt stage1: avoid building empty memory_profiling.cpp 2019-11-25 19:08:36 -05:00
CONTRIBUTING.md add -DZIG_SKIP_INSTALL_LIB_FILES cmake option 2019-09-26 02:21:29 -04:00
LICENSE add license 2015-08-05 16:22:18 -07:00
README.md README: update the short description of what zig is 2019-11-13 13:44:19 -05:00
build.zig self hosted compiler: final small fixes to get it compiling 2019-11-24 10:24:47 +02:00

README.md

ZIG

A general-purpose programming language for maintaining robust, optimal, and reusable code.

Resources

Building from Source

Build Status

Note that you can download a binary of master branch.

Stage 1: Build Zig from C++ Source Code

Dependencies

POSIX
  • cmake >= 2.8.5
  • gcc >= 5.0.0 or clang >= 3.6.0
  • LLVM, Clang, LLD development libraries == 9.x, compiled with the same gcc or clang version above
Windows
  • cmake >= 3.15.3
  • Microsoft Visual Studio. Supported versions:
    • 2015 (version 14)
    • 2017 (version 15.8)
    • 2019 (version 16)
  • LLVM, Clang, LLD development libraries == 9.x

Instructions

POSIX
mkdir build
cd build
cmake ..
make install
MacOS
brew install cmake llvm@9
brew outdated llvm@9 || brew upgrade llvm@9
mkdir build
cd build
cmake .. -DCMAKE_PREFIX_PATH=$(brew --prefix llvm)
make install
Windows

See https://github.com/ziglang/zig/wiki/Building-Zig-on-Windows

Stage 2: Build Self-Hosted Zig from Zig Source Code

Note: Stage 2 compiler is not complete. Beta users of Zig should use the Stage 1 compiler for now.

Dependencies are the same as Stage 1, except now you can use stage 1 to compile Zig code.

bin/zig build --prefix $(pwd)/stage2

This produces ./stage2/bin/zig which can be used for testing and development. Once it is feature complete, it will be used to build stage 3 - the final compiler binary.

Stage 3: Rebuild Self-Hosted Zig Using the Self-Hosted Compiler

Note: Stage 2 compiler is not yet able to build Stage 3. Building Stage 3 is not yet supported.

Once the self-hosted compiler can build itself, this will be the actual compiler binary that we will install to the system. Until then, users should use stage 1.

Debug / Development Build

./stage2/bin/zig build --prefix $(pwd)/stage3

Release / Install Build

./stage2/bin/zig build install -Drelease