From 8ed6e977ebaccc022ea08fc4aa11ce814f430764 Mon Sep 17 00:00:00 2001
From: Tres Finocchiaro <tres.finocchiaro@gmail.com>
Date: Thu, 14 Jan 2021 19:38:06 -0500
Subject: [PATCH] Update documentation

---
 www/MacDevelopmentEnvironment.md | 48 ++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/www/MacDevelopmentEnvironment.md b/www/MacDevelopmentEnvironment.md
index 715ba61207..4ca8d37996 100644
--- a/www/MacDevelopmentEnvironment.md
+++ b/www/MacDevelopmentEnvironment.md
@@ -1,6 +1,54 @@
 Mac Development Environment
 ===========================
 
+### Prequisites
+* [Xcode](https://developer.apple.com/download/) with Command Line tools
+* The following tools: `ant autoconf automake libtool gettext`
+   * These are available via [Homebrew](https://brew.sh)
+      ```bash
+      brew install ant autoconf automake libtool gettext
+      ```
+
+   * ... or alternately via [MacPorts](https://www.macports.org/)
+
+### Compiling
+
+1. To compile and run unit tests for the current archecture:
+   ```bash
+   ant
+   ```
+
+2. To compile native components only and skip unit tests:
+   ```bash
+   ant native
+   ```
+
+3. To provide an alternate (older) macOS SDK:
+   ```bash
+   ant -DSDKROOT=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.7.sdk
+   ```
+
+4. To cross-compile for an alternate architecture:
+   ```bash
+   # ARM64 (>= 11.0)
+   ant -Dos.prefix=darwin-aarch64
+
+   # x86 (<= 10.13)
+   ant -Dos.prefix=darwin-x86
+
+   # x86_64
+   ant -Dos.prefix=darwin-x86-64
+
+   # PPC (<= 10.5)
+   ant -Dos.prefix=darwin-ppc
+
+   # PPC64
+   ant -Dos.prefix=darwin-ppc64
+   ```
+
+### Troubleshooting
+
+
 * Xcode - If you only have the Xcode command line tools installed, and not the full Xcode UI, you may see build errors like this:
 
         native: