MacOS: Using 'Minimum Deployment Target' 10.7 (Lion) and documenting MacOS versions

Note that starting with Xcode 14.3, the upcoming 'Minimum Deployment Target' is 10.13 (High Sierra).
However, we are still using Xcode 14.2 and hence 10.7 is still supported.

Note that I upped the 'Minimum Deployment Target' (again) from 10.5 to 10.7
to align with JOAL/openal-soft, i.e. a guaranteed common denominator.
You may still try to use 10.5.

Note lowest tested MacOS version (from myself) is 10.13.6 w/ x86_64) (High Sierra).

2 files changed, 58 insertions, 2 deletions

diff --git a/doc/HowToBuild.html b/doc/HowToBuild.html
index 89a5a89..dc4e680 100644
--- a/doc/HowToBuild.html
+++ b/doc/HowToBuild.html
@@ -137,12 +137,16 @@ apt-get install kernel-package build-essential
                         </li>
                         <li> <b>MacOS and iOS</b> x86_64 and aarch64
                             <ul>
-                                <li><a href="http://www.apple.com/macosx/">Mac OS</a> 12.6.5</li>
+                                <li>Build machine: <a href="http://www.apple.com/macosx/">Mac OS</a> 12.6.5 (Monterey)
+                                <ul>
+                                    <li>Lowest test machine: <a href="http://www.apple.com/macosx/">Mac OS</a> 10.13.6 (High Sierra)</li>
+                                    <li>Minimum deployment target: <a href="http://www.apple.com/macosx/">Mac OS</a> 10.7 (Lion)</li>
+                                </ul></li>
                                 <li><a href="http://developer.apple.com/technologies/xcode.html">Xcode</a> 14.2 for clang, etc (included in MacOS)</li>
                                 <li>MacOS SDK 11.3 from a previous XCode version or <a href="https://github.com/phracker/MacOSX-SDKs">from this alternative site</a>
                                 <ul>
                                     <li><i>export SDKROOT=macosx11.3</i></li>
-                                    <li>We use <i>-mmacosx-version-min=10.5</i> deployment target in general.</li>
+                                    <li>We use <i>-mmacosx-version-min=10.7</i> (Lion 10.7) minimum deployment target.</li>
                                 </ul></li>
                                 <li>git &ge; 2.37 provided by Xcode &ge; 14</li>
                                 <li>awk is provided by MacOS</li>
@@ -151,6 +155,7 @@ apt-get install kernel-package build-essential
                                     <li>Install symlinks to <i>/usr/local/bin</i>, run: <i>sudo "/Applications/CMake.app/Contents/bin/cmake-gui" --install</i></li>
                                 </ul></li>
                                 <li><a href="https://7-zip.org/">7-Zip 21.07</a> x86_64 and arm64 version</li>
+                                <li>See also <a href="JogAmpMacOSVersions.md">MacOS Versions Related to JogAmp</a></li>
                             </ul>
                             Prepare fat universal OpenJDK libraries
                             <ul>
diff --git a/doc/JogAmpMacOSVersions.md b/doc/JogAmpMacOSVersions.md
new file mode 100644
index 0000000..aba78d3
--- /dev/null
+++ b/doc/JogAmpMacOSVersions.md
@@ -0,0 +1,51 @@
+# MacOS Versions Related to JogAmp
+
+References
+
+- [Mac OS Version History (wiki)](https://en.wikipedia.org/wiki/MacOS_version_history).
+- [Xcode Version Comparison Table (wiki)](https://en.wikipedia.org/wiki/Xcode#Version_comparison_table)
+
+## Overview
+
+| MacOS Version | Release Name | Darwin Version | JogAmp Relation                            |
+|:--------------|:-------------|:---------------|:-------------------------------------------|
+| 10.7 	        | Lion 	       | 11             | Min deployment target                      |
+|               |              |                |                                            |
+| 10.13 	    | High Sierra  | 17             | Test node 10.13.6, `x86_64`                |
+| 10.14 	    | Mojave 	   | 18             |                                            |
+| 10.15 	    | Catalina 	   | 19             |                                            |
+|               |              |                |                                            |
+| 11 	        | Big Sur 	   | 20             | Build node 12.6.5, w/ Xcode 14.2, `x86_64` |
+| 12 	        | Monterey 	   | 21             |                                            |
+| 13 	        | Ventura 	   | 22             | Test node 13.1, `arm64`                    |
+
+## OpenJDK
+
+Available Java(tm) VMs
+
+- [OpenJDK](http://openjdk.java.net/) build @ [Adoptium](https://adoptium.net/temurin/releases/)
+  - [Adoptium Supported MacOS Versions](https://adoptium.net/supported-platforms/)
+    - MacOS 10.15, 11, 12, 13 for `x86_64` and `arm64`
+
+## JogAmp Build and Test Setup
+
+- MacOS 12.6.5 (Monterey), Darwin 21, `x86_64`
+  - Build and main test machine
+  - XCode 14.2 w/ SDK 11.3
+    - `export SDKROOT=macosx11.3` (*MacOS SDK*)
+    - `-mmacosx-version-min=10.7` (*Miniumum deployment target*)
+  - OpenJDK Temurin 17.0.5+8
+  
+- MacOS 10.13.6 (High Sierra), Darwin 17, `x86_64`
+  - Test machine
+  - OpenJDK Temurin 17.0.5+8
+
+- MacOS 13.1 (Ventura), Darwin 22, `arm64`
+  - Test machine
+  - OpenJDK Temurin 17.0.5+8
+
+## Change History
+
+| Date       | Note                                     |
+|:-----------|:-----------------------------------------|
+| 2023-05-06 | Initial Version for JogAmp Release 2.5.0 |