Merge pull request #2219 from AndreMiras/feature/update_install_docs

📝 Updates install and troubleshooting docs

Author: AndreMiras

doc/source/quickstart.rst

@@ -62,14 +62,16 @@ Installing Dependencies
 p4a has several dependencies that must be installed:
 
 - ant
-- autoconf (for ffpyplayer_codecs recipe)
+- autoconf (for libffi and other recipes)
+- automake
 - ccache (optional)
 - cmake (required for some native code recipes like jpeg's recipe)
 - cython (can be installed via pip)
 - gcc
 - git
 - libncurses (including 32 bit)
-- libtool (for ffpyplayer_codecs recipe)
+- libtool (for libffi and recipes)
+- libssl-dev (for TLS/SSL support on hostpython3 and recipe)
 - openjdk-8
 - patch
 - python3
@@ -83,7 +85,7 @@ install most of these with::
 
     sudo dpkg --add-architecture i386
     sudo apt-get update
-    sudo apt-get install -y build-essential ccache git zlib1g-dev python3 python3-dev libncurses5:i386 libstdc++6:i386 zlib1g:i386 openjdk-8-jdk unzip ant ccache autoconf libtool
+    sudo apt-get install -y build-essential ccache git zlib1g-dev python3 python3-dev libncurses5:i386 libstdc++6:i386 zlib1g:i386 openjdk-8-jdk unzip ant ccache autoconf libtool libssl-dev
 
 On Arch Linux you should be able to run the following to
 install most of the dependencies (note: this list may not be
@@ -93,10 +95,7 @@ complete)::
 
 On macOS::
 
-    brew cask install autoconf automake java8 libtool pkg-config
-
-If Java 8 is no longer available you can still install it via::
-
+    brew install autoconf automake libtool openssl pkg-config
     brew tap homebrew/cask-versions
     brew cask install homebrew/cask-versions/adoptopenjdk8
 

doc/source/troubleshooting.rst

@@ -207,4 +207,15 @@ SSLError("Can't connect to HTTPS URL because the SSL module is not available.")
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Your `hostpython3` was compiled without SSL support. You need to install the SSL development files before rebuilding the `hostpython3` recipe.
-On Ubuntu and derivatives these come from the `libssl-dev` package (then `p4a clean builds`, or with buildozer `buildozer android clean`).
+Remember to always clean the build before rebuilding (`p4a clean builds`, or with buildozer `buildozer android clean`).
+
+On Ubuntu and derivatives::
+
+    apt install openssl
+    p4a clean builds # or with: buildozer `buildozer android clean
+
+On macOS::
+
+    brew install openssl
+    sudo ln -sfn /usr/local/opt/openssl /usr/local/ssl
+    p4a clean builds # or with: buildozer `buildozer android clean