Address Soha's feedback.

* Describe BUILD_ variables.
* Discuss CMAKE_BUILD_TYPE, and building in both Debug and Release modes.
* Mention `make doxygen` for UNIX.

See PR #144