Check*CompilerFlag: Rewrite documentation of these modules

Brad Kingrequested to merge
brad.king/cmake:doc-check-compiler-flag into master

Format with modern markup. Clarify that the setting of CMAKE_REQUIRED_DEFINITIONS is temporary. Add a note warning about contamination of the checks by CMAKE_<LANG>_FLAGS.

Issue: #16973

Merge request reports