Updating read-me, as well as doing some formatting.
Adding documentation/read-me references to the OS X projects.
Merge branch 'master' into arc