CMake documentation is still lacking

[DavidZemon]

The CMake documentation is still not what it should be. It needs to be reviewed with a very find-toothed comb and updated. Some parts will need a complete re-write, while others may just need some typos fixed.