The CheckSourceCompiles and CheckCompilerFlag would generally be preferred general command syntax, but users may not realize they exist, so help point them there.
@@ -27,6 +27,8 @@ rather than performing the check again, even if the ``<code>`` changes. In
order to force the check to be re-evaluated, the variable named by
``<resultVar>`` must be manually removed from the cache.
+See also :command:`check_compiler_flag` for a more general command syntax.
+
The compile and link commands can be influenced by setting any of the
following variables prior to calling ``check_c_compiler_flag()``
@@ -28,6 +28,8 @@ Check once if C source code can be built.
``STATIC_LIBRARY``, the source is compiled but not linked. In any case, all
functions must be declared as usual.
+ See also :command:`check_source_compiles` for a more general command syntax.
See also :command:`check_source_runs` to run compiled source.
@@ -27,6 +27,8 @@ subsequently be run.
+ See also :command:`check_source_runs` for a more general command syntax.
following variables prior to calling ``check_c_source_runs()``:
@@ -21,6 +21,8 @@ A positive result from this check indicates only that the compiler did not
issue a diagnostic message when given the flag. Whether the flag has any
effect or even a specific one is beyond the scope of this module.
.. note::
Since the :command:`try_compile` command forwards flags from variables
like :variable:`CMAKE_CXX_FLAGS <CMAKE_<LANG>_FLAGS>`, unknown flags
@@ -28,6 +28,8 @@ Check once if C++ source code can be built.
following variables prior to calling ``check_cxx_source_runs()``:
@@ -29,6 +29,8 @@ rather than performing the check again, even if the ``<code>`` changes. In
following variables prior to calling ``check_fortran_compiler_flag()``
@@ -30,6 +30,8 @@ Check once if Fortran source code can be built.
``SRC_EXT`` option can be used to override this with ``.<extension>`` instead--
``.F90`` is a typical choice.
Internally, :command:`try_compile` is used to compile the source. If
@@ -49,6 +49,8 @@ subsequently be run.
following variables prior to calling ``check_fortran_source_runs()``:
following variables prior to calling ``check_objc_compiler_flag()``
@@ -30,6 +30,8 @@ Check once if Objective-C source can be built.
@@ -29,6 +29,8 @@ subsequently be run.
following variables prior to calling ``check_objc_source_runs()``
following variables prior to calling ``check_objcxx_compiler_flag()``
@@ -30,6 +30,8 @@ Check once if Objective-C++ source can be built.
following variables prior to calling ``check_objcxx_source_runs()``