From 2425dd7d04dc196fa0542b59f18efb048a0c67a8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Magalh=C3=A3es?= <joamag@gmail.com>
Date: Sun, 4 Jun 2023 22:16:42 +0100
Subject: [PATCH] docs: better diagnostics

---
 frontends/sdl/Cargo.toml |  6 +++++-
 frontends/sdl/README.md  | 14 +++++++++++---
 2 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/frontends/sdl/Cargo.toml b/frontends/sdl/Cargo.toml
index 6f82827c..986c892b 100644
--- a/frontends/sdl/Cargo.toml
+++ b/frontends/sdl/Cargo.toml
@@ -37,7 +37,11 @@ features = ["ttf", "image", "gfx", "mixer", "static-link", "use-vcpkg"]
 [package.metadata.vcpkg]
 dependencies = ["sdl2", "sdl2-image[libjpeg-turbo,tiff,libwebp]", "sdl2-ttf", "sdl2-gfx", "sdl2-mixer"]
 git = "https://github.com/microsoft/vcpkg"
-rev = "501db0f17ef6df184fcdbfbe0f87cde2313b6ab1"
+rev = "2023.04.15"
+
+# If you face issues with the SDL2 libraries linking process
+# try to use the following revision instead
+# rev = "2022.10.19"
 
 [package.metadata.vcpkg.target]
 x86_64-pc-windows-msvc = { triplet = "x64-windows-static-md" }
diff --git a/frontends/sdl/README.md b/frontends/sdl/README.md
index b932b448..262c2271 100644
--- a/frontends/sdl/README.md
+++ b/frontends/sdl/README.md
@@ -57,13 +57,21 @@ To obtain more information about the issues.
 
 #### I'm facing issues with the vcpkg binaries
 
-If there're issues with the `cargo vcpkg build` build process you may need to remove the `~/.vcpkg-root` and re rung the process to re-build the whole set of packages.
+If there're issues with the `cargo vcpkg build` build process you may need to remove the `~/.vcpkg-root` and re-run the process to re-build the whole set of packages.
 
-### I'm having difficulties building SDL for arm64
+### I'm having difficulties building SDL for arm64 in Mac OS
 
-Try the above strategy.
+Try the above strategy and also try to remove `~/.cache/vcpkg`.
 If that does not work try to remove the `Cargo.lock` file to flush dependencies.
 
+A quick shortcut to the complete set of operations would be:
+
+```bash
+rm -rf ~/.vcpkg-root
+rm -rf ~/.cache/vcpkg
+cargo vcpkg -v build
+```
+
 ## Execution
 
 ### Headless
-- 
GitLab