Fix compatibility with CMake 3 and require a C++11 compiler

- Re-enabled valgrind on OSX.
- Using -stdlib=libc++ by default on OSX.
- Some documentation tweaks.