From 462a67e7f43c1a08c21be193c0808132b762697e Mon Sep 17 00:00:00 2001
From: Janek Bevendorff <janek@jbev.net>
Date: Tue, 21 Nov 2023 23:10:39 +0100
Subject: [PATCH] Updated Set up Build Environment on macOS (markdown)

---
 Set-up-Build-Environment-on-macOS.md | 51 ++++++++++++++++++++++------
 1 file changed, 41 insertions(+), 10 deletions(-)

diff --git a/Set-up-Build-Environment-on-macOS.md b/Set-up-Build-Environment-on-macOS.md
index 9e33a88..af1faf6 100644
--- a/Set-up-Build-Environment-on-macOS.md
+++ b/Set-up-Build-Environment-on-macOS.md
@@ -7,28 +7,59 @@ Install Homebrew (it is the easiest way to install the required packages on macO
 /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
 ```
 
-### Install the C++ toolchain
-
-This command will install Cmake
-
-Open a Terminal
+Next, install the needed build tools:
 
 ```
-brew install cmake
+brew install cmake asciidoctor
 ```
 
-### Install the required dependencies
+### Install build dependencies
 
-Open a Terminal:
+To install the actual build dependencies, there are two options:
+
+1. Via Homebrew (faster, but suitable only for local builds).
+2. Via vcpkg (much slower, but suitable for distribution builds).
+
+#### Option 1: Install build dependencies via Homebrew
+
+Open a terminal and run:
 
 ```
-brew install qt@5 argon2 botan qrencode asciidoctor readline minizip
+brew installqt@5 argon2 botan qrencode asciidoctor readline minizip
+```
+
+#### Option 2: Install build dependencies via vcpkg
+
+Install vcpkg and pkg-config via Homebrew:
+
+```
+brew install vcpkg pkg-config
+```
+
+Next, update the vcpkg port files:
+
+```
+cd /opt/vcpkg && git pull
+```
+
+Finally, compile and install the actual build dependencies:
+
+```
+vcpkg install argon2 botan minizip qt5 qt5-svg qt5-tools qt5-imageformats \
+    qt5-translations readline zlib libqrencode
 ```
 
 ### Update your environment regularly
 
-Open a Terminal:
+Homebrew:
 
 ```
 brew update && brew upgrade
 ```
+
+vcpkg:
+
+```
+cd /opt/vcpkg && git pull
+vcpkg update
+```
\ No newline at end of file