Release 0.12.1

tracked by #20212

.gitattributes

@@ -2,22 +2,14 @@
 *.zon text eol=lf
 *.txt text eol=lf
 langref.html.in text eol=lf
-
-lib/libc/*/abilists binary
-
 lib/std/compress/testdata/** binary
+lib/std/compress/deflate/testdata/** binary
 lib/std/compress/flate/testdata/** binary
-lib/std/compress/lzma/testdata/** binary
-lib/std/compress/xz/testdata/** binary
-lib/std/crypto/codecs/asn1/der/testdata/** binary
-lib/std/tar/testdata/** binary
-src/Package/Fetch/testdata/** binary
-src/Package/Fetch/git/testdata/** binary
 
-lib/compiler/aro/** linguist-vendored
 lib/include/** linguist-vendored
 lib/libc/** linguist-vendored
 lib/libcxx/** linguist-vendored
 lib/libcxxabi/** linguist-vendored
-lib/libtsan/** linguist-vendored
 lib/libunwind/** linguist-vendored
+lib/tsan/** linguist-vendored
+lib/compiler/aro/** linguist-vendored

.github/CODEOWNERS

@@ -0,0 +1,11 @@
+# std.json
+/lib/std/json* @thejoshwolfe
+
+# std.Thread
+/lib/std/Thread* @kprotty
+
+# resinator
+/lib/compiler/resinator/* @squeek502
+
+# SPIR-V selfhosted backend
+/src/codegen/spirv* @Snektron

.github/ISSUE_TEMPLATE/config.yml

@@ -5,6 +5,3 @@ contact_links:
   - name: Question
     about: Please use one of the community spaces for questions or general discussions.
     url: https://github.com/ziglang/zig/wiki/Community
-  - name: Copilot and Other LLMs
-    about: Please do not use GitHub Copilot or any other LLM to write an issue.
-    url: https://github.com/ziglang/zig/wiki/Writing-Issues-with-Copilot-and-Other-LLMs

.github/workflows/ci.yaml

@@ -4,33 +4,22 @@ on:
   push:
     branches:
       - master
-      - 0.15.x
+      - 0.12.x
 concurrency:
   # Cancels pending runs when a PR gets updated.
   group: ${{ github.head_ref || github.run_id }}-${{ github.actor }}
   cancel-in-progress: true
-permissions:
-  # Sets permission policy for `GITHUB_TOKEN`
-  contents: read
 jobs:
   x86_64-linux-debug:
-    timeout-minutes: 540
+    timeout-minutes: 420
     runs-on: [self-hosted, Linux, x86_64]
     steps:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Build and Test
         run: sh ci/x86_64-linux-debug.sh
-  x86_64-linux-debug-llvm:
-    timeout-minutes: 540
-    runs-on: [self-hosted, Linux, x86_64]
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Build and Test
-        run: sh ci/x86_64-linux-debug-llvm.sh
   x86_64-linux-release:
-    timeout-minutes: 540
+    timeout-minutes: 420
     runs-on: [self-hosted, Linux, x86_64]
     steps:
       - name: Checkout
@@ -38,6 +27,7 @@ jobs:
       - name: Build and Test
         run: sh ci/x86_64-linux-release.sh
   aarch64-linux-debug:
+    timeout-minutes: 480
     runs-on: [self-hosted, Linux, aarch64]
     steps:
       - name: Checkout
@@ -45,6 +35,7 @@ jobs:
       - name: Build and Test
         run: sh ci/aarch64-linux-debug.sh
   aarch64-linux-release:
+    timeout-minutes: 480
     runs-on: [self-hosted, Linux, aarch64]
     steps:
       - name: Checkout
@@ -52,7 +43,7 @@ jobs:
       - name: Build and Test
         run: sh ci/aarch64-linux-release.sh
   x86_64-macos-release:
-    runs-on: "macos-13"
+    runs-on: "macos-11"
     env:
       ARCH: "x86_64"
     steps:
@@ -79,7 +70,6 @@ jobs:
       - name: Build and Test
         run: ci/aarch64-macos-release.sh
   x86_64-windows-debug:
-    timeout-minutes: 420
     runs-on: [self-hosted, Windows, x86_64]
     env:
       ARCH: "x86_64"
@@ -89,7 +79,6 @@ jobs:
       - name: Build and Test
         run: ci/x86_64-windows-debug.ps1
   x86_64-windows-release:
-    timeout-minutes: 420
     runs-on: [self-hosted, Windows, x86_64]
     env:
       ARCH: "x86_64"
@@ -98,3 +87,12 @@ jobs:
         uses: actions/checkout@v4
       - name: Build and Test
         run: ci/x86_64-windows-release.ps1
+  aarch64-windows:
+    runs-on: [self-hosted, Windows, aarch64]
+    env:
+      ARCH: "aarch64"
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Build and Test
+        run: ci/aarch64-windows.ps1

.gitignore

@@ -9,14 +9,10 @@
 # Cheers!
 # -andrewrk
 
-.zig-cache/
+zig-cache/
 zig-out/
 /release/
 /debug/
 /build/
 /build-*/
 /docgen_tmp/
-
-# Although this was renamed to .zig-cache, let's leave it here for a few
-# releases to make it less annoying to work with multiple branches.
-zig-cache/

.mailmap

@@ -9,8 +9,6 @@ David Rubin <daviru007@icloud.com> <87927264+Rexicon226@users.noreply.github.com
 Dominic <4678790+dweiller@users.noreply.github.com>
 Dominic <4678790+dweiller@users.noreply.github.com> <4678790+dweiller@users.noreplay.github.com>
 Eric Eastwood <madlittlemods@gmail.com> <contact@ericeastwood.com>
-Eric Joldasov <bratishkaerik@landless-city.net>
-Eric Joldasov <bratishkaerik@landless-city.net> <bratishkaerik@landless-city.net>
 Felix "xq" Queißner <xq@random-projects.net>
 Felix "xq" Queißner <xq@random-projects.net> <felix@ib-queissner.de>
 Felix "xq" Queißner <xq@random-projects.net> <git@masterq32.de>
@@ -19,16 +17,12 @@ Felix "xq" Queißner <xq@random-projects.net> <git@random-projects.net>
 Frank Denis <124872+jedisct1@users.noreply.github.com> <github@pureftpd.org>
 Garrett Beck <garrettlennoxbeck@gmail.com> <138411610+garrettlennoxbeck@users.noreply.github.com>
 Gaëtan S <blaxoujunior@gmail.com>
-GalaxyShard <dominic.adragna@byteroach.com>
-GalaxyShard <dominic.adragna@byteroach.com> <76917584+GalaxyShard@users.noreply.github.com>
 HydroH <iodizon@163.com> <ixlesis@gmail.com>
 Igor Anić <igor.anic@gmail.com>
 IntegratedQuantum <jahe788@gmail.com> <43880493+IntegratedQuantum@users.noreply.github.com>
 Isaac Freund <mail@isaacfreund.com> <ifreund@ifreund.xyz>
 Isaac Freund <mail@isaacfreund.com> <isaac.freund@coil.com>
-Jacob Young <amazingjacob@gmail.com>
-Jacob Young <amazingjacob@gmail.com> <jacobly0@users.noreply.github.com>
-Jacob Young <amazingjacob@gmail.com> <15544577+jacobly0@users.noreply.github.com>
+Jacob Young <jacobly0@users.noreply.github.com>
 Jan Philipp Hafer <jan.hafer@rwth-aachen.de> <anon_1plus1equals3@mailbox.org>
 Jeremy Volkman <jeremy@jvolkman.com> <jeremy@cedarai.com>
 Jimmi Holst Christensen <jhc@dismail.de> <jhc@dismail.de>
@@ -41,15 +35,10 @@ Jonathan Marler <johnnymarler@gmail.com> <jonathan.j.marler@hp.com>
 Krzysztof Wolicki <der.teufel.mail@gmail.com>
 Krzysztof Wolicki <der.teufel.mail@gmail.com> <46651553+der-teufel-programming@users.noreply.github.com>
 LemonBoy <thatlemon@gmail.com> <LemonBoy@users.noreply.github.com>
-Lucas Santos <lucascarvalhosantos91@gmail.com>
-Lucas Santos <lucascarvalhosantos91@gmail.com> <117400842+LucasSantos91@users.noreply.github.com>
 Luuk de Gram <luuk@degram.dev> <Luukdegram@users.noreply.github.com>
 Marc Tiehuis <marc@tiehu.is> <marctiehuis@gmail.com>
-Mason Remaley <mason@anthropicstudios.com>
-Mason Remaley <mason@anthropicstudios.com> <MasonRemaley@users.noreply.github.com>
 Matthew Lugg <mlugg@mlugg.co.uk>
 Meghan Denny <hello@nektro.net>
-Meghan Denny <hello@nektro.net> <meghan@bun.sh>
 Michael Bartnett <michael.bartnett@gmail.com> <michaelbartnett@users.noreply.github.com>
 Motiejus Jakštys <motiejus@jakstys.lt> <motiejus@uber.com>
 Niles Salter <Validark@pm.me>
@@ -69,15 +58,9 @@ Travis Staloch <twostepted@gmail.com>
 Travis Staloch <twostepted@gmail.com> <1562827+travisstaloch@users.noreply.github.com>
 Veikka Tuominen <git@vexu.eu>
 Veikka Tuominen <git@vexu.eu> <15308111+Vexu@users.noreply.github.com>
-Will Lillis <will.lillis24@gmail.com>
-Will Lillis <will.lillis24@gmail.com> <wlillis@umass.edu>
 Wooster <r00ster91@proton.me>
 Wooster <r00ster91@proton.me> <wooster0@proton.me>
 antlilja <liljaanton2001@gmail.com> <12533691+antlilja@users.noreply.github.com>
 february cozzocrea <february.cozzocrea@gmail.com> <91439207+f-cozzocrea@users.noreply.github.com>
 garrisonhh <garrisonhh@pm.me> <71951273+garrisonhh@users.noreply.github.com>
-kj4tmp <kj4tmp@gmail.com>
-kj4tmp <kj4tmp@gmail.com> <56497124+kj4tmp@users.noreply.github.com>
-saurabh <saurabhm@proton.me>
-saurabh <tech@saurabh.mozmail.com> <saurabhm@proton.me>
 xEgoist <egoist@egoistic.dev> <101279047+xEgoist@users.noreply.github.com>

LICENSE

@@ -1,14 +1,3 @@
-NOTICE TO PROSPECTIVE UPSTREAM CONTRIBUTORS of zig0/stage0
-
-Zig0, the stage0 interpreter, was written with heavy assistance of an LLM.
-
-Zig0 is licensed under the MIT License below. However, the author politely but
-firmly requests that you do not submit this work, or any derivative thereof, to
-the Zig project upstream unless you have obtained explicit written permission
-from a Zig core team member authorizing the submission.
-
----
-
 The MIT License (Expat)
 
 Copyright (c) Zig contributors

README.md

