From 507a3486113aa491c820beeb4204a6623763ed3c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?C=C5=93ur?= <coeur@gmx.fr>
Date: Wed, 4 Feb 2026 02:28:41 +0100
Subject: [PATCH] docs: document different macOS versions needed for building
 vs running

---
 README.md                     | 4 ++--
 docs/Building-Transmission.md | 7 +++++--
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 03e8f6695..65d4eff39 100644
--- a/README.md
+++ b/README.md
@@ -32,8 +32,8 @@ For a more detailed description, and dependencies, visit [How to Build Transmiss
 ### Building a Transmission release from the command line
 
 ```bash
-$ tar xf transmission-4.0.6.tar.xz
-$ cd transmission-4.0.6
+$ tar xf transmission-4.1.0.tar.xz
+$ cd transmission-4.1.0
 # Use -DCMAKE_BUILD_TYPE=RelWithDebInfo to build optimized binary with debug information. (preferred)
 # Use -DCMAKE_BUILD_TYPE=Release to build full optimized binary.
 $ cmake -B build -DCMAKE_BUILD_TYPE=RelWithDebInfo
diff --git a/docs/Building-Transmission.md b/docs/Building-Transmission.md
index cb62ce4bb..ec64632fd 100644
--- a/docs/Building-Transmission.md
+++ b/docs/Building-Transmission.md
@@ -2,9 +2,12 @@
 The source code for both official and nightly releases can be found on our [download page](https://transmissionbt.com/download/).
 
 ## On macOS ##
-Software prerequisites:
+While the prerequisites for running the app are:
  * macOS 11.0 or newer
- * Xcode 12.5.1 or newer
+
+The actual software prerequisites for building the app are based on GitHub Actions [macos-14](https://github.com/actions/runner-images/blob/main/images/macos/macos-14-arm64-Readme.md):
+ * macOS 14.8.3 or newer
+ * Xcode 15.0.1 or newer
 
 Building the project on Mac requires the source to be retrieved from GitHub. Pre-packaged source code will not compile.
 ```bash