CI: replicate Qt tweak explanation from one macOS file into another

Makes it slightly less cryptic to the reader why these steps are being done.

diff --git a/ci/install-runtime-dependencies-macos.sh b/ci/install-runtime-dependencies-macos.sh
index 395e6947352f7c05ce26365b09945e6de08371b6..ab343ada2b6fce8615f040a543a3151abc3538fc 100644 (file)
--- a/ci/install-runtime-dependencies-macos.sh
+++ b/ci/install-runtime-dependencies-macos.sh
@@ -8,10 +8,26 @@ set -x
 brew update
 brew install pango || brew upgrade pango
 brew install qt5 || brew upgrade qt5
+
+# quoting Homebrew:
+#
+#   qt@5 is keg-only, which means it was not symlinked into /usr/local,
+#   because this is an alternate version of another formula.
+#
+#   If you need to have qt@5 first in your PATH, run:
+#     echo 'export PATH="/usr/local/opt/qt@5/bin:$PATH"' >> ~/.zshrc
+#
+#   For compilers to find qt@5 you may need to set:
+#     export LDFLAGS="-L/usr/local/opt/qt@5/lib"
+#     export CPPFLAGS="-I/usr/local/opt/qt@5/include"
+#
+#   For pkg-config to find qt@5 you may need to set:
+#     export PKG_CONFIG_PATH="/usr/local/opt/qt@5/lib/pkgconfig"
 export PATH="/usr/local/opt/qt@5/bin:$PATH"
 export LDFLAGS="-L/usr/local/opt/qt@5/lib"
 export CPPFLAGS="-I/usr/local/opt/qt@5/include"
 export PKG_CONFIG_PATH="/usr/local/opt/qt@5/lib/pkgconfig"
+
 brew install libxaw || brew upgrade libxaw
 
 # install MacPorts for libANN