From 9172f6c5384eb221cf158a460144196a45b1cf50 Mon Sep 17 00:00:00 2001
From: "Jeffrey C. Ollie" <jeff@ocjtech.us>
Date: Mon, 26 Jan 2026 14:43:54 -0600
Subject: [PATCH] build: include comments on why '/' is removed

---
 src/build/GitVersion.zig | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/build/GitVersion.zig b/src/build/GitVersion.zig
index 658eca244..566fec2e9 100644
--- a/src/build/GitVersion.zig
+++ b/src/build/GitVersion.zig
@@ -29,6 +29,10 @@ pub fn detect(b: *std.Build) !Version {
             error.ExitCodeFailure => return error.GitNotRepository,
             else => return err,
         };
+        // Replace any '/' with '-' as including slashes will mess up building
+        // the dist tarball - the tarball uses the branch as part of the
+        // name and including slashes means that the tarball will end up in
+        // subdirectories instead of where it's supposed to be.
         std.mem.replaceScalar(u8, tmp, '/', '-');
         break :b tmp;
     };