Cleanup generic compiler check macro documentation

This commit improves formatting and style of the documentation for the
general-purpose compiler check macros:

  CHECK_C_COMPILER_FLAG
  CHECK_C_SOURCE_COMPILES
  CHECK_C_SOURCE_RUNS
  CHECK_CXX_COMPILER_FLAG
  CHECK_CXX_SOURCE_COMPILES
  CHECK_CXX_SOURCE_RUNS

This sytle is more consistent with CMake command documentation.
It also looks nicer in the generated documentation text files.

6 files changed, 30 insertions, 36 deletions

diff --git a/Modules/CheckCCompilerFlag.cmake b/Modules/CheckCCompilerFlag.cmake
index 07fca64c35..c5c4eb195e 100644
--- a/Modules/CheckCCompilerFlag.cmake
+++ b/Modules/CheckCCompilerFlag.cmake
@@ -1,12 +1,10 @@
 # - Check whether the C compiler supports a given flag.
-# CHECK_C_COMPILER_FLAG(FLAG VARIABLE)
-#
-#  FLAG - the compiler flag
-#  VARIABLE - variable to store the result
-# 
-#  This actually calls the check_c_source_compiles macro.
-#  See help for CheckCSourceCompiles for a listing of variables
-#  that can modify the build.
+# CHECK_C_COMPILER_FLAG(<flag> <var>)
+#  <flag> - the compiler flag
+#  <var>  - variable to store the result
+# This internally calls the check_c_source_compiles macro.
+# See help for CheckCSourceCompiles for a listing of variables
+# that can modify the build.
 
 # Copyright (c) 2006, Alexander Neundorf, <neundorf@kde.org>
 #
diff --git a/Modules/CheckCSourceCompiles.cmake b/Modules/CheckCSourceCompiles.cmake
index 5435df4f66..41de73b53d 100644
--- a/Modules/CheckCSourceCompiles.cmake
+++ b/Modules/CheckCSourceCompiles.cmake
@@ -1,9 +1,7 @@
-# - Check if the C source code provided in the SOURCE argument compiles.
-# CHECK_C_SOURCE_COMPILES(SOURCE VAR)
-#
-#  SOURCE   - source code to try to compile
-#  VAR      - variable to store whether the source code compiled
-#
+# - Check if the given C source code compiles.
+# CHECK_C_SOURCE_COMPILES(<code> <var>)
+#  <code>       - source code to try to compile
+#  <var>        - variable to store whether the source code compiled
 # The following variables may be set before calling this macro to
 # modify the way the check is run:
 #
diff --git a/Modules/CheckCSourceRuns.cmake b/Modules/CheckCSourceRuns.cmake
index 11d625165a..3bd12e0c2e 100644
--- a/Modules/CheckCSourceRuns.cmake
+++ b/Modules/CheckCSourceRuns.cmake
@@ -1,9 +1,8 @@
-# - Check if the C source code provided in the SOURCE argument compiles and runs.
-# CHECK_C_SOURCE_RUNS(SOURCE VAR)
-#
-#  SOURCE   - source code to try to compile
-#  VAR      - variable to store the result, 1 for success, empty for failure
-#
+# - Check if the given C source code compiles and runs.
+# CHECK_C_SOURCE_RUNS(<code> <var>)
+#  <code>   - source code to try to compile
+#  <var>    - variable to store the result
+#             (1 for success, empty for failure)
 # The following variables may be set before calling this macro to
 # modify the way the check is run:
 #
diff --git a/Modules/CheckCXXCompilerFlag.cmake b/Modules/CheckCXXCompilerFlag.cmake
index 43ea9a64e5..cd728fa395 100644
--- a/Modules/CheckCXXCompilerFlag.cmake
+++ b/Modules/CheckCXXCompilerFlag.cmake
@@ -1,8 +1,10 @@
 # - Check whether the CXX compiler supports a given flag.
-# CHECK_CXX_COMPILER_FLAG(FLAG VARIABLE)
-#
-#  FLAG - the compiler flag
-#  VARIABLE - variable to store the result
+# CHECK_CXX_COMPILER_FLAG(<flag> <var>)
+#  <flag> - the compiler flag
+#  <var>  - variable to store the result
+# This internally calls the check_cxx_source_compiles macro.  See help
+# for CheckCXXSourceCompiles for a listing of variables that can
+# modify the build.
 
 # Copyright (c) 2006, Alexander Neundorf, <neundorf@kde.org>
 #
diff --git a/Modules/CheckCXXSourceCompiles.cmake b/Modules/CheckCXXSourceCompiles.cmake
index f987ebea4e..fedc53f9fd 100644
--- a/Modules/CheckCXXSourceCompiles.cmake
+++ b/Modules/CheckCXXSourceCompiles.cmake
@@ -1,9 +1,7 @@
-# - Check if the C++ source code provided in the SOURCE argument compiles.
-# CHECK_CXX_SOURCE_COMPILES(SOURCE VAR)
-#
-#  SOURCE - source code to try to compile
-#  VAR    - variable to store whether the source code compiled
-#
+# - Check if the given C++ source code compiles.
+# CHECK_CXX_SOURCE_COMPILES(<code> <var>)
+#  <code>       - source code to try to compile
+#  <var>        - variable to store whether the source code compiled
 # The following variables may be set before calling this macro to
 # modify the way the check is run:
 #
diff --git a/Modules/CheckCXXSourceRuns.cmake b/Modules/CheckCXXSourceRuns.cmake
index ef9aa71689..50017c330e 100644
--- a/Modules/CheckCXXSourceRuns.cmake
+++ b/Modules/CheckCXXSourceRuns.cmake
@@ -1,9 +1,8 @@
-# - Check if the C++ source code provided in the SOURCE argument compiles and runs.
-# CHECK_CXX_SOURCE_RUNS(SOURCE VAR)
-#
-#  SOURCE - source code to try to compile
-#  VAR    - variable to store the result, 1 for success, empty for failure
-#
+# - Check if the given C++ source code compiles and runs.
+# CHECK_CXX_SOURCE_RUNS(<code> <var>)
+#  <code>   - source code to try to compile
+#  <var>    - variable to store the result
+#             (1 for success, empty for failure)
 # The following variables may be set before calling this macro to
 # modify the way the check is run:
 #