cmake/Help/variable/CMAKE_PROJECT_PROJECT-NAME_INCLUDE_BEFORE.rst

21 lines
956 B
ReStructuredText
Raw Normal View History

2020-08-30 11:54:41 +02:00
CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE_BEFORE
-------------------------------------------
2021-09-14 00:13:48 +02:00
.. versionadded:: 3.17
2024-04-14 22:45:38 +02:00
A CMake language file to be included as the first step of any
2020-08-30 11:54:41 +02:00
:command:`project` command calls that specify ``<PROJECT-NAME>`` as the project
name. This is intended for injecting custom code into project builds without
2022-08-04 22:12:04 +02:00
modifying their source. See :ref:`Code Injection` for a more detailed
discussion of files potentially included during a :command:`project` call.
2020-08-30 11:54:41 +02:00
2024-04-14 22:45:38 +02:00
.. versionadded:: 3.29
This variable can be a :ref:`semicolon-separated list <CMake Language Lists>`
of CMake language files to be included sequentially. It can also now refer to
module names to be found in :variable:`CMAKE_MODULE_PATH` or as a builtin
CMake module.
2020-08-30 11:54:41 +02:00
See also the :variable:`CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE`,
2022-08-04 22:12:04 +02:00
:variable:`CMAKE_PROJECT_INCLUDE`, :variable:`CMAKE_PROJECT_INCLUDE_BEFORE`,
and :variable:`CMAKE_PROJECT_TOP_LEVEL_INCLUDES` variables.