Address Soha's feedback.

* Describe BUILD_ variables.
* Discuss CMAKE_BUILD_TYPE, and building in both Debug and Release modes.
* Mention `make doxygen` for UNIX.
Touch up formatting.
Merge pull request #147 from chrisdembia/readme-Soha-comments

Address Soha's feedback.