@@ -13,9 +13,11 @@ Documentation** corresponding to the version of Zig that you are using by
 following the appropriate link on the
 [download page](https://ziglang.org/download).
 
-Otherwise, you're looking at a release of Zig, so you can find the language
-reference at `doc/langref.html`, and the standard library documentation by
-running `zig std`, which will open a browser tab.
+Otherwise, you're looking at a release of Zig, and you can find documentation
+here:
+
+ * doc/langref.html
+ * doc/std/index.html
 
 ## Installation
 
@@ -45,9 +47,9 @@ mechanism supports that use case too (i.e. `/usr/bin/zig` and `/usr/lib/zig/`).
 
 Ensure you have the required dependencies:
 
- * CMake >= 3.15
+ * CMake >= 3.5
  * System C/C++ Toolchain
- * LLVM, Clang, LLD development libraries == 20.x
+ * LLVM, Clang, LLD development libraries == 17.x
 
 Then it is the standard CMake build process:
 
@@ -76,25 +78,21 @@ This produces a `zig2` executable in the current working directory. This is a
 [without LLVM extensions](https://github.com/ziglang/zig/issues/16270), and is
 therefore lacking these features:
 - Release mode optimizations
-- [aarch64 machine code backend](https://github.com/ziglang/zig/issues/21172)
-- [@cImport](https://github.com/ziglang/zig/issues/20630)
-- [zig translate-c](https://github.com/ziglang/zig/issues/20875)
-- [Ability to compile assembly files](https://github.com/ziglang/zig/issues/21169)
+- 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)
 - [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, C++, Objective-C, and Objective-C++ files
+- Ability to compile C++, Objective-C, and Objective-C++ files
 
 However, a compiler built this way does provide a C backend, which may be
 useful for creating system packages of Zig projects using the system C
-toolchain. **In this case, LLVM is not needed!**
-
-Furthermore, a compiler built this way provides an LLVM backend that produces
-bitcode files, which may be compiled into object files via a system Clang
-package. This can be used to produce system packages of Zig applications
-without the Zig package dependency on LLVM.
+toolchain. In such case, LLVM is not needed!
 
 ## Contributing
 

bootstrap.c

@@ -64,8 +64,6 @@ static const char *get_host_os(void) {
     return "linux";
 #elif defined(__FreeBSD__)
     return "freebsd";
-#elif defined(__DragonFly__)
-    return "dragonfly";
 #elif defined(__HAIKU__)
     return "haiku";
 #else
@@ -125,7 +123,7 @@ int main(int argc, char **argv) {
         if (f == NULL)
             panic("unable to open config.zig for writing");
 
-        const char *zig_version = "0.14.0-dev.bootstrap";
+        const char *zig_version = "0.12.0-dev.bootstrap";
 
         int written = fprintf(f,
             "pub const have_llvm = false;\n"
@@ -141,9 +139,9 @@ int main(int argc, char **argv) {
             "pub const enable_tracy = false;\n"
             "pub const value_tracing = false;\n"
             "pub const skip_non_native = false;\n"
-            "pub const debug_gpa = false;\n"
-            "pub const dev = .core;\n"
-            "pub const value_interpret_mode = .direct;\n"
+            "pub const force_gpa = false;\n"
+            "pub const only_c = false;\n"
+            "pub const only_core_functionality = true;\n"
         , zig_version);
         if (written < 100)
             panic("unable to write to config.zig file");
@@ -159,9 +157,9 @@ int main(int argc, char **argv) {
             "-target", host_triple,
             "--dep", "build_options",
             "--dep", "aro",
-            "-Mroot=src/main.zig",
-            "-Mbuild_options=config.zig",
-            "-Maro=lib/compiler/aro/aro.zig",
+            "--mod", "root", "src/main.zig",
+            "--mod", "build_options", "config.zig",
+            "--mod", "aro", "lib/compiler/aro/aro.zig",
             NULL,
         };
         print_and_run(child_argv);
@@ -173,7 +171,9 @@ int main(int argc, char **argv) {
             "-ofmt=c", "-OReleaseSmall",
             "--name", "compiler_rt", "-femit-bin=compiler_rt.c",
             "-target", host_triple,
-            "-Mroot=lib/compiler_rt.zig",
+            "--dep", "build_options",
+            "--mod", "root", "lib/compiler_rt.zig",
+            "--mod", "build_options", "config.zig",
             NULL,
         };
         print_and_run(child_argv);

build.zig.zon

@@ -1,7 +1,7 @@
 // The Zig compiler is not intended to be consumed as a package.
 // The sole purpose of this manifest file is to test the compiler.
 .{
-    .name = .zig,
+    .name = "zig",
     .version = "0.0.0",
     .dependencies = .{
         .standalone_test_cases = .{
@@ -12,5 +12,4 @@
         },
     },
     .paths = .{""},
-    .fingerprint = 0xc1ce108124179e16,
 }

ci/aarch64-linux-debug.sh

@@ -8,29 +8,30 @@ set -e
 ARCH="$(uname -m)"
 TARGET="$ARCH-linux-musl"
 MCPU="baseline"
-CACHE_BASENAME="zig+llvm+lld+clang-$TARGET-0.15.0-dev.233+7c85dc460"
+CACHE_BASENAME="zig+llvm+lld+clang-$TARGET-0.12.0-dev.203+d3bc1cfc4"
 PREFIX="$HOME/deps/$CACHE_BASENAME"
 ZIG="$PREFIX/bin/zig"
 
-export PATH="$HOME/local/bin:$PATH"
+export PATH="$HOME/deps/wasmtime-v10.0.2-$ARCH-linux:$PATH"
 
 # Make the `zig version` number consistent.
 # This will affect the cmake command below.
 git fetch --unshallow || true
 git fetch --tags
 
+export CC="$ZIG cc -target $TARGET -mcpu=$MCPU"
+export CXX="$ZIG c++ -target $TARGET -mcpu=$MCPU"
+
+rm -rf build-debug
+mkdir build-debug
+cd build-debug
+
 # Override the cache directories because they won't actually help other CI runs
 # which will be testing alternate versions of zig, and ultimately would just
 # fill up space on the hard drive for no reason.
 export ZIG_GLOBAL_CACHE_DIR="$PWD/zig-global-cache"
 export ZIG_LOCAL_CACHE_DIR="$PWD/zig-local-cache"
 
-mkdir build-debug
-cd build-debug
-
-export CC="$ZIG cc -target $TARGET -mcpu=$MCPU"
-export CXX="$ZIG c++ -target $TARGET -mcpu=$MCPU"
-
 cmake .. \
   -DCMAKE_INSTALL_PREFIX="stage3-debug" \
   -DCMAKE_PREFIX_PATH="$PREFIX" \
@@ -48,22 +49,61 @@ unset CXX
 
 ninja install
 
-# No -fqemu and -fwasmtime here as they're covered by the x86_64-linux scripts.
+# TODO: move this to a build.zig step (check-fmt)
+echo "Looking for non-conforming code formatting..."
+stage3-debug/bin/zig fmt --check .. \
+  --exclude ../test/cases/ \
+  --exclude ../build-debug
+
+# simultaneously test building self-hosted without LLVM and with 32-bit arm
+stage3-debug/bin/zig build \
+  -Dtarget=arm-linux-musleabihf \
+  -Dno-lib
+
+# TODO: add -fqemu back to this line
 stage3-debug/bin/zig build test docs \
-  --maxrss 44918199637 \
+  --maxrss 24696061952 \
+  -fwasmtime \
   -Dstatic-llvm \
-  -Dskip-non-native \
   -Dtarget=native-native-musl \
   --search-prefix "$PREFIX" \
-  --zig-lib-dir "$PWD/../lib" \
-  -Denable-superhtml
+  --zig-lib-dir "$PWD/../lib"
 
-stage3-debug/bin/zig build \
-  --prefix stage4-debug \
-  -Denable-llvm \
+# Look for HTML errors.
+# TODO: move this to a build.zig flag (-Denable-tidy)
+tidy --drop-empty-elements no -qe "../zig-out/doc/langref.html"
+
+# Ensure that updating the wasm binary from this commit will result in a viable build.
+stage3-debug/bin/zig build update-zig1
+
+rm -rf ../build-new
+mkdir ../build-new
+cd ../build-new
+
+export ZIG_GLOBAL_CACHE_DIR="$PWD/zig-global-cache"
+export ZIG_LOCAL_CACHE_DIR="$PWD/zig-local-cache"
+export CC="$ZIG cc -target $TARGET -mcpu=$MCPU"
+export CXX="$ZIG c++ -target $TARGET -mcpu=$MCPU"
+
+cmake .. \
+  -DCMAKE_PREFIX_PATH="$PREFIX" \
+  -DCMAKE_BUILD_TYPE=Debug \
+  -DZIG_TARGET_TRIPLE="$TARGET" \
+  -DZIG_TARGET_MCPU="$MCPU" \
+  -DZIG_STATIC=ON \
+  -DZIG_NO_LIB=ON \
+  -GNinja
+
+unset CC
+unset CXX
+
+ninja install
+
+stage3/bin/zig test ../test/behavior.zig
+stage3/bin/zig build -p stage4 \
+  -Dstatic-llvm \
+  -Dtarget=native-native-musl \
   -Dno-lib \
-  -Dtarget=$TARGET \
-  -Duse-zig-libcxx \
-  -Dversion-string="$(stage3-debug/bin/zig version)"
-
-stage4-debug/bin/zig test ../test/behavior.zig
+  --search-prefix "$PREFIX" \
+  --zig-lib-dir "$PWD/../lib"
+stage4/bin/zig test ../test/behavior.zig

ci/aarch64-linux-release.sh

@@ -8,29 +8,30 @@ set -e
 ARCH="$(uname -m)"
 TARGET="$ARCH-linux-musl"
 MCPU="baseline"
-CACHE_BASENAME="zig+llvm+lld+clang-$TARGET-0.15.0-dev.233+7c85dc460"
+CACHE_BASENAME="zig+llvm+lld+clang-$TARGET-0.12.0-dev.203+d3bc1cfc4"
 PREFIX="$HOME/deps/$CACHE_BASENAME"
 ZIG="$PREFIX/bin/zig"
 
-export PATH="$HOME/local/bin:$PATH"
+export PATH="$HOME/deps/wasmtime-v10.0.2-$ARCH-linux:$PATH"
 
 # Make the `zig version` number consistent.
 # This will affect the cmake command below.
 git fetch --unshallow || true
 git fetch --tags
 
+export CC="$ZIG cc -target $TARGET -mcpu=$MCPU"
+export CXX="$ZIG c++ -target $TARGET -mcpu=$MCPU"
+
+rm -rf build-release
+mkdir build-release
+cd build-release
+
 # Override the cache directories because they won't actually help other CI runs
 # which will be testing alternate versions of zig, and ultimately would just
 # fill up space on the hard drive for no reason.
 export ZIG_GLOBAL_CACHE_DIR="$PWD/zig-global-cache"
 export ZIG_LOCAL_CACHE_DIR="$PWD/zig-local-cache"
 
-mkdir build-release
-cd build-release
-
-export CC="$ZIG cc -target $TARGET -mcpu=$MCPU"
-export CXX="$ZIG c++ -target $TARGET -mcpu=$MCPU"
-
 cmake .. \
   -DCMAKE_INSTALL_PREFIX="stage3-release" \
   -DCMAKE_PREFIX_PATH="$PREFIX" \
@@ -48,28 +49,61 @@ unset CXX
 
 ninja install
 
-# No -fqemu and -fwasmtime here as they're covered by the x86_64-linux scripts.
+# TODO: move this to a build.zig step (check-fmt)
+echo "Looking for non-conforming code formatting..."
+stage3-release/bin/zig fmt --check .. \
+  --exclude ../test/cases/ \
+  --exclude ../build-release
+
+# simultaneously test building self-hosted without LLVM and with 32-bit arm
+stage3-release/bin/zig build \
+  -Dtarget=arm-linux-musleabihf \
+  -Dno-lib
+
+# TODO: add -fqemu back to this line
 stage3-release/bin/zig build test docs \
-  --maxrss 44918199637 \
+  --maxrss 24696061952 \
+  -fwasmtime \
   -Dstatic-llvm \
-  -Dskip-non-native \
   -Dtarget=native-native-musl \
   --search-prefix "$PREFIX" \
-  --zig-lib-dir "$PWD/../lib" \
-  -Denable-superhtml
+  --zig-lib-dir "$PWD/../lib"
 
-# Ensure that stage3 and stage4 are byte-for-byte identical.
-stage3-release/bin/zig build \
-  --prefix stage4-release \
-  -Denable-llvm \
+# Look for HTML errors.
+# TODO: move this to a build.zig flag (-Denable-tidy)
+tidy --drop-empty-elements no -qe "../zig-out/doc/langref.html"
+
+# Ensure that updating the wasm binary from this commit will result in a viable build.
+stage3-release/bin/zig build update-zig1
+
+rm -rf ../build-new
+mkdir ../build-new
+cd ../build-new
+
+export ZIG_GLOBAL_CACHE_DIR="$PWD/zig-global-cache"
+export ZIG_LOCAL_CACHE_DIR="$PWD/zig-local-cache"
+export CC="$ZIG cc -target $TARGET -mcpu=$MCPU"
+export CXX="$ZIG c++ -target $TARGET -mcpu=$MCPU"
+
+cmake .. \
+  -DCMAKE_PREFIX_PATH="$PREFIX" \
+  -DCMAKE_BUILD_TYPE=Release \
+  -DZIG_TARGET_TRIPLE="$TARGET" \
+  -DZIG_TARGET_MCPU="$MCPU" \
+  -DZIG_STATIC=ON \
+  -DZIG_NO_LIB=ON \
+  -GNinja
+
+unset CC
+unset CXX
+
+ninja install
+
+stage3/bin/zig test ../test/behavior.zig
+stage3/bin/zig build -p stage4 \
+  -Dstatic-llvm \
+  -Dtarget=native-native-musl \
   -Dno-lib \
-  -Doptimize=ReleaseFast \
-  -Dstrip \
-  -Dtarget=$TARGET \
-  -Duse-zig-libcxx \
-  -Dversion-string="$(stage3-release/bin/zig version)"
-
-# diff returns an error code if the files differ.
-echo "If the following command fails, it means nondeterminism has been"
-echo "introduced, making stage3 and stage4 no longer byte-for-byte identical."
-diff stage3-release/bin/zig stage4-release/bin/zig
+  --search-prefix "$PREFIX" \
+  --zig-lib-dir "$PWD/../lib"
+stage4/bin/zig test ../test/behavior.zig

ci/aarch64-macos-debug.sh

@@ -9,16 +9,10 @@ set -e
 ZIGDIR="$PWD"
 TARGET="$ARCH-macos-none"
 MCPU="baseline"
-CACHE_BASENAME="zig+llvm+lld+clang-$TARGET-0.15.0-dev.233+7c85dc460"
+CACHE_BASENAME="zig+llvm+lld+clang-$TARGET-0.12.0-dev.467+0345d7866"
 PREFIX="$HOME/$CACHE_BASENAME"
 ZIG="$PREFIX/bin/zig"
 
-if [ ! -d "$PREFIX" ]; then
-  cd $HOME
-  curl -L -O "https://ziglang.org/deps/$CACHE_BASENAME.tar.xz"
-  tar xf "$CACHE_BASENAME.tar.xz"
-fi
-
 cd $ZIGDIR
 
 # Make the `zig version` number consistent.
@@ -26,15 +20,15 @@ cd $ZIGDIR
 git fetch --unshallow || true
 git fetch --tags
 
+mkdir build
+cd build
+
 # Override the cache directories because they won't actually help other CI runs
 # which will be testing alternate versions of zig, and ultimately would just
 # fill up space on the hard drive for no reason.
 export ZIG_GLOBAL_CACHE_DIR="$PWD/zig-global-cache"
 export ZIG_LOCAL_CACHE_DIR="$PWD/zig-local-cache"
 
-mkdir build-debug
-cd build-debug
-
 PATH="$HOME/local/bin:$PATH" cmake .. \
   -DCMAKE_INSTALL_PREFIX="stage3-debug" \
   -DCMAKE_PREFIX_PATH="$PREFIX" \

ci/aarch64-macos-release.sh

@@ -9,16 +9,10 @@ set -e
 ZIGDIR="$PWD"
 TARGET="$ARCH-macos-none"
 MCPU="baseline"
-CACHE_BASENAME="zig+llvm+lld+clang-$TARGET-0.15.0-dev.233+7c85dc460"
+CACHE_BASENAME="zig+llvm+lld+clang-$TARGET-0.12.0-dev.467+0345d7866"
 PREFIX="$HOME/$CACHE_BASENAME"
 ZIG="$PREFIX/bin/zig"
 
-if [ ! -d "$PREFIX" ]; then
-  cd $HOME
-  curl -L -O "https://ziglang.org/deps/$CACHE_BASENAME.tar.xz"
-  tar xf "$CACHE_BASENAME.tar.xz"
-fi
-
 cd $ZIGDIR
 
 # Make the `zig version` number consistent.
@@ -26,15 +20,15 @@ cd $ZIGDIR
 git fetch --unshallow || true
 git fetch --tags
 
+mkdir build
+cd build
+
 # Override the cache directories because they won't actually help other CI runs
 # which will be testing alternate versions of zig, and ultimately would just
 # fill up space on the hard drive for no reason.
 export ZIG_GLOBAL_CACHE_DIR="$PWD/zig-global-cache"
 export ZIG_LOCAL_CACHE_DIR="$PWD/zig-local-cache"
 
-mkdir build-release
-cd build-release
-
 PATH="$HOME/local/bin:$PATH" cmake .. \
   -DCMAKE_INSTALL_PREFIX="stage3-release" \
   -DCMAKE_PREFIX_PATH="$PREFIX" \

ci/aarch64-windows.ps1

@@ -1,5 +1,5 @@
 $TARGET = "$($Env:ARCH)-windows-gnu"
-$ZIG_LLVM_CLANG_LLD_NAME = "zig+llvm+lld+clang-$TARGET-0.15.0-dev.233+7c85dc460"
+$ZIG_LLVM_CLANG_LLD_NAME = "zig+llvm+lld+clang-$TARGET-0.12.0-dev.2087+e9a18010b"
 $MCPU = "baseline"
 $ZIG_LLVM_CLANG_LLD_URL = "https://ziglang.org/deps/$ZIG_LLVM_CLANG_LLD_NAME.zip"
 $PREFIX_PATH = "$(Get-Location)\..\$ZIG_LLVM_CLANG_LLD_NAME"
@@ -30,16 +30,17 @@ if ((git rev-parse --is-shallow-repository) -eq "true") {
     git fetch --unshallow # `git describe` won't work on a shallow repo
 }
 
+Write-Output "Building from source..."
+Remove-Item -Path 'build-release' -Recurse -Force -ErrorAction Ignore
+New-Item -Path 'build-release' -ItemType Directory
+Set-Location -Path 'build-release'
+
 # Override the cache directories because they won't actually help other CI runs
 # which will be testing alternate versions of zig, and ultimately would just
 # fill up space on the hard drive for no reason.
 $Env:ZIG_GLOBAL_CACHE_DIR="$(Get-Location)\zig-global-cache"
 $Env:ZIG_LOCAL_CACHE_DIR="$(Get-Location)\zig-local-cache"
 
-Write-Output "Building from source..."
-New-Item -Path 'build-release' -ItemType Directory
-Set-Location -Path 'build-release'
-
 # CMake gives a syntax error when file paths with backward slashes are used.
 # Here, we use forward slashes only to work around this.
 & cmake .. `
@@ -68,22 +69,3 @@ Write-Output "Main test suite..."
   -Dskip-non-native `
   -Denable-symlinks-windows
 CheckLastExitCode
-
-# Ensure that stage3 and stage4 are byte-for-byte identical.
-Write-Output "Build and compare stage4..."
-& "stage3-release\bin\zig.exe" build `
-  --prefix stage4-release `
-  -Denable-llvm `
-  -Dno-lib `
-  -Doptimize=ReleaseFast `
-  -Dstrip `
-  -Dtarget="$TARGET" `
-  -Duse-zig-libcxx `
-  -Dversion-string="$(stage3-release\bin\zig version)"
-CheckLastExitCode
-
-# Compare-Object returns an error code if the files differ.
-Write-Output "If the following command fails, it means nondeterminism has been"
-Write-Output "introduced, making stage3 and stage4 no longer byte-for-byte identical."
-Compare-Object (Get-Content stage3-release\bin\zig.exe) (Get-Content stage4-release\bin\zig.exe)
-CheckLastExitCode

ci/riscv64-linux-debug.sh

@@ -1,62 +0,0 @@
-#!/bin/sh
-
-# Requires cmake ninja-build
-
-set -x
-set -e
-
-ARCH="$(uname -m)"
-TARGET="$ARCH-linux-musl"
-MCPU="spacemit_x60"
-CACHE_BASENAME="zig+llvm+lld+clang-riscv64-linux-musl-0.15.0-dev.929+31e46be74"
-PREFIX="$HOME/deps/$CACHE_BASENAME"
-ZIG="$PREFIX/bin/zig"
-
-export PATH="$HOME/local/bin:$PATH"
-
-# Make the `zig version` number consistent.
-# This will affect the cmake command below.
-git fetch --unshallow || true
-git fetch --tags
-
-# Override the cache directories because they won't actually help other CI runs
-# which will be testing alternate versions of zig, and ultimately would just
-# fill up space on the hard drive for no reason.
-export ZIG_GLOBAL_CACHE_DIR="$PWD/zig-global-cache"
-export ZIG_LOCAL_CACHE_DIR="$PWD/zig-local-cache"
-
-mkdir build-debug
-cd build-debug
-
-export CC="$ZIG cc -target $TARGET -mcpu=$MCPU"
-export CXX="$ZIG c++ -target $TARGET -mcpu=$MCPU"
-
-cmake .. \
-  -DCMAKE_INSTALL_PREFIX="stage3-debug" \
-  -DCMAKE_PREFIX_PATH="$PREFIX" \
-  -DCMAKE_BUILD_TYPE=Debug \
-  -DZIG_TARGET_TRIPLE="$TARGET" \
-  -DZIG_TARGET_MCPU="$MCPU" \
-  -DZIG_STATIC=ON \
-  -DZIG_NO_LIB=ON \
-  -GNinja
-
-# Now cmake will use zig as the C/C++ compiler. We reset the environment variables
-# so that installation and testing do not get affected by them.
-unset CC
-unset CXX
-
-ninja install
-
-# No -fqemu and -fwasmtime here as they're covered by the x86_64-linux scripts.
-stage3-debug/bin/zig build test-cases test-modules test-unit test-c-abi test-stack-traces test-asm-link test-llvm-ir \
-  --maxrss 68719476736 \
-  -Dstatic-llvm \
-  -Dskip-non-native \
-  -Dskip-single-threaded \
-  -Dskip-compile-errors \
-  -Dskip-translate-c \
-  -Dskip-run-translated-c \
-  -Dtarget=native-native-musl \
-  --search-prefix "$PREFIX" \
-  --zig-lib-dir "$PWD/../lib"

ci/riscv64-linux-release.sh

@@ -1,62 +0,0 @@
-#!/bin/sh
-
-# Requires cmake ninja-build
-
-set -x
-set -e
-
-ARCH="$(uname -m)"
-TARGET="$ARCH-linux-musl"
-MCPU="spacemit_x60"
-CACHE_BASENAME="zig+llvm+lld+clang-riscv64-linux-musl-0.15.0-dev.929+31e46be74"
-PREFIX="$HOME/deps/$CACHE_BASENAME"
-ZIG="$PREFIX/bin/zig"
-
-export PATH="$HOME/local/bin:$PATH"
-
-# Make the `zig version` number consistent.
-# This will affect the cmake command below.
-git fetch --unshallow || true
-git fetch --tags
-
-# Override the cache directories because they won't actually help other CI runs
-# which will be testing alternate versions of zig, and ultimately would just
-# fill up space on the hard drive for no reason.
-export ZIG_GLOBAL_CACHE_DIR="$PWD/zig-global-cache"
-export ZIG_LOCAL_CACHE_DIR="$PWD/zig-local-cache"
-
-mkdir build-release
-cd build-release
-
-export CC="$ZIG cc -target $TARGET -mcpu=$MCPU"
-export CXX="$ZIG c++ -target $TARGET -mcpu=$MCPU"
-
-cmake .. \
-  -DCMAKE_INSTALL_PREFIX="stage3-release" \
-  -DCMAKE_PREFIX_PATH="$PREFIX" \
-  -DCMAKE_BUILD_TYPE=Release \
-  -DZIG_TARGET_TRIPLE="$TARGET" \
-  -DZIG_TARGET_MCPU="$MCPU" \
-  -DZIG_STATIC=ON \
-  -DZIG_NO_LIB=ON \
-  -GNinja
-
-# Now cmake will use zig as the C/C++ compiler. We reset the environment variables
-# so that installation and testing do not get affected by them.
-unset CC
-unset CXX
-
-ninja install
-
-# No -fqemu and -fwasmtime here as they're covered by the x86_64-linux scripts.
-stage3-release/bin/zig build test-cases test-modules test-unit test-c-abi test-stack-traces test-asm-link test-llvm-ir \
-  --maxrss 68719476736 \
-  -Dstatic-llvm \
-  -Dskip-non-native \
-  -Dskip-single-threaded \
-  -Dskip-compile-errors \
-  -Dskip-translate-c \
-  -Dskip-run-translated-c \
-  -Dtarget=native-native-musl \
-  --search-prefix "$PREFIX" \
-  --zig-lib-dir "$PWD/../lib"

ci/x86_64-linux-debug-llvm.sh

@@ -1,70 +0,0 @@
-#!/bin/sh
-
-# Requires cmake ninja-build
-
-set -x
-set -e
-
-ARCH="$(uname -m)"
-TARGET="$ARCH-linux-musl"
-MCPU="baseline"
-CACHE_BASENAME="zig+llvm+lld+clang-$TARGET-0.15.0-dev.233+7c85dc460"
-PREFIX="$HOME/deps/$CACHE_BASENAME"
-ZIG="$PREFIX/bin/zig"
-
-export PATH="$HOME/deps/wasmtime-v29.0.0-$ARCH-linux:$HOME/deps/qemu-linux-x86_64-10.0.2/bin:$HOME/local/bin:$PATH"
-
-# Make the `zig version` number consistent.
-# This will affect the cmake command below.
-git fetch --unshallow || true
-git fetch --tags
-
-# Override the cache directories because they won't actually help other CI runs
-# which will be testing alternate versions of zig, and ultimately would just
-# fill up space on the hard drive for no reason.
-export ZIG_GLOBAL_CACHE_DIR="$PWD/zig-global-cache"
-export ZIG_LOCAL_CACHE_DIR="$PWD/zig-local-cache"
-
-mkdir build-debug-llvm
-cd build-debug-llvm
-
-export CC="$ZIG cc -target $TARGET -mcpu=$MCPU"
-export CXX="$ZIG c++ -target $TARGET -mcpu=$MCPU"
-
-cmake .. \
-  -DCMAKE_INSTALL_PREFIX="stage3-debug" \
-  -DCMAKE_PREFIX_PATH="$PREFIX" \
-  -DCMAKE_BUILD_TYPE=Debug \
-  -DZIG_TARGET_TRIPLE="$TARGET" \
-  -DZIG_TARGET_MCPU="$MCPU" \
-  -DZIG_STATIC=ON \
-  -DZIG_NO_LIB=ON \
-  -DZIG_EXTRA_BUILD_ARGS="-Duse-llvm=true" \
-  -GNinja
-
-# Now cmake will use zig as the C/C++ compiler. We reset the environment variables
-# so that installation and testing do not get affected by them.
-unset CC
-unset CXX
-
-ninja install
-
-# simultaneously test building self-hosted without LLVM and with 32-bit arm
-stage3-debug/bin/zig build \
-  -Dtarget=arm-linux-musleabihf \
-  -Dno-lib
-
-stage3-debug/bin/zig build test docs \
-  --maxrss 21000000000 \
-  -Dlldb=$HOME/deps/lldb-zig/Debug-e0a42bb34/bin/lldb \
-  -fqemu \
-  -fwasmtime \
-  -Dstatic-llvm \
-  -Dskip-freebsd \
-  -Dskip-netbsd \
-  -Dskip-windows \
-  -Dskip-macos \
-  -Dtarget=native-native-musl \
-  --search-prefix "$PREFIX" \
-  --zig-lib-dir "$PWD/../lib" \
-  -Denable-superhtml

ci/x86_64-linux-debug.sh

@@ -8,29 +8,38 @@ set -e
 ARCH="$(uname -m)"
 TARGET="$ARCH-linux-musl"
 MCPU="baseline"
-CACHE_BASENAME="zig+llvm+lld+clang-$TARGET-0.15.0-dev.233+7c85dc460"
+CACHE_BASENAME="zig+llvm+lld+clang-$TARGET-0.12.0-dev.203+d3bc1cfc4"
 PREFIX="$HOME/deps/$CACHE_BASENAME"
 ZIG="$PREFIX/bin/zig"
 
-export PATH="$HOME/deps/wasmtime-v29.0.0-$ARCH-linux:$HOME/deps/qemu-linux-x86_64-10.0.2/bin:$HOME/local/bin:$PATH"
+export PATH="$HOME/deps/wasmtime-v10.0.2-$ARCH-linux:$HOME/deps/qemu-linux-x86_64-8.2.1/bin:$PATH"
 
 # Make the `zig version` number consistent.
 # This will affect the cmake command below.
 git fetch --unshallow || true
 git fetch --tags
 
+# Test building from source without LLVM.
+git clean -fd
+rm -rf zig-out
+cc -o bootstrap bootstrap.c
+./bootstrap
+./zig2 build -Dno-lib
+./zig-out/bin/zig test test/behavior.zig
+
+export CC="$ZIG cc -target $TARGET -mcpu=$MCPU"
+export CXX="$ZIG c++ -target $TARGET -mcpu=$MCPU"
+
+rm -rf build-debug
+mkdir build-debug
+cd build-debug
+
 # Override the cache directories because they won't actually help other CI runs
 # which will be testing alternate versions of zig, and ultimately would just
 # fill up space on the hard drive for no reason.
 export ZIG_GLOBAL_CACHE_DIR="$PWD/zig-global-cache"
 export ZIG_LOCAL_CACHE_DIR="$PWD/zig-local-cache"
 
-mkdir build-debug
-cd build-debug
-
-export CC="$ZIG cc -target $TARGET -mcpu=$MCPU"
-export CXX="$ZIG c++ -target $TARGET -mcpu=$MCPU"
-
 cmake .. \
   -DCMAKE_INSTALL_PREFIX="stage3-debug" \
   -DCMAKE_PREFIX_PATH="$PREFIX" \
@@ -48,6 +57,12 @@ unset CXX
 
 ninja install
 
+# TODO: move this to a build.zig step (check-fmt)
+echo "Looking for non-conforming code formatting..."
+stage3-debug/bin/zig fmt --check .. \
+  --exclude ../test/cases/ \
+  --exclude ../build-debug
+
 # simultaneously test building self-hosted without LLVM and with 32-bit arm
 stage3-debug/bin/zig build \
   -Dtarget=arm-linux-musleabihf \
@@ -55,16 +70,48 @@ stage3-debug/bin/zig build \
 
 stage3-debug/bin/zig build test docs \
   --maxrss 21000000000 \
-  -Dlldb=$HOME/deps/lldb-zig/Debug-e0a42bb34/bin/lldb \
   -fqemu \
   -fwasmtime \
   -Dstatic-llvm \
-  -Dskip-freebsd \
-  -Dskip-netbsd \
-  -Dskip-windows \
-  -Dskip-macos \
-  -Dskip-llvm \
   -Dtarget=native-native-musl \
   --search-prefix "$PREFIX" \
-  --zig-lib-dir "$PWD/../lib" \
-  -Denable-superhtml
+  --zig-lib-dir "$PWD/../lib"
+
+# Look for HTML errors.
+# TODO: move this to a build.zig flag (-Denable-tidy)
+tidy --drop-empty-elements no -qe "../zig-out/doc/langref.html"
+
+# Ensure that updating the wasm binary from this commit will result in a viable build.
+stage3-debug/bin/zig build update-zig1
+
+rm -rf ../build-new
+mkdir ../build-new
+cd ../build-new
+
+export ZIG_GLOBAL_CACHE_DIR="$PWD/zig-global-cache"
+export ZIG_LOCAL_CACHE_DIR="$PWD/zig-local-cache"
+export CC="$ZIG cc -target $TARGET -mcpu=$MCPU"
+export CXX="$ZIG c++ -target $TARGET -mcpu=$MCPU"
+
+cmake .. \
+  -DCMAKE_PREFIX_PATH="$PREFIX" \
+  -DCMAKE_BUILD_TYPE=Debug \
+  -DZIG_TARGET_TRIPLE="$TARGET" \
+  -DZIG_TARGET_MCPU="$MCPU" \
+  -DZIG_STATIC=ON \
+  -DZIG_NO_LIB=ON \
+  -GNinja
+
+unset CC
+unset CXX
+
+ninja install
+
+stage3/bin/zig test ../test/behavior.zig
+stage3/bin/zig build -p stage4 \
+  -Dstatic-llvm \
+  -Dtarget=native-native-musl \
+  -Dno-lib \
+  --search-prefix "$PREFIX" \
+  --zig-lib-dir "$PWD/../lib"
+stage4/bin/zig test ../test/behavior.zig

ci/x86_64-linux-release.sh

@@ -8,34 +8,37 @@ set -e
 ARCH="$(uname -m)"
 TARGET="$ARCH-linux-musl"
 MCPU="baseline"
-CACHE_BASENAME="zig+llvm+lld+clang-$TARGET-0.15.0-dev.233+7c85dc460"
+CACHE_BASENAME="zig+llvm+lld+clang-$TARGET-0.12.0-dev.203+d3bc1cfc4"
 PREFIX="$HOME/deps/$CACHE_BASENAME"
 ZIG="$PREFIX/bin/zig"
 
-export PATH="$HOME/deps/wasmtime-v29.0.0-$ARCH-linux:$HOME/deps/qemu-linux-x86_64-10.0.2/bin:$HOME/local/bin:$PATH"
+export PATH="$HOME/deps/wasmtime-v10.0.2-$ARCH-linux:$HOME/deps/qemu-linux-x86_64-8.2.1/bin:$PATH"
 
 # Make the `zig version` number consistent.
 # This will affect the cmake command below.
 git fetch --unshallow || true
 git fetch --tags
 
-# Override the cache directories because they won't actually help other CI runs
-# which will be testing alternate versions of zig, and ultimately would just
-# fill up space on the hard drive for no reason.
-export ZIG_GLOBAL_CACHE_DIR="$PWD/zig-global-cache"
-export ZIG_LOCAL_CACHE_DIR="$PWD/zig-local-cache"
-
 # Test building from source without LLVM.
+git clean -fd
+rm -rf zig-out
 cc -o bootstrap bootstrap.c
 ./bootstrap
 ./zig2 build -Dno-lib
 ./zig-out/bin/zig test test/behavior.zig
 
+export CC="$ZIG cc -target $TARGET -mcpu=$MCPU"
+export CXX="$ZIG c++ -target $TARGET -mcpu=$MCPU"
+
+rm -rf build-release
 mkdir build-release
 cd build-release
 
-export CC="$ZIG cc -target $TARGET -mcpu=$MCPU"
-export CXX="$ZIG c++ -target $TARGET -mcpu=$MCPU"
+# Override the cache directories because they won't actually help other CI runs
+# which will be testing alternate versions of zig, and ultimately would just
+# fill up space on the hard drive for no reason.
+export ZIG_GLOBAL_CACHE_DIR="$PWD/zig-global-cache"
+export ZIG_LOCAL_CACHE_DIR="$PWD/zig-local-cache"
 
 cmake .. \
   -DCMAKE_INSTALL_PREFIX="stage3-release" \
@@ -54,6 +57,13 @@ unset CXX
 
 ninja install
 
+# TODO: move this to a build.zig step (check-fmt)
+echo "Looking for non-conforming code formatting..."
+stage3-release/bin/zig fmt --check .. \
+  --exclude ../test/cases/ \
+  --exclude ../build-debug \
+  --exclude ../build-release
+
 # simultaneously test building self-hosted without LLVM and with 32-bit arm
 stage3-release/bin/zig build \
   -Dtarget=arm-linux-musleabihf \
@@ -61,14 +71,16 @@ stage3-release/bin/zig build \
 
 stage3-release/bin/zig build test docs \
   --maxrss 21000000000 \
-  -Dlldb=$HOME/deps/lldb-zig/Release-e0a42bb34/bin/lldb \
   -fqemu \
   -fwasmtime \
   -Dstatic-llvm \
   -Dtarget=native-native-musl \
   --search-prefix "$PREFIX" \
-  --zig-lib-dir "$PWD/../lib" \
-  -Denable-superhtml
+  --zig-lib-dir "$PWD/../lib"
+
+# Look for HTML errors.
+# TODO: move this to a build.zig flag (-Denable-tidy)
+tidy --drop-empty-elements no -qe "../zig-out/doc/langref.html"
 
 # Ensure that stage3 and stage4 are byte-for-byte identical.
 stage3-release/bin/zig build \
@@ -89,9 +101,12 @@ diff stage3-release/bin/zig stage4-release/bin/zig
 # Ensure that updating the wasm binary from this commit will result in a viable build.
 stage3-release/bin/zig build update-zig1
 
+rm -rf ../build-new
 mkdir ../build-new
 cd ../build-new
 
+export ZIG_GLOBAL_CACHE_DIR="$PWD/zig-global-cache"
+export ZIG_LOCAL_CACHE_DIR="$PWD/zig-local-cache"
 export CC="$ZIG cc -target $TARGET -mcpu=$MCPU"
 export CXX="$ZIG c++ -target $TARGET -mcpu=$MCPU"
 

ci/x86_64-macos-release.sh

@@ -6,16 +6,17 @@ set -e
 ZIGDIR="$PWD"
 TARGET="$ARCH-macos-none"
 MCPU="baseline"
-CACHE_BASENAME="zig+llvm+lld+clang-$TARGET-0.15.0-dev.233+7c85dc460"
+CACHE_BASENAME="zig+llvm+lld+clang-$TARGET-0.12.0-dev.467+0345d7866"
 PREFIX="$HOME/$CACHE_BASENAME"
 JOBS="-j3"
-ZIG="$PREFIX/bin/zig"
 
-if [ ! -d "$PREFIX" ]; then
-  cd $HOME
-  curl -L -O "https://ziglang.org/deps/$CACHE_BASENAME.tar.xz"
-  tar xf "$CACHE_BASENAME.tar.xz"
-fi
+rm -rf $PREFIX
+cd $HOME
+
+curl -L -O "https://ziglang.org/deps/$CACHE_BASENAME.tar.xz"
+tar xf "$CACHE_BASENAME.tar.xz"
+
+ZIG="$PREFIX/bin/zig"
 
 cd $ZIGDIR
 
@@ -24,21 +25,24 @@ cd $ZIGDIR
 git fetch --unshallow || true
 git fetch --tags
 
-# Override the cache directories because they won't actually help other CI runs
-# which will be testing alternate versions of zig, and ultimately would just
-# fill up space on the hard drive for no reason.
-export ZIG_GLOBAL_CACHE_DIR="$PWD/zig-global-cache"
-export ZIG_LOCAL_CACHE_DIR="$PWD/zig-local-cache"
-
 # Test building from source without LLVM.
+git clean -fd
+rm -rf zig-out
 cc -o bootstrap bootstrap.c
 ./bootstrap
 ./zig2 build -Dno-lib
 ./zig-out/bin/zig test test/behavior.zig
 
+rm -rf build
 mkdir build
 cd build
 
+# Override the cache directories because they won't actually help other CI runs
+# which will be testing alternate versions of zig, and ultimately would just
+# fill up space on the hard drive for no reason.
+export ZIG_GLOBAL_CACHE_DIR="$PWD/zig-global-cache"
+export ZIG_LOCAL_CACHE_DIR="$PWD/zig-local-cache"
+
 cmake .. \
   -DCMAKE_PREFIX_PATH="$PREFIX" \
   -DCMAKE_BUILD_TYPE=Release \

ci/x86_64-windows-debug.ps1

@@ -1,20 +1,10 @@
 $TARGET = "$($Env:ARCH)-windows-gnu"
-$ZIG_LLVM_CLANG_LLD_NAME = "zig+llvm+lld+clang-$TARGET-0.15.0-dev.233+7c85dc460"
+$ZIG_LLVM_CLANG_LLD_NAME = "zig+llvm+lld+clang-$TARGET-0.12.0-dev.2073+402fe565a"
 $MCPU = "baseline"
-$ZIG_LLVM_CLANG_LLD_URL = "https://ziglang.org/deps/$ZIG_LLVM_CLANG_LLD_NAME.zip"
 $PREFIX_PATH = "$($Env:USERPROFILE)\$ZIG_LLVM_CLANG_LLD_NAME"
 $ZIG = "$PREFIX_PATH\bin\zig.exe"
 $ZIG_LIB_DIR = "$(Get-Location)\lib"
 
-if (!(Test-Path "$PREFIX_PATH.zip")) {
-    Write-Output "Downloading $ZIG_LLVM_CLANG_LLD_URL"
-    Invoke-WebRequest -Uri "$ZIG_LLVM_CLANG_LLD_URL" -OutFile "$PREFIX_PATH.zip"
-
-    Write-Output "Extracting..."
-    Add-Type -AssemblyName System.IO.Compression.FileSystem ;
-    [System.IO.Compression.ZipFile]::ExtractToDirectory("$PREFIX_PATH.zip", "$PREFIX_PATH\..")
-}
-
 function CheckLastExitCode {
     if (!$?) {
         exit 1
@@ -30,13 +20,8 @@ if ((git rev-parse --is-shallow-repository) -eq "true") {
     git fetch --unshallow # `git describe` won't work on a shallow repo
 }
 
-# Override the cache directories because they won't actually help other CI runs
-# which will be testing alternate versions of zig, and ultimately would just
-# fill up space on the hard drive for no reason.
-$Env:ZIG_GLOBAL_CACHE_DIR="$(Get-Location)\zig-global-cache"
-$Env:ZIG_LOCAL_CACHE_DIR="$(Get-Location)\zig-local-cache"
-
 Write-Output "Building from source..."
+Remove-Item -Path 'build-debug' -Recurse -Force -ErrorAction Ignore
 New-Item -Path 'build-debug' -ItemType Directory
 Set-Location -Path 'build-debug'
 
@@ -89,8 +74,8 @@ CheckLastExitCode
   -femit-bin="compiler_rt-x86_64-windows-msvc.c" `
   --dep build_options `
   -target x86_64-windows-msvc `
-  -Mroot="..\lib\compiler_rt.zig" `
-  -Mbuild_options="config.zig"
+  --mod root ..\lib\compiler_rt.zig `
+  --mod build_options config.zig
 CheckLastExitCode
 
 Import-Module "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\Common7\Tools\Microsoft.VisualStudio.DevShell.dll"

ci/x86_64-windows-release.ps1

@@ -1,20 +1,10 @@
 $TARGET = "$($Env:ARCH)-windows-gnu"
-$ZIG_LLVM_CLANG_LLD_NAME = "zig+llvm+lld+clang-$TARGET-0.15.0-dev.233+7c85dc460"
+$ZIG_LLVM_CLANG_LLD_NAME = "zig+llvm+lld+clang-$TARGET-0.12.0-dev.2073+402fe565a"
 $MCPU = "baseline"
-$ZIG_LLVM_CLANG_LLD_URL = "https://ziglang.org/deps/$ZIG_LLVM_CLANG_LLD_NAME.zip"
 $PREFIX_PATH = "$($Env:USERPROFILE)\$ZIG_LLVM_CLANG_LLD_NAME"
 $ZIG = "$PREFIX_PATH\bin\zig.exe"
 $ZIG_LIB_DIR = "$(Get-Location)\lib"
 
-if (!(Test-Path "$PREFIX_PATH.zip")) {
-    Write-Output "Downloading $ZIG_LLVM_CLANG_LLD_URL"
-    Invoke-WebRequest -Uri "$ZIG_LLVM_CLANG_LLD_URL" -OutFile "$PREFIX_PATH.zip"
-
-    Write-Output "Extracting..."
-    Add-Type -AssemblyName System.IO.Compression.FileSystem ;
-    [System.IO.Compression.ZipFile]::ExtractToDirectory("$PREFIX_PATH.zip", "$PREFIX_PATH\..")
-}
-
 function CheckLastExitCode {
     if (!$?) {
         exit 1
@@ -30,13 +20,8 @@ if ((git rev-parse --is-shallow-repository) -eq "true") {
     git fetch --unshallow # `git describe` won't work on a shallow repo
 }
 
-# Override the cache directories because they won't actually help other CI runs
-# which will be testing alternate versions of zig, and ultimately would just
-# fill up space on the hard drive for no reason.
-$Env:ZIG_GLOBAL_CACHE_DIR="$(Get-Location)\zig-global-cache"
-$Env:ZIG_LOCAL_CACHE_DIR="$(Get-Location)\zig-local-cache"
-
 Write-Output "Building from source..."
+Remove-Item -Path 'build-release' -Recurse -Force -ErrorAction Ignore
 New-Item -Path 'build-release' -ItemType Directory
 Set-Location -Path 'build-release'
 
@@ -69,25 +54,6 @@ Write-Output "Main test suite..."
   -Denable-symlinks-windows
 CheckLastExitCode
 
-# Ensure that stage3 and stage4 are byte-for-byte identical.
-Write-Output "Build and compare stage4..."
-& "stage3-release\bin\zig.exe" build `
-  --prefix stage4-release `
-  -Denable-llvm `
-  -Dno-lib `
-  -Doptimize=ReleaseFast `
-  -Dstrip `
-  -Dtarget="$TARGET" `
-  -Duse-zig-libcxx `
-  -Dversion-string="$(stage3-release\bin\zig version)"
-CheckLastExitCode
-
-# Compare-Object returns an error code if the files differ.
-Write-Output "If the following command fails, it means nondeterminism has been"
-Write-Output "introduced, making stage3 and stage4 no longer byte-for-byte identical."
-Compare-Object (Get-Content stage3-release\bin\zig.exe) (Get-Content stage4-release\bin\zig.exe)
-CheckLastExitCode
-
 Write-Output "Build x86_64-windows-msvc behavior tests using the C backend..."
 & "stage3-release\bin\zig.exe" test `
   ..\test\behavior.zig `
@@ -107,8 +73,8 @@ CheckLastExitCode
   -femit-bin="compiler_rt-x86_64-windows-msvc.c" `
   --dep build_options `
   -target x86_64-windows-msvc `
-  -Mroot="..\lib\compiler_rt.zig" `
-  -Mbuild_options="config.zig"
+  --mod root ..\lib\compiler_rt.zig `
+  --mod build_options config.zig
 CheckLastExitCode
 
 Import-Module "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\Common7\Tools\Microsoft.VisualStudio.DevShell.dll"

cmake/Findclang.cmake

@@ -17,10 +17,9 @@ find_path(CLANG_INCLUDE_DIRS NAMES clang/Frontend/ASTUnit.h
 if(${LLVM_LINK_MODE} STREQUAL "shared")
   find_library(CLANG_LIBRARIES
     NAMES
-      libclang-cpp.so.20
-      libclang-cpp.so.20.1
-      clang-cpp-20.0
-      clang-cpp200
+      libclang-cpp.so.17
+      clang-cpp-17.0
+      clang-cpp170
       clang-cpp
     NAMES_PER_DIR
     HINTS "${LLVM_LIBDIRS}"
@@ -56,7 +55,6 @@ else()
   FIND_AND_ADD_CLANG_LIB(clangAST)
   FIND_AND_ADD_CLANG_LIB(clangParse)
   FIND_AND_ADD_CLANG_LIB(clangSema)
-  FIND_AND_ADD_CLANG_LIB(clangAPINotes)
   FIND_AND_ADD_CLANG_LIB(clangBasic)
   FIND_AND_ADD_CLANG_LIB(clangEdit)
   FIND_AND_ADD_CLANG_LIB(clangLex)
@@ -68,8 +66,6 @@ else()
   FIND_AND_ADD_CLANG_LIB(clangToolingCore)
   FIND_AND_ADD_CLANG_LIB(clangExtractAPI)
   FIND_AND_ADD_CLANG_LIB(clangSupport)
-  FIND_AND_ADD_CLANG_LIB(clangInstallAPI)
-  FIND_AND_ADD_CLANG_LIB(clangAST)
 endif()
 
 if (MSVC)

cmake/Findlld.cmake

@@ -9,23 +9,21 @@
 find_path(LLD_INCLUDE_DIRS NAMES lld/Common/Driver.h
     HINTS ${LLVM_INCLUDE_DIRS}
     PATHS
-        /usr/lib/llvm-20/include
-        /usr/local/llvm200/include
-        /usr/local/llvm20/include
-        /usr/local/opt/lld@20/include
-        /opt/homebrew/opt/lld@20/include
-        /home/linuxbrew/.linuxbrew/opt/lld@20/include
+        /usr/lib/llvm-17/include
+        /usr/local/llvm170/include
+        /usr/local/llvm17/include
+        /usr/local/opt/llvm@17/include
+        /opt/homebrew/opt/llvm@17/include
         /mingw64/include)
 
-find_library(LLD_LIBRARY NAMES lld-20.0 lld200 lld NAMES_PER_DIR
+find_library(LLD_LIBRARY NAMES lld-17.0 lld170 lld NAMES_PER_DIR
     HINTS ${LLVM_LIBDIRS}
     PATHS
-        /usr/lib/llvm-20/lib
-        /usr/local/llvm200/lib
-        /usr/local/llvm20/lib
-        /usr/local/opt/lld@20/lib
-        /opt/homebrew/opt/lld@20/lib
-        /home/linuxbrew/.linuxbrew/opt/lld@20/lib
+        /usr/lib/llvm-17/lib
+        /usr/local/llvm170/lib
+        /usr/local/llvm17/lib
+        /usr/local/opt/llvm@17/lib
+        /opt/homebrew/opt/llvm@17/lib
 )
 if(EXISTS ${LLD_LIBRARY})
     set(LLD_LIBRARIES ${LLD_LIBRARY})
@@ -36,12 +34,11 @@ else()
             HINTS ${LLVM_LIBDIRS}
             PATHS
                 ${LLD_LIBDIRS}
-                /usr/lib/llvm-20/lib
-                /usr/local/llvm200/lib
-                /usr/local/llvm20/lib
-                /usr/local/opt/lld@20/lib
-                /opt/homebrew/opt/lld@20/lib
-                /home/linuxbrew/.linuxbrew/opt/lld@20/lib
+                /usr/lib/llvm-17/lib
+                /usr/local/llvm170/lib
+                /usr/local/llvm17/lib
+                /usr/local/opt/llvm@17/lib
+                /opt/homebrew/opt/llvm@17/lib
                 /mingw64/lib
                 /c/msys64/mingw64/lib
                 c:/msys64/mingw64/lib)

cmake/Findllvm.cmake

@@ -12,17 +12,14 @@
 if(ZIG_USE_LLVM_CONFIG)
   set(LLVM_CONFIG_ERROR_MESSAGES "")
   while(1)
-    # If this variable is not unset, the same result is returned even though
-    # the ignore list has changed, causing the configure process to not
-    # terminate when the right LLVM version is not found.
     unset(LLVM_CONFIG_EXE CACHE)
     find_program(LLVM_CONFIG_EXE
-        NAMES llvm-config-20 llvm-config-20.0 llvm-config200 llvm-config20 llvm-config NAMES_PER_DIR
+        NAMES llvm-config-17 llvm-config-17.0 llvm-config170 llvm-config17 llvm-config NAMES_PER_DIR
         PATHS
             "/mingw64/bin"
             "/c/msys64/mingw64/bin"
             "c:/msys64/mingw64/bin"
-            "C:/Libraries/llvm-20.0.0/bin")
+            "C:/Libraries/llvm-17.0.0/bin")
 
     if ("${LLVM_CONFIG_EXE}" STREQUAL "LLVM_CONFIG_EXE-NOTFOUND")
       if (NOT LLVM_CONFIG_ERROR_MESSAGES STREQUAL "")
@@ -40,9 +37,9 @@ if(ZIG_USE_LLVM_CONFIG)
       OUTPUT_STRIP_TRAILING_WHITESPACE)
 
     get_filename_component(LLVM_CONFIG_DIR "${LLVM_CONFIG_EXE}" DIRECTORY)
-    if("${LLVM_CONFIG_VERSION}" VERSION_LESS 20 OR "${LLVM_CONFIG_VERSION}" VERSION_EQUAL 21 OR "${LLVM_CONFIG_VERSION}" VERSION_GREATER 21)
+    if("${LLVM_CONFIG_VERSION}" VERSION_LESS 17 OR "${LLVM_CONFIG_VERSION}" VERSION_EQUAL 18 OR "${LLVM_CONFIG_VERSION}" VERSION_GREATER 18)
       # Save the error message, in case this is the last llvm-config we find
-      list(APPEND LLVM_CONFIG_ERROR_MESSAGES "expected LLVM 20.x but found ${LLVM_CONFIG_VERSION} using ${LLVM_CONFIG_EXE}")
+      list(APPEND LLVM_CONFIG_ERROR_MESSAGES "expected LLVM 17.x but found ${LLVM_CONFIG_VERSION} using ${LLVM_CONFIG_EXE}")
 
       # Ignore this directory and try the search again
       list(APPEND CMAKE_IGNORE_PATH "${LLVM_CONFIG_DIR}")
@@ -63,12 +60,12 @@ if(ZIG_USE_LLVM_CONFIG)
         ERROR_VARIABLE LLVM_CONFIG_ERROR
         ERROR_STRIP_TRAILING_WHITESPACE)
 
-      if (LLVM_CONFIG_ERROR)
+      if (LLVM_CONFIG_ERROR) 
         # Save the error message, in case this is the last llvm-config we find
         if (ZIG_SHARED_LLVM)
-          list(APPEND LLVM_CONFIG_ERROR_MESSAGES "LLVM 20.x found at ${LLVM_CONFIG_EXE} does not support linking as a shared library")
+          list(APPEND LLVM_CONFIG_ERROR_MESSAGES "LLVM 17.x found at ${LLVM_CONFIG_EXE} does not support linking as a shared library")
         else()
-          list(APPEND LLVM_CONFIG_ERROR_MESSAGES "LLVM 20.x found at ${LLVM_CONFIG_EXE} does not support linking as a static library")
+          list(APPEND LLVM_CONFIG_ERROR_MESSAGES "LLVM 17.x found at ${LLVM_CONFIG_EXE} does not support linking as a static library")
         endif()
 
         # Ignore this directory and try the search again
@@ -176,6 +173,7 @@ if(ZIG_USE_LLVM_CONFIG)
       OUTPUT_STRIP_TRAILING_WHITESPACE)
   string(REPLACE " " ";" LLVM_INCLUDE_DIRS "${LLVM_INCLUDE_DIRS_SPACES}")
 
+  link_directories("${CMAKE_PREFIX_PATH}/lib")
   link_directories("${LLVM_LIBDIRS}")
 else()
   # Here we assume that we're cross compiling with Zig, of course. No reason
@@ -197,8 +195,6 @@ else()
   FIND_AND_ADD_LLVM_LIB(LLVMXRay)
   FIND_AND_ADD_LLVM_LIB(LLVMLibDriver)
   FIND_AND_ADD_LLVM_LIB(LLVMDlltoolDriver)
-  FIND_AND_ADD_LLVM_LIB(LLVMTelemetry)
-  FIND_AND_ADD_LLVM_LIB(LLVMTextAPIBinaryReader)
   FIND_AND_ADD_LLVM_LIB(LLVMCoverage)
   FIND_AND_ADD_LLVM_LIB(LLVMLineEditor)
   FIND_AND_ADD_LLVM_LIB(LLVMXCoreDisassembler)
@@ -227,10 +223,6 @@ else()
   FIND_AND_ADD_LLVM_LIB(LLVMSystemZCodeGen)
   FIND_AND_ADD_LLVM_LIB(LLVMSystemZDesc)
   FIND_AND_ADD_LLVM_LIB(LLVMSystemZInfo)
-  FIND_AND_ADD_LLVM_LIB(LLVMSPIRVCodeGen)
-  FIND_AND_ADD_LLVM_LIB(LLVMSPIRVDesc)
-  FIND_AND_ADD_LLVM_LIB(LLVMSPIRVInfo)
-  FIND_AND_ADD_LLVM_LIB(LLVMSPIRVAnalysis)
   FIND_AND_ADD_LLVM_LIB(LLVMSparcDisassembler)
   FIND_AND_ADD_LLVM_LIB(LLVMSparcAsmParser)
   FIND_AND_ADD_LLVM_LIB(LLVMSparcCodeGen)
@@ -304,7 +296,6 @@ else()
   FIND_AND_ADD_LLVM_LIB(LLVMAArch64Desc)
   FIND_AND_ADD_LLVM_LIB(LLVMAArch64Utils)
   FIND_AND_ADD_LLVM_LIB(LLVMAArch64Info)
-  FIND_AND_ADD_LLVM_LIB(LLVMOrcDebugging)
   FIND_AND_ADD_LLVM_LIB(LLVMOrcJIT)
   FIND_AND_ADD_LLVM_LIB(LLVMWindowsDriver)
   FIND_AND_ADD_LLVM_LIB(LLVMMCJIT)
@@ -324,23 +315,17 @@ else()
   FIND_AND_ADD_LLVM_LIB(LLVMMCDisassembler)
   FIND_AND_ADD_LLVM_LIB(LLVMLTO)
   FIND_AND_ADD_LLVM_LIB(LLVMPasses)
-  FIND_AND_ADD_LLVM_LIB(LLVMHipStdPar)
   FIND_AND_ADD_LLVM_LIB(LLVMCFGuard)
   FIND_AND_ADD_LLVM_LIB(LLVMCoroutines)
   FIND_AND_ADD_LLVM_LIB(LLVMipo)
   FIND_AND_ADD_LLVM_LIB(LLVMVectorize)
-  FIND_AND_ADD_LLVM_LIB(LLVMSandboxIR)
   FIND_AND_ADD_LLVM_LIB(LLVMLinker)
   FIND_AND_ADD_LLVM_LIB(LLVMInstrumentation)
   FIND_AND_ADD_LLVM_LIB(LLVMFrontendOpenMP)
-  FIND_AND_ADD_LLVM_LIB(LLVMFrontendOffloading)
   FIND_AND_ADD_LLVM_LIB(LLVMFrontendOpenACC)
   FIND_AND_ADD_LLVM_LIB(LLVMFrontendHLSL)
-  FIND_AND_ADD_LLVM_LIB(LLVMFrontendDriver)
-  FIND_AND_ADD_LLVM_LIB(LLVMFrontendAtomic)
   FIND_AND_ADD_LLVM_LIB(LLVMExtensions)
   FIND_AND_ADD_LLVM_LIB(LLVMDWARFLinkerParallel)
-  FIND_AND_ADD_LLVM_LIB(LLVMDWARFLinkerClassic)
   FIND_AND_ADD_LLVM_LIB(LLVMDWARFLinker)
   FIND_AND_ADD_LLVM_LIB(LLVMGlobalISel)
   FIND_AND_ADD_LLVM_LIB(LLVMMIRParser)
@@ -350,7 +335,6 @@ else()
   FIND_AND_ADD_LLVM_LIB(LLVMTarget)
   FIND_AND_ADD_LLVM_LIB(LLVMObjCARCOpts)
   FIND_AND_ADD_LLVM_LIB(LLVMCodeGenTypes)
-  FIND_AND_ADD_LLVM_LIB(LLVMCGData)
   FIND_AND_ADD_LLVM_LIB(LLVMIRPrinter)
   FIND_AND_ADD_LLVM_LIB(LLVMInterfaceStub)
   FIND_AND_ADD_LLVM_LIB(LLVMFileCheck)
@@ -366,7 +350,6 @@ else()
   FIND_AND_ADD_LLVM_LIB(LLVMDebugInfoBTF)
   FIND_AND_ADD_LLVM_LIB(LLVMDebugInfoPDB)
   FIND_AND_ADD_LLVM_LIB(LLVMDebugInfoMSF)
-  FIND_AND_ADD_LLVM_LIB(LLVMDebugInfoCodeView)
   FIND_AND_ADD_LLVM_LIB(LLVMDebugInfoDWARF)
   FIND_AND_ADD_LLVM_LIB(LLVMObject)
   FIND_AND_ADD_LLVM_LIB(LLVMTextAPI)
@@ -374,6 +357,7 @@ else()
   FIND_AND_ADD_LLVM_LIB(LLVMIRReader)
   FIND_AND_ADD_LLVM_LIB(LLVMAsmParser)
   FIND_AND_ADD_LLVM_LIB(LLVMMC)
+  FIND_AND_ADD_LLVM_LIB(LLVMDebugInfoCodeView)
   FIND_AND_ADD_LLVM_LIB(LLVMBitReader)
   FIND_AND_ADD_LLVM_LIB(LLVMFuzzerCLI)
   FIND_AND_ADD_LLVM_LIB(LLVMCore)

cmake/c_flag_overrides.cmake

@@ -0,0 +1,13 @@
+if(MSVC)
+    set(CMAKE_C_FLAGS_DEBUG_INIT
+        "/D_DEBUG /MTd /Zi /Ob0 /Od /RTC1")
+
+    set(CMAKE_C_FLAGS_MINSIZEREL_INIT
+        "/MT /O1 /Ob1 /D NDEBUG")
+
+    set(CMAKE_C_FLAGS_RELEASE_INIT
+        "/MT /O2 /Ob1 /D NDEBUG")
+
+    set(CMAKE_C_FLAGS_RELWITHDEBINFO_INIT
+        "/MT /Zi /O2 /Ob1 /D NDEBUG")
+endif()

cmake/cxx_flag_overrides.cmake

@@ -0,0 +1,13 @@
+if(MSVC)
+    set(CMAKE_CXX_FLAGS_DEBUG_INIT
+        "/D_DEBUG /MTd /Zi /Ob0 /Od /RTC1")
+
+    set(CMAKE_CXX_FLAGS_MINSIZEREL_INIT
+        "/MT /O1 /Ob1 /D NDEBUG")
+
+    set(CMAKE_CXX_FLAGS_RELEASE_INIT
+        "/MT /O2 /Ob1 /D NDEBUG")
+
+    set(CMAKE_CXX_FLAGS_RELWITHDEBINFO_INIT
+        "/MT /Zi /O2 /Ob1 /D NDEBUG")
+endif()

cmake/install.cmake

@@ -1,7 +1,7 @@
-set(ZIG_INSTALL_ARGS build --prefix "${CMAKE_INSTALL_PREFIX}" ${ZIG_BUILD_ARGS})
+set(ZIG_INSTALL_ARGS build ${ZIG_BUILD_ARGS} --prefix "${CMAKE_INSTALL_PREFIX}")
 execute_process(
   COMMAND "${ZIG_EXECUTABLE}" ${ZIG_INSTALL_ARGS}
-  WORKING_DIRECTORY "${ZIG2_WORKING_DIR}"
+  WORKING_DIRECTORY "${CMAKE_SOURCE_DIR}"
   RESULT_VARIABLE _result)
 
 if(_result)

doc/build.zig.zon.md

@@ -10,7 +10,7 @@ build.zig.
 
 ### `name`
 
-Enum literal. Required.
+String. Required.
 
 This is the default name used by packages depending on this one. For example,
 when a user runs `zig fetch --save <url>`, this field is used as the key in the
@@ -20,42 +20,12 @@ will stick with this provided value.
 It is redundant to include "zig" in this name because it is already within the
 Zig package namespace.
 
-Must be a valid bare Zig identifier (don't `@` me), limited to 32 bytes.
-
-Together with `fingerprint`, this represents a globally unique package identifier.
-
-### `fingerprint`
-
-Together with `name`, this represents a globally unique package identifier. This
-field is auto-initialized by the toolchain when the package is first created,
-and then *never changes*. This allows Zig to unambiguously detect when one
-package is an updated version of another.
-
-When forking a Zig project, this fingerprint should be regenerated if the upstream
-project is still maintained. Otherwise, the fork is *hostile*, attempting to
-take control over the original project's identity. The fingerprint can be regenerated
-by deleting the field and running `zig build`.
-
-This 64-bit integer is the combination of a 32-bit id component and a 32-bit
-checksum.
-
-The id component within the fingerprint has these restrictions:
-
-`0x00000000` is reserved for legacy packages.
-
-`0xffffffff` is reserved to represent "naked" packages.
-
-The checksum is computed from `name` and serves to protect Zig users from
-accidental id collisions.
-
 ### `version`
 
 String. Required.
 
 [semver](https://semver.org/)
 
-Limited to 32 bytes.
-
 ### `minimum_zig_version`
 
 String. Optional.
@@ -77,8 +47,7 @@ String.
 
 When updating this field to a new URL, be sure to delete the corresponding
 `hash`, otherwise you are communicating that you expect to find the old hash at
-the new URL. If the contents of a URL change this will result in a hash mismatch
-which will prevent zig from using it.
+the new URL.
 
 #### `hash`
 

doc/langref/Assembly Syntax Explained.zig

@@ -1,59 +0,0 @@
-pub fn syscall1(number: usize, arg1: usize) usize {
-    // Inline assembly is an expression which returns a value.
-    // the `asm` keyword begins the expression.
-    return asm
-    // `volatile` is an optional modifier that tells Zig this
-    // inline assembly expression has side-effects. Without
-    // `volatile`, Zig is allowed to delete the inline assembly
-    // code if the result is unused.
-    volatile (
-    // Next is a comptime string which is the assembly code.
-    // Inside this string one may use `%[ret]`, `%[number]`,
-    // or `%[arg1]` where a register is expected, to specify
-    // the register that Zig uses for the argument or return value,
-    // if the register constraint strings are used. However in
-    // the below code, this is not used. A literal `%` can be
-    // obtained by escaping it with a double percent: `%%`.
-    // Often multiline string syntax comes in handy here.
-        \\syscall
-        // Next is the output. It is possible in the future Zig will
-        // support multiple outputs, depending on how
-        // https://github.com/ziglang/zig/issues/215 is resolved.
-        // It is allowed for there to be no outputs, in which case
-        // this colon would be directly followed by the colon for the inputs.
-        :
-        // This specifies the name to be used in `%[ret]` syntax in
-        // the above assembly string. This example does not use it,
-        // but the syntax is mandatory.
-          [ret]
-          // Next is the output constraint string. This feature is still
-          // considered unstable in Zig, and so LLVM/GCC documentation
-          // must be used to understand the semantics.
-          // http://releases.llvm.org/10.0.0/docs/LangRef.html#inline-asm-constraint-string
-          // https://gcc.gnu.org/onlinedocs/gcc/Extended-Asm.html
-          // In this example, the constraint string means "the result value of
-          // this inline assembly instruction is whatever is in $rax".
-          "={rax}"
-          // Next is either a value binding, or `->` and then a type. The
-          // type is the result type of the inline assembly expression.
-          // If it is a value binding, then `%[ret]` syntax would be used
-          // to refer to the register bound to the value.
-          (-> usize),
-          // Next is the list of inputs.
-          // The constraint for these inputs means, "when the assembly code is
-          // executed, $rax shall have the value of `number` and $rdi shall have
-          // the value of `arg1`". Any number of input parameters is allowed,
-          // including none.
-        : [number] "{rax}" (number),
-          [arg1] "{rdi}" (arg1),
-          // Next is the list of clobbers. These declare a set of registers whose
-          // values will not be preserved by the execution of this assembly code.
-          // These do not include output or input registers. The special clobber
-          // value of "memory" means that the assembly writes to arbitrary undeclared
-          // memory locations - not only the memory pointed to by a declared indirect
-          // output. In this example we list $rcx and $r11 because it is known the
-          // kernel syscall does not preserve these registers.
-        : .{ .rcx = true, .r11 = true });
-}
-
-// syntax

doc/langref/TopLevelFields.zig

@@ -1,18 +0,0 @@
-//! Because this file contains fields, it is a type which is intended to be instantiated, and so
-//! is named in TitleCase instead of snake_case by convention.
-
-foo: u32,
-bar: u64,
-
-/// `@This()` can be used to refer to this struct type. In files with fields, it is quite common to
-/// name the type here, so it can be easily referenced by other declarations in this file.
-const TopLevelFields = @This();
-
-pub fn init(val: u32) TopLevelFields {
-    return .{
-        .foo = val,
-        .bar = val * 10,
-    };
-}
-
-// syntax

doc/langref/addWithOverflow_builtin.zig

@@ -1,13 +0,0 @@
-const print = @import("std").debug.print;
-pub fn main() void {
-    const byte: u8 = 255;
-
-    const ov = @addWithOverflow(byte, 10);
-    if (ov[1] != 0) {
-        print("overflowed result: {}\n", .{ov[0]});
-    } else {
-        print("result: {}\n", .{ov[0]});
-    }
-}
-
-// exe=succeed

doc/langref/anonymous_struct_name.zig

@@ -1,16 +0,0 @@
-const Node = struct {
-    next: ?*Node,
-    name: []const u8,
-};
-
-var node_a = Node{
-    .next = null,
-    .name = "Node A",
-};
-
-var node_b = Node{
-    .next = &node_a,
-    .name = "Node B",
-};
-
-// syntax

doc/langref/assign_undefined.zig

@@ -1,9 +0,0 @@
-const print = @import("std").debug.print;
-
-pub fn main() void {
-    var x: i32 = undefined;
-    x = 1;
-    print("{d}", .{x});
-}
-
-// exe=succeed

doc/langref/bad_default_value.zig

@@ -1,26 +0,0 @@
-const Threshold = struct {
-    minimum: f32 = 0.25,
-    maximum: f32 = 0.75,
-
-    const Category = enum { low, medium, high };
-
-    fn categorize(t: Threshold, value: f32) Category {
-        assert(t.maximum >= t.minimum);
-        if (value < t.minimum) return .low;
-        if (value > t.maximum) return .high;
-        return .medium;
-    }
-};
-
-pub fn main() !void {
-    var threshold: Threshold = .{
-        .maximum = 0.20,
-    };
-    const category = threshold.categorize(0.90);
-    try std.fs.File.stdout().writeAll(@tagName(category));
-}
-
-const std = @import("std");
-const assert = std.debug.assert;
-
-// exe=fail

doc/langref/base64.zig

@@ -1,17 +0,0 @@
-const base64 = @import("std").base64;
-
-export fn decode_base_64(
-    dest_ptr: [*]u8,
-    dest_len: usize,
-    source_ptr: [*]const u8,
-    source_len: usize,
-) usize {
-    const src = source_ptr[0..source_len];
-    const dest = dest_ptr[0..dest_len];
-    const base64_decoder = base64.standard.Decoder;
-    const decoded_size = base64_decoder.calcSizeForSlice(src) catch unreachable;
-    base64_decoder.decode(dest[0..decoded_size], src) catch unreachable;
-    return decoded_size;
-}
-
-// syntax

doc/langref/build.zig

@@ -1,15 +0,0 @@
-const std = @import("std");
-
-pub fn build(b: *std.Build) void {
-    const optimize = b.standardOptimizeOption(.{});
-    const exe = b.addExecutable(.{
-        .name = "example",
-        .root_module = b.createModule(.{
-            .root_source_file = b.path("example.zig"),
-            .optimize = optimize,
-        }),
-    });
-    b.default_step.dependOn(&exe.step);
-}
-
-// syntax

doc/langref/build_c.zig

@@ -1,29 +0,0 @@
-const std = @import("std");
-
-pub fn build(b: *std.Build) void {
-    const lib = b.addLibrary(.{
-        .linkage = .dynamic,
-        .name = "mathtest",
-        .root_module = b.createModule(.{
-            .root_source_file = b.path("mathtest.zig"),
-        }),
-        .version = .{ .major = 1, .minor = 0, .patch = 0 },
-    });
-    const exe = b.addExecutable(.{
-        .name = "test",
-        .root_module = b.createModule(.{
-            .link_libc = true,
-        }),
-    });
-    exe.root_module.addCSourceFile(.{ .file = b.path("test.c"), .flags = &.{"-std=c99"} });
-    exe.root_module.linkLibrary(lib);
-
-    b.default_step.dependOn(&exe.step);
-
-    const run_cmd = exe.run();
-
-    const test_step = b.step("test", "Test the program");
-    test_step.dependOn(&run_cmd.step);
-}
-
-// syntax

doc/langref/build_object.zig

@@ -1,22 +0,0 @@
-const std = @import("std");
-
-pub fn build(b: *std.Build) void {
-    const obj = b.addObject(.{
-        .name = "base64",
-        .root_module = b.createModule(.{
-            .root_source_file = b.path("base64.zig"),
-        }),
-    });
-
-    const exe = b.addExecutable(.{
-        .name = "test",
-        .root_module = b.createModule(.{
-            .link_libc = true,
-        }),
-    });
-    exe.root_module.addCSourceFile(.{ .file = b.path("test.c"), .flags = &.{"-std=c99"} });
-    exe.root_module.addObject(obj);
-    b.installArtifact(exe);
-}
-
-// syntax

doc/langref/builtin.CallModifier struct.zig

@@ -1,35 +0,0 @@
-pub const CallModifier = enum {
-    /// Equivalent to function call syntax.
-    auto,
-
-    /// Equivalent to async keyword used with function call syntax.
-    async_kw,
-
-    /// Prevents tail call optimization. This guarantees that the return
-    /// address will point to the callsite, as opposed to the callsite's
-    /// callsite. If the call is otherwise required to be tail-called
-    /// or inlined, a compile error is emitted instead.
-    never_tail,
-
-    /// Guarantees that the call will not be inlined. If the call is
-    /// otherwise required to be inlined, a compile error is emitted instead.
-    never_inline,
-
-    /// Asserts that the function call will not suspend. This allows a
-    /// non-async function to call an async function.
-    no_async,
-
-    /// Guarantees that the call will be generated with tail call optimization.
-    /// If this is not possible, a compile error is emitted instead.
-    always_tail,
-
-    /// Guarantees that the call will be inlined at the callsite.
-    /// If this is not possible, a compile error is emitted instead.
-    always_inline,
-
-    /// Evaluates the call at compile-time. If the call cannot be completed at
-    /// compile-time, a compile error is emitted instead.
-    compile_time,
-};
-
-// syntax

doc/langref/cImport_builtin.zig

@@ -1,11 +0,0 @@
-const c = @cImport({
-    // See https://github.com/ziglang/zig/issues/515
-    @cDefine("_NO_CRT_STDIO_INLINE", "1");
-    @cInclude("stdio.h");
-});
-pub fn main() void {
-    _ = c.printf("hello\n");
-}
-
-// exe=succeed
-// link_libc

doc/langref/catch.zig

@@ -1,8 +0,0 @@
-const parseU64 = @import("error_union_parsing_u64.zig").parseU64;
-
-fn doAThing(str: []u8) void {
-    const number = parseU64(str, 10) catch 13;
-    _ = number; // ...
-}
-
-// syntax

doc/langref/catch_err_return.zig

@@ -1,8 +0,0 @@
-const parseU64 = @import("error_union_parsing_u64.zig").parseU64;
-
-fn doAThing(str: []u8) !void {
-    const number = parseU64(str, 10) catch |err| return err;
-    _ = number; // ...
-}
-
-// syntax

doc/langref/change_active_union_field.zig

@@ -1,18 +0,0 @@
-const std = @import("std");
-
-const Foo = union {
-    float: f32,
-    int: u32,
-};
-
-pub fn main() void {
-    var f = Foo{ .int = 42 };
-    bar(&f);
-}
-
-fn bar(f: *Foo) void {
-    f.* = Foo{ .float = 12.34 };
-    std.debug.print("value: {}\n", .{f.float});
-}
-
-// exe=succeed

doc/langref/checking_null_in_zig.zig

@@ -1,16 +0,0 @@
-const Foo = struct {};
-fn doSomethingWithFoo(foo: *Foo) void {
-    _ = foo;
-}
-
-fn doAThing(optional_foo: ?*Foo) void {
-    // do some stuff
-
-    if (optional_foo) |foo| {
-        doSomethingWithFoo(foo);
-    }
-
-    // do some stuff
-}
-
-// syntax

doc/langref/cli_allocation.zig

@@ -1,13 +0,0 @@
-const std = @import("std");
-
-pub fn main() !void {
-    var arena = std.heap.ArenaAllocator.init(std.heap.page_allocator);
-    defer arena.deinit();
-
-    const allocator = arena.allocator();
-
-    const ptr = try allocator.create(i32);
-    std.debug.print("ptr={*}\n", .{ptr});
-}
-
-// exe=succeed

doc/langref/comments.zig

@@ -1,12 +0,0 @@
-const print = @import("std").debug.print;
-
-pub fn main() void {
-    // Comments in Zig start with "//" and end at the next LF byte (end of line).
-    // The line below is a comment and won't be executed.
-
-    //print("Hello?", .{});
-
-    print("Hello, world!\n", .{}); // another comment
-}
-
-// exe=succeed

doc/langref/compile-time_duck_typing.zig

@@ -1,11 +0,0 @@
-fn max(comptime T: type, a: T, b: T) T {
-    return if (a > b) a else b;
-}
-fn gimmeTheBiggerFloat(a: f32, b: f32) f32 {
-    return max(f32, a, b);
-}
-fn gimmeTheBiggerInteger(a: u64, b: u64) u64 {
-    return max(u64, a, b);
-}
-
-// syntax

doc/langref/compile_variables.zig

@@ -1,4 +0,0 @@
-const builtin = @import("builtin");
-const separator = if (builtin.os.tag == .windows) '\\' else '/';
-
-// syntax

doc/langref/compiler_generated_function.zig

@@ -1,7 +0,0 @@
-fn max(a: bool, b: bool) bool {
-    {
-        return a or b;
-    }
-}
-
-// syntax

doc/langref/constant_identifier_cannot_change.zig

@@ -1,15 +0,0 @@
-const x = 1234;
-
-fn foo() void {
-    // It works at file scope as well as inside functions.
-    const y = 5678;
-
-    // Once assigned, an identifier cannot be changed.
-    y += 1;
-}
-
-pub fn main() void {
-    foo();
-}
-
-// exe=build_fail

doc/langref/defer_unwind.zig

@@ -1,21 +0,0 @@
-const std = @import("std");
-const print = std.debug.print;
-
-pub fn main() void {
-    print("\n", .{});
-
-    defer {
-        print("1 ", .{});
-    }
-    defer {
-        print("2 ", .{});
-    }
-    if (false) {
-        // defers are not run if they are never executed.
-        defer {
-            print("3 ", .{});
-        }
-    }
-}
-
-// exe=succeed

doc/langref/destructuring_arrays.zig

@@ -1,18 +0,0 @@
-const print = @import("std").debug.print;
-
-fn swizzleRgbaToBgra(rgba: [4]u8) [4]u8 {
-    // readable swizzling by destructuring
-    const r, const g, const b, const a = rgba;
-    return .{ b, g, r, a };
-}
-
-pub fn main() void {
-    const pos = [_]i32{ 1, 2 };
-    const x, const y = pos;
-    print("x = {}, y = {}\n", .{x, y});
-
-    const orange: [4]u8 = .{ 255, 165, 0, 255 };
-    print("{any}\n", .{swizzleRgbaToBgra(orange)});
-}
-
-// exe=succeed

doc/langref/destructuring_block.zig

@@ -1,22 +0,0 @@
-const print = @import("std").debug.print;
-
-pub fn main() void {
-    const digits = [_]i8 { 3, 8, 9, 0, 7, 4, 1 };
-
-    const min, const max = blk: {
-        var min: i8 = 127;
-        var max: i8 = -128;
-
-        for (digits) |digit| {
-            if (digit < min) min = digit;
-            if (digit > max) max = digit;
-        }
-
-        break :blk .{ min, max };
-    };
-
-    print("min = {}\n", .{ min });
-    print("max = {}\n", .{ max });
-}
-
-// exe=succeed

doc/langref/destructuring_mixed.zig

@@ -1,21 +0,0 @@
-const print = @import("std").debug.print;
-
-pub fn main() void {
-    var x: u32 = undefined;
-
-    const tuple = .{ 1, 2, 3 };
-
-    x, var y : u32, const z = tuple;
-
-    print("x = {}, y = {}, z = {}\n", .{x, y, z});
-
-    // y is mutable
-    y = 100;
-
-    // You can use _ to throw away unwanted values.
-    _, x, _ = tuple;
-
-    print("x = {}", .{x});
-}
-
-// exe=succeed

doc/langref/destructuring_return_value.zig

@@ -1,14 +0,0 @@
-const print = @import("std").debug.print;
-
-fn divmod(numerator: u32, denominator: u32) struct { u32, u32 } {
-    return .{ numerator / denominator, numerator % denominator };
-}
-
-pub fn main() void {
-    const div, const mod = divmod(10, 3);
-
-    print("10 / 3 = {}\n", .{div});
-    print("10 % 3 = {}\n", .{mod});
-}
-
-// exe=succeed

doc/langref/destructuring_to_existing.zig

@@ -1,27 +0,0 @@
-const print = @import("std").debug.print;
-
-pub fn main() void {
-    var x: u32 = undefined;
-    var y: u32 = undefined;
-    var z: u32 = undefined;
-
-    const tuple = .{ 1, 2, 3 };
-
-    x, y, z = tuple;
-
-    print("tuple: x = {}, y = {}, z = {}\n", .{x, y, z});
-
-    const array = [_]u32{ 4, 5, 6 };
-
-    x, y, z = array;
-
-    print("array: x = {}, y = {}, z = {}\n", .{x, y, z});
-
-    const vector: @Vector(3, u32) = .{ 7, 8, 9 };
-
-    x, y, z = vector;
-
-    print("vector: x = {}, y = {}, z = {}\n", .{x, y, z});
-}
-
-// exe=succeed

doc/langref/destructuring_vectors.zig

@@ -1,16 +0,0 @@
-const print = @import("std").debug.print;
-
-// emulate punpckldq
-pub fn unpack(x: @Vector(4, f32), y: @Vector(4, f32)) @Vector(4, f32) {
-    const a, const c, _, _ = x;
-    const b, const d, _, _ = y;
-    return .{ a, b, c, d };
-}
-
-pub fn main() void {
-    const x: @Vector(4, f32) = .{ 1.0, 2.0, 3.0, 4.0 };
-    const y: @Vector(4, f32) = .{ 5.0, 6.0, 7.0, 8.0 };
-    print("{}", .{unpack(x, y)});
-}
-
-// exe=succeed

doc/langref/doc_comments.zig

@@ -1,19 +0,0 @@
-/// A structure for storing a timestamp, with nanosecond precision (this is a
-/// multiline doc comment).
-const Timestamp = struct {
-    /// The number of seconds since the epoch (this is also a doc comment).
-    seconds: i64, // signed so we can represent pre-1970 (not a doc comment)
-    /// The number of nanoseconds past the second (doc comment again).
-    nanos: u32,
-
-    /// Returns a `Timestamp` struct representing the Unix epoch; that is, the
-    /// moment of 1970 Jan 1 00:00:00 UTC (this is a doc comment too).
-    pub fn unixEpoch() Timestamp {
-        return Timestamp{
-            .seconds = 0,
-            .nanos = 0,
-        };
-    }
-};
-
-// syntax

doc/langref/entry_point.zig

@@ -1,20 +0,0 @@
-/// `std.start` imports this file using `@import("root")`, and uses this declaration as the program's
-/// user-provided entry point. It can return any of the following types:
-/// * `void`
-/// * `E!void`, for any error set `E`
-/// * `u8`
-/// * `E!u8`, for any error set `E`
-/// Returning a `void` value from this function will exit with code 0.
-/// Returning a `u8` value from this function will exit with the given status code.
-/// Returning an error value from this function will print an Error Return Trace and exit with code 1.
-pub fn main() void {
-    std.debug.print("Hello, World!\n", .{});
-}
-
-// If uncommented, this declaration would suppress the usual std.start logic, causing
-// the `main` declaration above to be ignored.
-//pub const _start = {};
-
-const std = @import("std");
-
-// exe=succeed

doc/langref/enum_export.zig

@@ -1,6 +0,0 @@
-const Foo = enum(c_int) { a, b, c };
-export fn entry(foo: Foo) void {
-    _ = foo;
-}
-
-// obj

doc/langref/enum_export_error.zig

@@ -1,7 +0,0 @@
-const Foo = enum { a, b, c };
-export fn entry(foo: Foo) void {
-    _ = foo;
-}
-
-// obj=parameter of type 'enum_export_error.Foo' not allowed in function with calling convention 'x86_64_sysv'
-// target=x86_64-linux

doc/langref/error_return_trace.zig

@@ -1,41 +0,0 @@
-pub fn main() !void {
-    try foo(12);
-}
-
-fn foo(x: i32) !void {
-    if (x >= 5) {
-        try bar();
-    } else {
-        try bang2();
-    }
-}
-
-fn bar() !void {
-    if (baz()) {
-        try quux();
-    } else |err| switch (err) {
-        error.FileNotFound => try hello(),
-    }
-}
-
-fn baz() !void {
-    try bang1();
-}
-
-fn quux() !void {
-    try bang2();
-}
-
-fn hello() !void {
-    try bang2();
-}
-
-fn bang1() !void {
-    return error.FileNotFound;
-}
-
-fn bang2() !void {
-    return error.PermissionDenied;
-}
-
-// exe=fail

doc/langref/error_union_parsing_u64.zig

@@ -1,41 +0,0 @@
-const std = @import("std");
-const maxInt = std.math.maxInt;
-
-pub fn parseU64(buf: []const u8, radix: u8) !u64 {
-    var x: u64 = 0;
-
-    for (buf) |c| {
-        const digit = charToDigit(c);
-
-        if (digit >= radix) {
-            return error.InvalidChar;
-        }
-
-        // x *= radix
-        var ov = @mulWithOverflow(x, radix);
-        if (ov[1] != 0) return error.OverFlow;
-
-        // x += digit
-        ov = @addWithOverflow(ov[0], digit);
-        if (ov[1] != 0) return error.OverFlow;
-        x = ov[0];
-    }
-
-    return x;
-}
-
-fn charToDigit(c: u8) u8 {
-    return switch (c) {
-        '0'...'9' => c - '0',
-        'A'...'Z' => c - 'A' + 10,
-        'a'...'z' => c - 'a' + 10,
-        else => maxInt(u8),
-    };
-}
-
-test "parse u64" {
-    const result = try parseU64("1234", 10);
-    try std.testing.expect(result == 1234);
-}
-
-// test

doc/langref/export_any_symbol_name.zig

@@ -1,3 +0,0 @@
-export fn @"A function name that is a complete sentence."() void {}
-
-// obj

doc/langref/export_builtin.zig

@@ -1,7 +0,0 @@
-comptime {
-    @export(&internalName, .{ .name = "foo", .linkage = .strong });
-}
-
-fn internalName() callconv(.c) void {}
-
-// obj

doc/langref/export_builtin_equivalent_code.zig

@@ -1,3 +0,0 @@
-export fn foo() void {}
-
-// obj

doc/langref/fibonacci_comptime_infinite_recursion.zig

@@ -1,12 +0,0 @@
-const assert = @import("std").debug.assert;
-
-fn fibonacci(index: i32) i32 {
-    //if (index < 2) return index;
-    return fibonacci(index - 1) + fibonacci(index - 2);
-}
-
-test "fibonacci" {
-    try comptime assert(fibonacci(7) == 13);
-}
-
-// syntax

doc/langref/float_literals.zig

@@ -1,14 +0,0 @@
-const floating_point = 123.0E+77;
-const another_float = 123.0;
-const yet_another = 123.0e+77;
-
-const hex_floating_point = 0x103.70p-5;
-const another_hex_float = 0x103.70;
-const yet_another_hex_float = 0x103.70P-5;
-
-// underscores may be placed between two digits as a visual separator
-const lightspeed = 299_792_458.000_000;
-const nanosecond = 0.000_000_001;
-const more_hex = 0x1234_5678.9ABC_CDEFp-10;
-
-// syntax

doc/langref/float_mode_exe.zig

@@ -1,12 +0,0 @@
-const print = @import("std").debug.print;
-
-extern fn foo_strict(x: f64) f64;
-extern fn foo_optimized(x: f64) f64;
-
-pub fn main() void {
-    const x = 0.001;
-    print("optimized = {}\n", .{foo_optimized(x)});
-    print("strict = {}\n", .{foo_strict(x)});
-}
-
-// syntax

doc/langref/float_mode_obj.zig

@@ -1,15 +0,0 @@
-const std = @import("std");
-const big = @as(f64, 1 << 40);
-
-export fn foo_strict(x: f64) f64 {
-    return x + big - big;
-}
-
-export fn foo_optimized(x: f64) f64 {
-    @setFloatMode(.optimized);
-    return x + big - big;
-}
-
-// obj
-// optimize=ReleaseFast
-// disable_cache

doc/langref/float_special_values.zig

@@ -1,7 +0,0 @@
-const std = @import("std");
-
-const inf = std.math.inf(f32);
-const negative_inf = -std.math.inf(f64);
-const nan = std.math.nan(f128);
-
-// syntax

doc/langref/generic_data_structure.zig

@@ -1,15 +0,0 @@
-fn List(comptime T: type) type {
-    return struct {
-        items: []T,
-        len: usize,
-    };
-}
-
-// The generic List data structure can be instantiated by passing in a type:
-var buffer: [10]i32 = undefined;
-var list = List(i32){
-    .items = &buffer,
-    .len = 0,
-};
-
-// syntax

doc/langref/handle_error_with_catch_block.zig.zig

@@ -1,11 +0,0 @@
-const parseU64 = @import("error_union_parsing_u64.zig").parseU64;
-
-fn doAThing(str: []u8) void {
-    const number = parseU64(str, 10) catch blk: {
-        // do things
-        break :blk 13;
-    };
-    _ = number; // number is now initialized
-}
-
-// syntax

doc/langref/hello.zig

@@ -1,7 +0,0 @@
-const std = @import("std");
-
-pub fn main() !void {
-    try std.fs.File.stdout().writeAll("Hello, World!\n");
-}
-
-// exe=succeed

doc/langref/hello_again.zig

@@ -1,7 +0,0 @@
-const std = @import("std");
-
-pub fn main() void {
-    std.debug.print("Hello, {s}!\n", .{"World"});
-}
-
-// exe=succeed

doc/langref/identifiers.zig

@@ -1,14 +0,0 @@
-const @"identifier with spaces in it" = 0xff;
-const @"1SmallStep4Man" = 112358;
-
-const c = @import("std").c;
-pub extern "c" fn @"error"() void;
-pub extern "c" fn @"fstat$INODE64"(fd: c.fd_t, buf: *c.Stat) c_int;
-
-const Color = enum {
-    red,
-    @"really red",
-};
-const color: Color = .@"really red";
-
-// syntax

doc/langref/inline_assembly.zig

@@ -1,32 +0,0 @@
-pub fn main() noreturn {
-    const msg = "hello world\n";
-    _ = syscall3(SYS_write, STDOUT_FILENO, @intFromPtr(msg), msg.len);
-    _ = syscall1(SYS_exit, 0);
-    unreachable;
-}
-
-pub const SYS_write = 1;
-pub const SYS_exit = 60;
-
-pub const STDOUT_FILENO = 1;
-
-pub fn syscall1(number: usize, arg1: usize) usize {
-    return asm volatile ("syscall"
-        : [ret] "={rax}" (-> usize),
-        : [number] "{rax}" (number),
-          [arg1] "{rdi}" (arg1),
-        : .{ .rcx = true, .r11 = true });
-}
-
-pub fn syscall3(number: usize, arg1: usize, arg2: usize, arg3: usize) usize {
-    return asm volatile ("syscall"
-        : [ret] "={rax}" (-> usize),
-        : [number] "{rax}" (number),
-          [arg1] "{rdi}" (arg1),
-          [arg2] "{rsi}" (arg2),
-          [arg3] "{rdx}" (arg3),
-        : .{ .rcx = true, .r11 = true });
-}
-
-// exe=succeed
-// target=x86_64-linux

doc/langref/inline_call.zig

@@ -1,14 +0,0 @@
-const std = @import("std");
-
-pub fn main() void {
-    if (foo(1200, 34) != 1234) {
-        @compileError("bad");
-    }
-}
-
-inline fn foo(a: i32, b: i32) i32 {
-    std.debug.print("runtime a = {} b = {}", .{ a, b });
-    return a + b;
-}
-
-// exe=succeed

doc/langref/inline_prong_range.zig

@@ -1,9 +0,0 @@
-fn isFieldOptional(comptime T: type, field_index: usize) !bool {
-    const fields = @typeInfo(T).@"struct".fields;
-    return switch (field_index) {
-        inline 0...fields.len - 1 => |idx| @typeInfo(fields[idx].type) == .optional,
-        else => return error.IndexOutOfBounds,
-    };
-}
-
-// syntax

doc/langref/integer_literals.zig

@@ -1,13 +0,0 @@
-const decimal_int = 98222;
-const hex_int = 0xff;
-const another_hex_int = 0xFF;
-const octal_int = 0o755;
-const binary_int = 0b11110000;
-
-// underscores may be placed between two digits as a visual separator
-const one_billion = 1_000_000_000;
-const binary_mask = 0b1_1111_1111;
-const permissions = 0o7_5_5;
-const big_address = 0xFF80_0000_0000_0000;
-
-// syntax

doc/langref/invalid_doc-comment.zig

@@ -1,5 +0,0 @@
-/// doc-comment
-//! top-level doc-comment
-const std = @import("std");
-
-// obj=expected type expression, found 'a document comment'

doc/langref/libc_export_entry_point.zig

@@ -1,10 +0,0 @@
-pub export fn main(argc: c_int, argv: [*]const [*:0]const u8) c_int {
-    const args = argv[0..@intCast(argc)];
-    std.debug.print("Hello! argv[0] is '{s}'\n", .{args[0]});
-    return 0;
-}
-
-const std = @import("std");
-
-// exe=succeed
-// link_libc

doc/langref/macro.zig

@@ -1,10 +0,0 @@
-pub export fn foo() c_int {
-    var a: c_int = 1;
-    _ = &a;
-    var b: c_int = 2;
-    _ = &b;
-    return a + b;
-}
-pub const MAKELOCAL = @compileError("unable to translate C expr: unexpected token .Equal"); // macro.c:1:9
-
-// syntax

doc/langref/math.zig

@@ -1,10 +0,0 @@
-extern fn print(i32) void;
-
-export fn add(a: i32, b: i32) void {
-    print(a + b);
-}
-
-// exe=succeed
-// target=wasm32-freestanding
-// additional_option=-fno-entry
-// additional_option=--export=add

doc/langref/math_add.zig

@@ -1,14 +0,0 @@
-const math = @import("std").math;
-const print = @import("std").debug.print;
-pub fn main() !void {
-    var byte: u8 = 255;
-
-    byte = if (math.add(u8, byte, 1)) |result| result else |err| {
-        print("unable to add one: {s}\n", .{@errorName(err)});
-        return err;
-    };
-
-    print("result: {}\n", .{byte});
-}
-
-// exe=fail

doc/langref/mathtest.zig

@@ -1,5 +0,0 @@
-export fn add(a: i32, b: i32) i32 {
-    return a + b;
-}
-
-// syntax

doc/langref/multiline_string_literals.zig

@@ -1,10 +0,0 @@
-const hello_world_in_c =
-    \\#include <stdio.h>
-    \\
-    \\int main(int argc, char **argv) {
-    \\    printf("hello world\n");
-    \\    return 0;
-    \\}
-;
-
-// syntax

doc/langref/mutable_var.zig

@@ -1,11 +0,0 @@
-const print = @import("std").debug.print;
-
-pub fn main() void {
-    var y: i32 = 5678;
-
-    y += 1;
-
-    print("{d}", .{y});
-}
-
-// exe=succeed

doc/langref/not_atomic_cmpxchgStrong.zig

@@ -1,11 +0,0 @@
-fn cmpxchgStrongButNotAtomic(comptime T: type, ptr: *T, expected_value: T, new_value: T) ?T {
-    const old_value = ptr.*;
-    if (old_value == expected_value) {
-        ptr.* = new_value;
-        return null;
-    } else {
-        return old_value;
-    }
-}
-
-// syntax

doc/langref/null.zig

@@ -1,3 +0,0 @@
-const optional_value: ?i32 = null;
-
-// syntax

doc/langref/optional_integer.zig

@@ -1,7 +0,0 @@
-// normal integer
-const normal_int: i32 = 1234;
-
-// optional integer
-const optional_int: ?i32 = 5678;
-
-// syntax

doc/langref/packed_struct_mmio.zig

@@ -1,19 +0,0 @@
-pub const GpioRegister = packed struct(u8) {
-    GPIO0: bool,
-    GPIO1: bool,
-    GPIO2: bool,
-    GPIO3: bool,
-    reserved: u4 = 0,
-};
-
-const gpio: *volatile GpioRegister = @ptrFromInt(0x0123);
-
-pub fn writeToGpio(new_states: GpioRegister) void {
-    // Example of what not to do:
-    // BAD! gpio.GPIO0 = true; BAD!
-
-    // Instead, do this:
-    gpio.* = new_states;
-}
-
-// syntax

doc/langref/panic_handler.zig

@@ -1,18 +0,0 @@
-pub fn main() void {
-    @setRuntimeSafety(true);
-    var x: u8 = 255;
-    // Let's overflow this integer!
-    x += 1;
-}
-
-pub const panic = std.debug.FullPanic(myPanic);
-
-fn myPanic(msg: []const u8, first_trace_addr: ?usize) noreturn {
-    _ = first_trace_addr;
-    std.debug.print("Panic! {s}\n", .{msg});
-    std.process.exit(1);
-}
-
-const std = @import("std");
-
-// exe=fail

doc/langref/poc_printValue_fn.zig

@@ -1,33 +0,0 @@
-const Writer = struct {
-    pub fn printValue(self: *Writer, value: anytype) !void {
-        switch (@typeInfo(@TypeOf(value))) {
-            .int => {
-                return self.writeInt(value);
-            },
-            .float => {
-                return self.writeFloat(value);
-            },
-            .pointer => {
-                return self.write(value);
-            },
-            else => {
-                @compileError("Unable to print type '" ++ @typeName(@TypeOf(value)) ++ "'");
-            },
-        }
-    }
-
-    fn write(self: *Writer, value: []const u8) !void {
-        _ = self;
-        _ = value;
-    }
-    fn writeInt(self: *Writer, value: anytype) !void {
-        _ = self;
-        _ = value;
-    }
-    fn writeFloat(self: *Writer, value: anytype) !void {
-        _ = self;
-        _ = value;
-    }
-};
-
-// syntax

doc/langref/poc_print_fn.zig

@@ -1,79 +0,0 @@
-const Writer = struct {
-    /// Calls print and then flushes the buffer.
-    pub fn print(self: *Writer, comptime format: []const u8, args: anytype) anyerror!void {
-        const State = enum {
-            start,
-            open_brace,
-            close_brace,
-        };
-
-        comptime var start_index: usize = 0;
-        comptime var state = State.start;
-        comptime var next_arg: usize = 0;
-
-        inline for (format, 0..) |c, i| {
-            switch (state) {
-                State.start => switch (c) {
-                    '{' => {
-                        if (start_index < i) try self.write(format[start_index..i]);
-                        state = State.open_brace;
-                    },
-                    '}' => {
-                        if (start_index < i) try self.write(format[start_index..i]);
-                        state = State.close_brace;
-                    },
-                    else => {},
-                },
-                State.open_brace => switch (c) {
-                    '{' => {
-                        state = State.start;
-                        start_index = i;
-                    },
-                    '}' => {
-                        try self.printValue(args[next_arg]);
-                        next_arg += 1;
-                        state = State.start;
-                        start_index = i + 1;
-                    },
-                    's' => {
-                        continue;
-                    },
-                    else => @compileError("Unknown format character: " ++ [1]u8{c}),
-                },
-                State.close_brace => switch (c) {
-                    '}' => {
-                        state = State.start;
-                        start_index = i;
-                    },
-                    else => @compileError("Single '}' encountered in format string"),
-                },
-            }
-        }
-        comptime {
-            if (args.len != next_arg) {
-                @compileError("Unused arguments");
-            }
-            if (state != State.start) {
-                @compileError("Incomplete format string: " ++ format);
-            }
-        }
-        if (start_index < format.len) {
-            try self.write(format[start_index..format.len]);
-        }
-        try self.flush();
-    }
-
-    fn write(self: *Writer, value: []const u8) !void {
-        _ = self;
-        _ = value;
-    }
-    pub fn printValue(self: *Writer, value: anytype) !void {
-        _ = self;
-        _ = value;
-    }
-    fn flush(self: *Writer) !void {
-        _ = self;
-    }
-};
-
-// syntax