Cpp: Update to match the FindIce macro behaviour

Additionally, include links to the upstream cmake documentation
and add common cmake search variables which might be required.
Cpp: Capitalisation corrections
Merge pull request #947 from rleigh-dundee/cmake-ice2

Cpp: Update to match the FindIce macro behaviour