Added doc to help devs work with CMake.  Fixed a couple of CMake utility functions to match naming convention.