Update build commands in README (#1083)

No functional change.

Bench: 3204302

Author: Saphereye

Makefile

@@ -1,44 +1,70 @@
-export RUSTFLAGS := -Ctarget-cpu=native
+EXE    := reckless
+TARGET := $(shell rustc --print host-tuple)
 
-EXE := reckless
-TARGET_TUPLE := $(shell rustc --print host-tuple)
+RUSTFLAGS ?= -C target-cpu=native
+export RUSTFLAGS
 
 ifdef MSYSTEM
 	NAME := $(EXE).exe
-	ENV = UNIX
+	ENV  := UNIX
 else ifeq ($(OS),Windows_NT)
 	NAME := $(EXE).exe
-	ENV = WINDOWS
+	ENV  := WINDOWS
 else
 	NAME := $(EXE)
-	ENV := UNIX
+	ENV  := UNIX
 endif
 
 ifeq ($(ENV),UNIX)
-	PGO_MOVE := mv "target/$(TARGET_TUPLE)/release/reckless" "$(NAME)"
+	PGO_MOVE := mv "target/$(TARGET)/release/$(EXE)" "$(NAME)"
 else
-	PGO_MOVE := move /Y "target\$(TARGET_TUPLE)\release\reckless.exe" "$(NAME)"
+	PGO_MOVE := move /Y "target\$(TARGET)\release\$(EXE).exe" "$(NAME)"
 endif
 
-rule:
-	cargo rustc --release --bin reckless -- -C target-cpu=native --emit link=$(NAME)
+.PHONY: all no-syzygy pgo wasm x64-check checkdeps clean help
 
-wasm:
-	unset RUSTFLAGS && rustup run nightly \
+all: ## Build the engine
+	cargo rustc --release --bin $(EXE) -- --emit link=$(NAME)
+
+no-syzygy: ## Build without syzygy support
+	cargo rustc --release --bin $(EXE) --no-default-features -- --emit link=$(NAME)
+
+pgo: ## Build with profile-guided optimization
+	cargo pgo instrument
+	cargo pgo run -- bench
+	cargo pgo optimize
+	$(PGO_MOVE)
+
+wasm: ## Build the WebAssembly target
+	RUSTFLAGS= rustup run nightly \
 		cargo build -Z build-std=panic_abort,std \
 		--lib --target wasm32-unknown-unknown --release --no-default-features
 	wasm-bindgen target/wasm32-unknown-unknown/release/reckless.wasm --target web --out-dir pkg
 	wasm-opt -O3 --enable-simd --enable-threads --enable-relaxed-simd \
 		pkg/reckless_bg.wasm -o pkg/reckless_bg.wasm
 
-
-x64-check:
+x64-check: ## Check compilation for x86-64 v1-v4
 	RUSTFLAGS="-C target-cpu=x86-64" cargo check --target x86_64-unknown-linux-gnu --no-default-features
+	RUSTFLAGS="-C target-cpu=x86-64-v2" cargo check --target x86_64-unknown-linux-gnu --no-default-features
 	RUSTFLAGS="-C target-cpu=x86-64-v3" cargo check --target x86_64-unknown-linux-gnu --no-default-features
 	RUSTFLAGS="-C target-cpu=x86-64-v4 -C target-feature=+gfni,+avx512bw,+avx512vl,+avx512vbmi,+avx512vbmi2,+avx512vnni,+avx512bitalg" cargo check --target x86_64-unknown-linux-gnu --no-default-features
 
-pgo:
-	cargo pgo instrument
-	cargo pgo run -- bench
-	cargo pgo optimize
-	$(PGO_MOVE)
+checkdeps: ## Verify build dependencies are installed
+	@echo "-- required --"
+	@command -v rustc >/dev/null 2>&1 && echo "  rustc        ok" || (echo "  rustc        MISSING"; exit 1)
+	@command -v clang >/dev/null 2>&1 && echo "  clang        ok" || echo "  clang        MISSING (required for Syzygy; use 'make no-syzygy' to skip)"
+	@echo "-- pgo --"
+	@command -v cargo-pgo >/dev/null 2>&1 && echo "  cargo-pgo    ok" || echo "  cargo-pgo    missing (run: cargo install cargo-pgo)"
+	@echo "-- wasm --"
+	@rustup toolchain list 2>/dev/null | grep -q nightly && echo "  nightly      ok" || echo "  nightly      missing (run: rustup toolchain install nightly)"
+	@command -v wasm-bindgen >/dev/null 2>&1 && echo "  wasm-bindgen ok" || echo "  wasm-bindgen missing (run: cargo install wasm-bindgen-cli)"
+	@command -v wasm-opt     >/dev/null 2>&1 && echo "  wasm-opt     ok" || echo "  wasm-opt     missing (install binaryen)"
+
+clean: ## Remove build artifacts
+	cargo clean
+	rm -f "$(EXE)" "$(EXE).exe"
+
+help: ## Show this help
+	@awk 'BEGIN {FS = ":.*##"} /^[a-zA-Z0-9_-]+:.*?##/ { \
+		printf "  %-12s %s\n", $$1, $$2 \
+	}' $(MAKEFILE_LIST)

README.md

@@ -64,14 +64,15 @@ To build Reckless from source, make sure you have:
 Once installed, you can build it with:
 
 ```bash
-cargo rustc --release -- -C target-cpu=native
-# ./target/release/reckless
+make
+# ./reckless
 ```
 
-To build without Syzygy tablebase support and Clang dependency, add the `--no-default-features` flag:
+To build without Syzygy tablebase support and Clang dependency:
 
 ```bash
-cargo rustc --release --no-default-features -- -C target-cpu=native
+make no-syzygy
+# ./reckless
 ```
 
 #### PGO builds