d929c35f08
We originally deprecated this module in commit v3.5.0-rc1~295^2 (CMakeForceCompiler: Deprecate this module and its macros, 2015-10-19). Then a use case was found to still require the module so the deprecation was reverted for CMake 3.5 by commit v3.5.0-rc3~4^2 (CMakeForceCompiler: De-deprecate until more use cases have alternatives, 2016-02-17). Since then `CMAKE_TRY_COMPILE_TARGET_TYPE` was introduced to provide an alternative solution for that use case. Deprecate the module again.
119 lines
4.3 KiB
CMake
119 lines
4.3 KiB
CMake
#.rst:
|
|
# CMakeForceCompiler
|
|
# ------------------
|
|
#
|
|
# Deprecated. Do not use.
|
|
#
|
|
# The macros provided by this module were once intended for use by
|
|
# cross-compiling toolchain files when CMake was not able to automatically
|
|
# detect the compiler identification. Since the introduction of this module,
|
|
# CMake's compiler identification capabilities have improved and can now be
|
|
# taught to recognize any compiler. Furthermore, the suite of information
|
|
# CMake detects from a compiler is now too extensive to be provided by
|
|
# toolchain files using these macros.
|
|
#
|
|
# One common use case for this module was to skip CMake's checks for a
|
|
# working compiler when using a cross-compiler that cannot link binaries
|
|
# without special flags or custom linker scripts. This case is now supported
|
|
# by setting the :variable:`CMAKE_TRY_COMPILE_TARGET_TYPE` variable in the
|
|
# toolchain file instead.
|
|
#
|
|
# -------------------------------------------------------------------------
|
|
#
|
|
# Macro CMAKE_FORCE_C_COMPILER has the following signature:
|
|
#
|
|
# ::
|
|
#
|
|
# CMAKE_FORCE_C_COMPILER(<compiler> <compiler-id>)
|
|
#
|
|
# It sets CMAKE_C_COMPILER to the given compiler and the cmake internal
|
|
# variable CMAKE_C_COMPILER_ID to the given compiler-id. It also
|
|
# bypasses the check for working compiler and basic compiler information
|
|
# tests.
|
|
#
|
|
# Macro CMAKE_FORCE_CXX_COMPILER has the following signature:
|
|
#
|
|
# ::
|
|
#
|
|
# CMAKE_FORCE_CXX_COMPILER(<compiler> <compiler-id>)
|
|
#
|
|
# It sets CMAKE_CXX_COMPILER to the given compiler and the cmake
|
|
# internal variable CMAKE_CXX_COMPILER_ID to the given compiler-id. It
|
|
# also bypasses the check for working compiler and basic compiler
|
|
# information tests.
|
|
#
|
|
# Macro CMAKE_FORCE_Fortran_COMPILER has the following signature:
|
|
#
|
|
# ::
|
|
#
|
|
# CMAKE_FORCE_Fortran_COMPILER(<compiler> <compiler-id>)
|
|
#
|
|
# It sets CMAKE_Fortran_COMPILER to the given compiler and the cmake
|
|
# internal variable CMAKE_Fortran_COMPILER_ID to the given compiler-id.
|
|
# It also bypasses the check for working compiler and basic compiler
|
|
# information tests.
|
|
#
|
|
# So a simple toolchain file could look like this:
|
|
#
|
|
# ::
|
|
#
|
|
# include (CMakeForceCompiler)
|
|
# set(CMAKE_SYSTEM_NAME Generic)
|
|
# CMAKE_FORCE_C_COMPILER (chc12 MetrowerksHicross)
|
|
# CMAKE_FORCE_CXX_COMPILER (chc12 MetrowerksHicross)
|
|
|
|
#=============================================================================
|
|
# Copyright 2007-2009 Kitware, Inc.
|
|
#
|
|
# Distributed under the OSI-approved BSD License (the "License");
|
|
# see accompanying file Copyright.txt for details.
|
|
#
|
|
# This software is distributed WITHOUT ANY WARRANTY; without even the
|
|
# implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
# See the License for more information.
|
|
#=============================================================================
|
|
# (To distribute this file outside of CMake, substitute the full
|
|
# License text for the above reference.)
|
|
|
|
macro(CMAKE_FORCE_C_COMPILER compiler id)
|
|
message(DEPRECATION "The CMAKE_FORCE_C_COMPILER macro is deprecated. "
|
|
"Instead just set CMAKE_C_COMPILER and allow CMake to identify the compiler.")
|
|
set(CMAKE_C_COMPILER "${compiler}")
|
|
set(CMAKE_C_COMPILER_ID_RUN TRUE)
|
|
set(CMAKE_C_COMPILER_ID ${id})
|
|
set(CMAKE_C_COMPILER_FORCED TRUE)
|
|
|
|
# Set old compiler id variables.
|
|
if(CMAKE_C_COMPILER_ID MATCHES "GNU")
|
|
set(CMAKE_COMPILER_IS_GNUCC 1)
|
|
endif()
|
|
endmacro()
|
|
|
|
macro(CMAKE_FORCE_CXX_COMPILER compiler id)
|
|
message(DEPRECATION "The CMAKE_FORCE_CXX_COMPILER macro is deprecated. "
|
|
"Instead just set CMAKE_CXX_COMPILER and allow CMake to identify the compiler.")
|
|
set(CMAKE_CXX_COMPILER "${compiler}")
|
|
set(CMAKE_CXX_COMPILER_ID_RUN TRUE)
|
|
set(CMAKE_CXX_COMPILER_ID ${id})
|
|
set(CMAKE_CXX_COMPILER_FORCED TRUE)
|
|
|
|
# Set old compiler id variables.
|
|
if("${CMAKE_CXX_COMPILER_ID}" MATCHES "GNU")
|
|
set(CMAKE_COMPILER_IS_GNUCXX 1)
|
|
endif()
|
|
endmacro()
|
|
|
|
macro(CMAKE_FORCE_Fortran_COMPILER compiler id)
|
|
message(DEPRECATION "The CMAKE_FORCE_Fortran_COMPILER macro is deprecated. "
|
|
"Instead just set CMAKE_Fortran_COMPILER and allow CMake to identify the compiler.")
|
|
set(CMAKE_Fortran_COMPILER "${compiler}")
|
|
set(CMAKE_Fortran_COMPILER_ID_RUN TRUE)
|
|
set(CMAKE_Fortran_COMPILER_ID ${id})
|
|
set(CMAKE_Fortran_COMPILER_FORCED TRUE)
|
|
|
|
# Set old compiler id variables.
|
|
if(CMAKE_Fortran_COMPILER_ID MATCHES "GNU")
|
|
set(CMAKE_COMPILER_IS_GNUG77 1)
|
|
endif()
|
|
endmacro()
|