Add a note about OSX 10.10

Closes #28

1 files changed, 21 insertions, 0 deletions

diff --git a/README.md b/README.md
index b67cca6..b77c131 100644
--- a/README.md
+++ b/README.md
@@ -12,3 +12,24 @@ Rust bindings to libssh2
 [dependencies]
 ssh2 = "0.2"
 ```
+
+## Building on OSX 10.10+
+
+Currently libssh2 requires linking against OpenSSL, and to compile libssh2 it
+also needs to find the OpenSSL headers. On OSX 10.10+ the OpenSSL headers have
+been removed, but if you're using Homebrew you can install them via:
+
+```
+brew install openssl
+```
+
+To get this library to pick them up the [standard `rust-openssl`
+instructions][instr] can be used to transitively inform libssh2-sys about where
+the header files are:
+
+[instr]: https://github.com/sfackler/rust-openssl#osx
+
+```
+export OPENSSL_INCLUDE_DIR=`brew --prefix openssl`/include
+export OPENSSL_LIB_DIR=`brew --prefix openssl`/lib
+```