docs: better diagnostics

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" }

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