From d706428c5a2898448908957206672019c0defd83 Mon Sep 17 00:00:00 2001
From: Sean Madsen <sean@seanmadsen.com>
Date: Sat, 14 Jan 2017 12:14:55 -0700
Subject: [PATCH] debugging - generaizing XDebug install instructions for OS X

---
 docs/dev-tools/debugging.md | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/docs/dev-tools/debugging.md b/docs/dev-tools/debugging.md
index a24e5a50..a89115ec 100644
--- a/docs/dev-tools/debugging.md
+++ b/docs/dev-tools/debugging.md
@@ -173,26 +173,34 @@ CiviCRM debugging.
 
 ### Installing XDebug
 
-Debian / Ubuntu Linux
+#### Debian / Ubuntu Linux
 
 ```bash
 sudo apt-get install php5-xdebug
 ```
 
-Red Hat / CentOS Linux
+#### Red Hat / CentOS Linux
 
 ```bash
 sudo yum install php-pecl* php-devel php-pear
 sudo pecl install Xdebug
 ```
 
-Mac OS X
+#### Mac OS X, general
+
+Specific installation steps will vary, due to the diversity of PHP installation sources (e.g. Apple's built-in PHP, brew, MAMP, XAMPP, AMPP, Vagrant, Bitnami, and MacPorts). The best way to install XDebug is to identify your specific PHP runtime and then search Google for "mamp xdebug" or "macports xdebug" as needed.
+
+#### Mac OS X, with PHP from MacPorts
 
 ```bash
 sudo port install php5-xdebug
 ```
 
-For other platforms and more details see [XDebug's installation instructions](http://xdebug.org/docs/install).
+#### Other platforms
+
+For more details see
+[XDebug's installation instructions](http://xdebug.org/docs/install).
+
 
 ### Setting up PHP to talk to XDebug
 
-- 
GitLab