From 33b0b26a03a401bd39b88931b69d162c3c538d31 Mon Sep 17 00:00:00 2001
From: Raul Siles <5730357+raulsiles@users.noreply.github.com>
Date: Wed, 28 Apr 2021 08:09:42 +0200
Subject: [PATCH] doc: note that brew installed qt is not supported

---
 doc/build-osx.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/build-osx.md b/doc/build-osx.md
index ab298f5f2c3..467feff4106 100644
--- a/doc/build-osx.md
+++ b/doc/build-osx.md
@@ -138,6 +138,14 @@ Skip if you don't intend to use the GUI.
 brew install qt@5
 ```
 
+Ensure that the `qt@5` package is installed, not the `qt` package.
+If 'qt' is installed, the build process will fail.
+if installed, remove the `qt` package with the following command:
+
+``` bash
+brew uninstall qt
+```
+
 Note: Building with Qt binaries downloaded from the Qt website is not officially supported.
 See the notes in [#7714](https://github.com/bitcoin/bitcoin/issues/7714).