From 43773c430a6b999ab1e53ab52b9badf72e756ce9 Mon Sep 17 00:00:00 2001
From: Mike Solar <iam@mikesolar.cn>
Date: Mon, 13 Jul 2026 14:29:14 +0800
Subject: [PATCH] docs: update build guides for official macOS support and sync
 Fedora deps

- English and Chinese build.md now list macOS as a fully supported
  platform and point to the dedicated macOS build guide.
- Chinese build.md Fedora dependency list synced with English: use
  ffmpeg-free-devel and add bzip2-devel.
---
 docs/build.md    | 4 ++--
 docs/zh/build.md | 9 +++++----
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/docs/build.md b/docs/build.md
index 713309c34..6babc7477 100644
--- a/docs/build.md
+++ b/docs/build.md
@@ -199,9 +199,9 @@ ctest --test-dir build --output-on-failure -C Release
 
 ---
 
-## macOS (Non-Official Support)
+## macOS
 
-Note: macOS support is **non-official**. We only run CI automation on macOS and do not perform manual testing.
+macOS is a fully supported platform. See [`build-macos.md`](build-macos.md) for a dedicated, step-by-step guide.
 
 Install dependencies:
 
diff --git a/docs/zh/build.md b/docs/zh/build.md
index dc051efbe..be58e55ec 100644
--- a/docs/zh/build.md
+++ b/docs/zh/build.md
@@ -133,7 +133,7 @@ ctest --test-dir build --output-on-failure -C Release
 sudo dnf install -y \
   cmake ninja-build pkgconf-pkg-config \
   qt6-qtbase-devel qt6-qtbase-private-devel qt6-qttools-devel \
-  ffmpeg-devel \
+  ffmpeg-free-devel \
   OpenImageIO-devel \
   OpenColorIO-devel \
   openexr-devel \
@@ -143,7 +143,8 @@ sudo dnf install -y \
   vulkan-headers \
   vulkan-loader-devel \
   libxkbcommon-devel \
-  gcc-c++
+  gcc-c++ \
+  bzip2-devel
 ```
 
 配置并构建：
@@ -198,9 +199,9 @@ ctest --test-dir build --output-on-failure -C Release
 
 ---
 
-## macOS（非官方支持）
+## macOS
 
-说明：macOS **非官方支持**，目前只做 CI 自动化测试，不做人工测试。
+macOS 是正式支持的平台。更详细的逐步指南请参见 [`build-macos-zh.md`](build-macos-zh.md)。
 
 安装依赖：