X-Git-Url: https://review.openocd.org/gitweb?p=openocd.git;a=blobdiff_plain;f=README.OSX;h=979c64ba60944b507cffb3b9d4784ef4128bf0d7;hp=2a023f16fdc1148c50f1fc8e94f158805244c760;hb=6738e447c5c010c4b3451e3714df86e9ab653e1f;hpb=191a5736c202dfb784e86a8190edc64e80dc62e5

diff --git a/README.OSX b/README.OSX
index 2a023f16fd..979c64ba60 100644
--- a/README.OSX
+++ b/README.OSX
@@ -3,26 +3,47 @@ Building OpenOCD for OSX
 
 There are a few prerequisites you will need first:
 
-- Xcode 4 (install from the AppStore)
-- Command Line Tools (install from Xcode 4 -> Preferences -> Downloads)
-- MacPorts (http://www.macports.org/install.php)
+- Xcode 5 (install from the AppStore)
+- Command Line Tools (install from Xcode 5 -> Preferences -> Downloads)
+- Gentoo Prefix (http://www.gentoo.org/proj/en/gentoo-alt/prefix/bootstrap.xml)
   or
 - Homebrew (http://mxcl.github.io/homebrew/)
+  or
+- MacPorts (http://www.macports.org/install.php)
+
+
+With Gentoo Prefix you can build the release version or the latest
+devel version (-9999) the usual way described in the Gentoo
+documentation. Alternatively, install the prerequisites and build
+manually from the sources.
 
-libtool, automake, autoconf, pkg-config and libusb can be easily
-installed via MacPorts:
-  sudo port install libtool automake autoconf pkgconfig libusb [libusb-compat]
-or with Homebrew:
-  brew install libtool automake libusb [libusb-compat]
+
+With Homebrew you can either run:
+  brew install [--HEAD] openocd (where optional --HEAD asks brew to
+                                 install the current git version)
+    or
+  brew install libtool automake libusb [libusb-compat] [hidapi] [libftdi]
+    (to install the needed dependencies and then proceed with the
+     manual building procedure)
+
+
+For building with MacPorts you need to run:
+  sudo port install libtool automake autoconf pkgconfig \
+    libusb [libusb-compat] [libftdi1]
 
 You should also specify LDFLAGS and CPPFLAGS to allow configure to use
 MacPorts' libraries, so run configure like this:
   LDFLAGS=-L/opt/local/lib CPPFLAGS=-I/opt/local/include ./configure [options]
 
-If you're using Homebrew, no custom flags are necessary.
 
 See README for the generic building instructions.
 
-If you use an FTDI-based adapter and have the FTDI kext installed, you
-will need to unload it prior to using OpenOCD:
+If you're using a USB adapter and have a driver kext matched to it,
+you will need to unload it prior to running OpenOCD. E.g. with Apple
+driver (OS X 10.9 or later) for FTDI run:
+  sudo kextunload -b com.apple.driver.AppleUSBFTDI
+for FTDI vendor driver use:
   sudo kextunload FTDIUSBSerialDriver.kext
+
+To learn more on the topic please refer to the official libusb FAQ:
+https://github.com/libusb/libusb/wiki/FAQ