Cpp: Document building with cmake

Documentation update for https://github.com/openmicroscopy/openmicroscopy/pull/2797

/cc: @emilroz @dpwrussell @joshmoore 

--rebased-to  #899