From 45dfd80371785731bc2ed05a76252497a4e7a282 Mon Sep 17 00:00:00 2001
From: Andrew Moryakov <topazd2@gmail.com>
Date: Mon, 4 May 2026 15:35:24 +0300
Subject: [PATCH] readme : link "Build for CPU" to AVX-512 build flags
 reference (#1735)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds a short note in README's "Build for CPU" section pointing to the
AVX-512 build flags reference in docs/build.md (added by #1729).

The vanilla `cmake -B build -DGGML_NATIVE=ON` example shown right above
silently falls back to the AVX2 path on AMD Zen4 / Intel Sapphire
Rapids+ hardware; users hitting "my Zen4 build is slow" tend to look at
the README first, so a single-paragraph cross-reference here saves them
from having to dig through docs/ to find the right knob.

No content moved — README still has its own short example, the new
paragraph just points at the deeper reference.
---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index 13d4ec27..dc50bc18 100644
--- a/README.md
+++ b/README.md
@@ -45,6 +45,12 @@ cmake -B build -DGGML_NATIVE=ON
 cmake --build build --config Release -j$(nproc)
 ```
 
+For AVX-512-capable CPUs (AMD Zen4 / Intel Sapphire Rapids+), see
+[`docs/build.md`](docs/build.md) section "CPU build flags for AVX-512" for the
+additional flags that activate the IQK quantized GEMM kernels (the
+`HAVE_FANCY_SIMD` path). Without those flags, a vanilla `Release` build
+silently falls back to the AVX2 path on this hardware.
+
 ### Build for GPU
 
 Install Nvidia Drivers and [CUDA Toolkit](https://developer.nvidia.com/cuda/toolkit).