all: nominate Zig 2024.05 about mach HOT 2 CLOSED

This will happen in mid-late May, after SYCL.

from mach.

Tips for upgrading your code

build.zig

• .{ .path = "foo" } -> b.path("foo"):
• lib.installHeader("src/c/m3d.h", "m3d.h"); -> lib.installHeader(b.path("src/c/m3d.h"), "m3d.h");
• lib.installHeaders and lib.installHeadersDirectoryOptions have been merged into lib.installHeadersDirectory:

-    lib.installHeadersDirectory("c/include/brotli", "brotli");
-    lib.installHeadersDirectory(b.path("c/include/brotli"), "brotli", .{});

-    lib.installHeadersDirectoryOptions(.{
-        .source_dir = b.path(""),
-        .include_extensions = &.{".h"},
-        .install_dir = .header,
-        .install_subdir = "spirv-cross",
-    });
+    lib.installHeadersDirectory(b.path(""), "spirv-cross", .{
+        .include_extensions = &.{".h"},
+    });

zig-cache renamed

The local zig-cache/ directory has been renamed to .zig-cache/, so you may need to update your e.g. .gitignore file and delete the older one.

other

• std.ComptimeStringMap(T, values) -> std.StaticStringMap(T).initComptime(values)
• std.os.exit(1); -> std.process.exit(1);
• std.ChildProcess.run -> std.process.Child.run
• std.tar.Options.Diagnostics -> std.tar.Diagnostics
• Many POSIX APIs have been renamed from e.g. std.os.chdir to std.posix.chdir
• std.os.pid_t -> std.c.pid_t
• std.math.degreesToRadians(f32, 90) -> std.math.degreesToRadians(90) - type is now inferred
• In @Type calls, various enums are now lowercase instead of uppercase:
  • .Auto -> .auto,
  • .Packed -> .@"packed"

-        const download_step = @fieldParentPtr(DownloadSourceStep, "step", step_ptr);
+        const download_step: *DownloadSourceStep = @fieldParentPtr("step", step_ptr);

from mach.