Added doc to help devs work with CMake.  Fixed a couple of CMake utility functions to match naming convention.
Merge pull request #186 from Fraser999/MAID-603

Added doc to help devs work with CMake.  Fixed a couple of CMake utility...