CMake/Modules/CMakeSystemSpecificInitialize.cmake

# Distributed under the OSI-approved BSD 3-Clause License.  See accompanying
# file Copyright.txt or https://cmake.org/licensing for details.


# This file is included by cmGlobalGenerator::EnableLanguage.
# It is included before the compiler has been determined.

# The CMAKE_EFFECTIVE_SYSTEM_NAME is used to load compiler and compiler
# wrapper configuration files. By default it equals to CMAKE_SYSTEM_NAME
# but could be overridden in the ${CMAKE_SYSTEM_NAME}-Initialize files.
#
# It is useful to share the same aforementioned configuration files and
# avoids duplicating them in case of tightly related platforms.
#
# An example are the platforms supported by Xcode (macOS, iOS, tvOS,
# and watchOS). For all of those the CMAKE_EFFECTIVE_SYSTEM_NAME is
# set to Apple which results in using
# Platform/Apple-AppleClang-CXX.cmake for the Apple C++ compiler.
set(CMAKE_EFFECTIVE_SYSTEM_NAME "${CMAKE_SYSTEM_NAME}")

include(Platform/${CMAKE_SYSTEM_NAME}-Initialize OPTIONAL)

set(CMAKE_SYSTEM_SPECIFIC_INITIALIZE_LOADED 1)
Simplify CMake per-source license notices Per-source copyright/license notice headers that spell out copyright holder names and years are hard to maintain and often out-of-date or plain wrong. Precise contributor information is already maintained automatically by the version control tool. Ultimately it is the receiver of a file who is responsible for determining its licensing status, and per-source notices are merely a convenience. Therefore it is simpler and more accurate for each source to have a generic notice of the license name and references to more detailed information on copyright holders and full license terms. Our `Copyright.txt` file now contains a list of Contributors whose names appeared source-level copyright notices. It also references version control history for more precise information. Therefore we no longer need to spell out the list of Contributors in each source file notice. Replace CMake per-source copyright/license notice headers with a short description of the license and links to `Copyright.txt` and online information available from "https://cmake.org/licensing". The online URL also handles cases of modules being copied out of our source into other projects, so we can drop our notices about replacing links with full license text. Run the `Utilities/Scripts/filter-notices.bash` script to perform the majority of the replacements mechanically. Manually fix up shebang lines and trailing newlines in a few files. Manually update the notices in a few files that the script does not handle. 2016-09-27 19:01:08 +00:00			`# Distributed under the OSI-approved BSD 3-Clause License. See accompanying`
			`# file Copyright.txt or https://cmake.org/licensing for details.`
Add platform-specific initialization step when enabling languages Create a Modules/CMakeSystemSpecificInitialize.cmake module loaded after CMakeSystem.cmake but before per-language initialization. Use it to load an optional Platform/<os>-Initialize.cmake module. This will be useful to do per-platform initialization that does not depend on the language and use the results when enabling specific languages. 2014-04-29 13:14:45 +00:00

			`# This file is included by cmGlobalGenerator::EnableLanguage.`
			`# It is included before the compiler has been determined.`

Modules: Introduce CMAKE_EFFECTIVE_SYSTEM_NAME to lookup compiler info Create a `CMAKE_EFFECTIVE_SYSTEM_NAME` variable to use for looking up compiler information modules instead of using `CMAKE_SYSTEM_NAME` directly. This will allow multiple platforms to share the same set of compiler information modules without spelling out all of them. Issue: #17870 2018-04-01 20:49:59 +00:00			`# The CMAKE_EFFECTIVE_SYSTEM_NAME is used to load compiler and compiler`
			`# wrapper configuration files. By default it equals to CMAKE_SYSTEM_NAME`
			`# but could be overridden in the ${CMAKE_SYSTEM_NAME}-Initialize files.`
			`#`
			`# It is useful to share the same aforementioned configuration files and`
			`# avoids duplicating them in case of tightly related platforms.`
Apple: Use CMAKE_EFFECTIVE_SYSTEM_NAME to share compiler info Apple platforms macOS, iOS, tvOS, and watchOS can all share the same compiler information. Rename `Darwin-` modules to `Apple-` and load them all through `CMAKE_EFFECTIVE_SYSTEM_NAME`. This saves duplication of 4 * 21 compiler information modules. Issue: #17870 2018-04-01 20:49:59 +00:00			`#`
			`# An example are the platforms supported by Xcode (macOS, iOS, tvOS,`
			`# and watchOS). For all of those the CMAKE_EFFECTIVE_SYSTEM_NAME is`
			`# set to Apple which results in using`
Fix misc. typos Found via `codespell` and `grep` 2018-06-04 05:48:39 +00:00			`# Platform/Apple-AppleClang-CXX.cmake for the Apple C++ compiler.`
Modules: Introduce CMAKE_EFFECTIVE_SYSTEM_NAME to lookup compiler info Create a `CMAKE_EFFECTIVE_SYSTEM_NAME` variable to use for looking up compiler information modules instead of using `CMAKE_SYSTEM_NAME` directly. This will allow multiple platforms to share the same set of compiler information modules without spelling out all of them. Issue: #17870 2018-04-01 20:49:59 +00:00			`set(CMAKE_EFFECTIVE_SYSTEM_NAME "${CMAKE_SYSTEM_NAME}")`

Add platform-specific initialization step when enabling languages Create a Modules/CMakeSystemSpecificInitialize.cmake module loaded after CMakeSystem.cmake but before per-language initialization. Use it to load an optional Platform/<os>-Initialize.cmake module. This will be useful to do per-platform initialization that does not depend on the language and use the results when enabling specific languages. 2014-04-29 13:14:45 +00:00			`include(Platform/${CMAKE_SYSTEM_NAME}-Initialize OPTIONAL)`

			`set(CMAKE_SYSTEM_SPECIFIC_INITIALIZE_LOADED 1)`