Add 'shape/' from commit '8c82294c9190463a2fe19de485ff706ae21ef758'

git-subtree-dir: shape
git-subtree-mainline: f61860e87e
git-subtree-split: 8c82294c91

shape/README.md

@@ -0,0 +1,18 @@
+### Configuring CLion for debugging
+
+Use https://github.com/asdf-vm/asdf with https://github.com/allemangd/asdf-zig for the versioned zig master in `.tool-versions`.
+
+Build ZLS with that zig and point ZigBrains to it.
+
+Custom Build Application configurations:
+
+- `zig-shape` uses custom target `zig build -fincremental` and executes `zig-out/bin/zig-shape`.
+- `exe-unit-tests` uses custom target `zig build -fincremental build-tests` and executes `zig-out/dev/exe-unit-tests`
+- `lib-unit-tests` uses custom target `zig build -fincremental build-tests` and executes `zig-out/dev/lib-unit-tests`
+
+Then native "build", "run", and "debug" buttons will work.
+
+Optionally create a "clean" target that executes `rm -r .zig-cache zig-out`
+
+Switching between debug and release build is more difficult. Probably easier to run release builds
+only via CLI, like `zig build --release=fast` or `zig build --release=fast test`.