From 369fe832ea47959483b7fbbadc6b02007b98154a Mon Sep 17 00:00:00 2001
From: Alexey <110727638+ZavaruKitsu@users.noreply.github.com>
Date: Wed, 5 Nov 2025 12:39:02 +0300
Subject: [PATCH] chore: update macOS building docs

---
 docs/building-mac.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/building-mac.md b/docs/building-mac.md
index 2eafc93b30..b733ddd8cb 100644
--- a/docs/building-mac.md
+++ b/docs/building-mac.md
@@ -1,5 +1,11 @@
 ## Build instructions for macOS
 
+### Note
+
+The build has only been tested with Xcode 26.1. Although it may work on lower Xcode versions, this is not guaranteed.
+
+Xcode 26 has deprecated AGL, so you need to remove "AGL" from CMake options [here](https://github.com/desktop-app/cmake_helpers/blob/c7e0493dea2b870fb1b8e26604201fdb9e8c1ee5/options_mac.cmake#L64).
+
 ### Prepare folder
 
 Choose a folder for the future build, for example **/Users/user/TBuild**. It will be named ***BuildPath*** in the rest of this document. All commands will be launched from Terminal.