Update docs with OS X build notes

Preliminary build notes tested on Mavericks. Thanks to Stuart for the testing and patches!