mirror of
https://github.com/Kitware/CMake.git
synced 2025-10-14 02:08:27 +08:00
Merge topic 'doc-4.2-relnotes'
5e9722866aHelp: Update Sphinx versionadded directives for 4.2 release5c7e90d954Help: Organize and revise 4.2 release notesec28123cb4Help: Consolidate 4.2 release notes Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !11271
This commit is contained in:
Brad King
@@ -1,6 +1,8 @@
|
||||
CMAKE_FASTBUILD_VERBOSE_GENERATOR
|
||||
---------------------------------
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
.. include:: include/ENV_VAR.rst
|
||||
|
||||
The ``CMAKE_FASTBUILD_VERBOSE_GENERATOR`` environment variable specifies a custom default
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
FASTBuild
|
||||
=========
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
Generates a ``fbuild.bff`` file, which can be used to build the project with
|
||||
`FASTBuild <https://www.fastbuild.org/docs/home.html>`_.
|
||||
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
JOB_POOL_COMPILE
|
||||
----------------
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
Ninja only: Pool used for compiling.
|
||||
|
||||
The number of parallel compile processes could be limited by defining
|
||||
|
||||
219
Help/release/4.2.rst
Normal file
219
Help/release/4.2.rst
Normal file
@@ -0,0 +1,219 @@
|
||||
CMake 4.2 Release Notes
|
||||
***********************
|
||||
|
||||
.. only:: html
|
||||
|
||||
.. contents::
|
||||
|
||||
Changes made since CMake 4.1 include the following.
|
||||
|
||||
New Features
|
||||
============
|
||||
|
||||
File-Based API
|
||||
--------------
|
||||
|
||||
* The :manual:`cmake-file-api(7)` "codemodel" version 2 ``version`` field has
|
||||
been updated to 2.9.
|
||||
|
||||
* The :manual:`cmake-file-api(7)` "codemodel" version 2 "target" and
|
||||
"directory" objects gained a new ``codemodelVersion`` field.
|
||||
|
||||
* The :manual:`cmake-file-api(7)` "codemodel" version 2 now includes imported
|
||||
targets and all interface library targets in its replies. Previously,
|
||||
imported targets were omitted, and only those interface targets that
|
||||
participated in the build system were included. The following changes
|
||||
support these new additions:
|
||||
|
||||
* The "target" object gained ``imported``, ``local``, and ``abstract`` fields.
|
||||
* The "target" object's ``type`` field can now also hold the value
|
||||
``UNKNOWN_LIBRARY``.
|
||||
* The "codemodel" object's ``configurations`` entries gained a new
|
||||
``abstractTargets`` array.
|
||||
* Entries in the ``directories`` and ``projects`` arrays of the "codemodel"
|
||||
object's ``configurations`` entries gained a new ``abstractTargetIndexes``
|
||||
array.
|
||||
|
||||
* The :manual:`cmake-file-api(7)` "codemodel" version 2 "target" object gained
|
||||
new ``linkLibraries``, ``interfaceLinkLibraries``, ``compileDependencies``,
|
||||
``interfaceCompileDependencies``, ``objectDependencies``, and
|
||||
``orderDependencies`` fields.
|
||||
|
||||
Generators
|
||||
----------
|
||||
|
||||
* The :generator:`Visual Studio 18 2026` generator was added. This is
|
||||
experimental and based on "Visual Studio 2026 Insiders" because this
|
||||
version of VS has not been released.
|
||||
|
||||
* The :generator:`FASTBuild` generator was added.
|
||||
|
||||
Platforms
|
||||
---------
|
||||
|
||||
* CMake now supports :ref:`Cross Compiling for Emscripten` with simple
|
||||
toolchain files.
|
||||
|
||||
Command-Line
|
||||
------------
|
||||
|
||||
* The :manual:`cmake(1)` command-line tool now supports
|
||||
``cmake -E copy_if_newer`` and ``cmake -E copy_directory_if_newer``
|
||||
subcommands to copy files based on timestamp comparison instead of
|
||||
content comparison. These commands copy files only if the source is
|
||||
newer than the destination, providing better performance for build
|
||||
systems compared to ``copy_if_different`` which compares file contents.
|
||||
|
||||
Commands
|
||||
--------
|
||||
|
||||
* The :command:`cmake_language(TRACE)` command was added to enable or
|
||||
disable tracing during script execution.
|
||||
|
||||
* The :command:`set(CACHE{<variable>}) <set(CACHE)>` and
|
||||
:command:`unset(CACHE{<variable>}) <unset(CACHE)>` commands were added to
|
||||
explicitly set and unset cache entries.
|
||||
|
||||
* The :command:`string(REGEX QUOTE)` command was added to
|
||||
generate a regular expression exactly matching a string.
|
||||
|
||||
Variables
|
||||
---------
|
||||
|
||||
* The :variable:`CMAKE_CXX_STDLIB_MODULES_JSON` variable was added to set
|
||||
the path to the ``import std`` metadata file for the standard library
|
||||
rather than using the compiler to discover its location.
|
||||
|
||||
* The :variable:`CMAKE_INTERMEDIATE_DIR_STRATEGY` variable and corresponding
|
||||
:envvar:`CMAKE_INTERMEDIATE_DIR_STRATEGY` environment variable were added
|
||||
to change the strategy used to name intermediate directories used for
|
||||
object files and other associated target metadata.
|
||||
|
||||
* The :variable:`CMAKE_AUTOGEN_INTERMEDIATE_DIR_STRATEGY` variable and
|
||||
corresponding :envvar:`CMAKE_AUTOGEN_INTERMEDIATE_DIR_STRATEGY` environment
|
||||
variable were added to change the strategy used to name intermediate
|
||||
directories used for :manual:`Qt Autogen <cmake-qt(7)>` files.
|
||||
|
||||
* The :variable:`CMAKE_SKIP_LINTING` variable and corresponding
|
||||
:prop_tgt:`SKIP_LINTING` target property were added to tell the
|
||||
:ref:`Command-Line Build Tool Generators` to skip linting all
|
||||
sources in a target.
|
||||
|
||||
Properties
|
||||
----------
|
||||
|
||||
* The :prop_sf:`INSTALL_OBJECT_NAME` source file property was added to
|
||||
control names of installed object files for specific compiled sources.
|
||||
|
||||
* The :prop_tgt:`INSTALL_OBJECT_NAME_STRATEGY` target property was added
|
||||
to control the naming strategy for installed object files.
|
||||
|
||||
* The :prop_tgt:`INSTALL_OBJECT_ONLY_USE_DESTINATION` target property was
|
||||
added to more precisely control the installation path for object files.
|
||||
|
||||
* The :prop_sf:`JOB_POOL_COMPILE` source file property was added
|
||||
to assign individual source compilations to :prop_gbl:`JOB_POOLS`.
|
||||
|
||||
* The :prop_sf:`OBJECT_NAME` source file property was added to control
|
||||
object names of compiled source files.
|
||||
|
||||
* The :prop_tgt:`UNITY_BUILD_FILENAME_PREFIX` target property was added
|
||||
to control names of source files generated by :prop_tgt:`UNITY_BUILD`.
|
||||
|
||||
Modules
|
||||
-------
|
||||
|
||||
* Nearly all find modules now provide a ``<PackageName>_VERSION`` result
|
||||
variable matching the casing of its module name. Existing variants such as
|
||||
``<PackageName>_VERSION_STRING`` and uppercased ``<PACKAGENAME>_VERSION``
|
||||
are deprecated. See documentation of each find module for details.
|
||||
|
||||
* The :module:`CheckTypeSize` module's :command:`check_type_size` command
|
||||
gained a new ``RESULT_VARIABLE`` keyword to customize the result variable
|
||||
name instead of the default ``HAVE_<size-var>``.
|
||||
|
||||
* The :module:`ExternalProject` module's :command:`ExternalProject_Add`
|
||||
and :command:`ExternalProject_Add_Step` commands now provide options to set
|
||||
environment variables on the configure, build, install, and test steps.
|
||||
|
||||
* The :module:`FindPython3`, :module:`FindPython2`, and :module:`FindPython`
|
||||
modules no longer make ``NumPy`` depend on ``Development.Module``.
|
||||
See policy :policy:`CMP0201`.
|
||||
|
||||
* The :module:`GoogleTest` module's :command:`gtest_discover_tests()`
|
||||
command now sets the ``DEF_SOURCE_LINE`` test property for each
|
||||
discovered test if gtest supports the ``--gtest_output=json`` option.
|
||||
This test property is used by some IDEs to locate the source for each test.
|
||||
|
||||
* The :module:`UseSWIG` module's :command:`swig_add_library` command gained a
|
||||
``DEBUG_POSTFIX`` option to control the :prop_tgt:`DEBUG_POSTFIX` target
|
||||
property.
|
||||
|
||||
Generator Expressions
|
||||
---------------------
|
||||
|
||||
* The :genex:`<LANG>_COMPILER_LINKER_ID <C_COMPILER_LINKER_ID>` and
|
||||
:genex:`<LANG>_COMPILER_LINKER_FRONTEND_VARIANT <C_COMPILER_LINKER_FRONTEND_VARIANT>`
|
||||
families of generator expressions were added to access the value of the
|
||||
associated :variable:`CMAKE_<LANG>_COMPILER_LINKER_ID` and
|
||||
:variable:`CMAKE_<LANG>_COMPILER_LINKER_FRONTEND_VARIANT` variables.
|
||||
|
||||
* The :genex:`TARGET_FILE_BASE_NAME`, :genex:`TARGET_IMPORT_FILE_BASE_NAME`,
|
||||
:genex:`TARGET_LINKER_FILE_BASE_NAME`,
|
||||
:genex:`TARGET_LINKER_LIBRARY_FILE_BASE_NAME`,
|
||||
:genex:`TARGET_LINKER_IMPORT_FILE_BASE_NAME`, and
|
||||
:genex:`TARGET_PDB_FILE_BASE_NAME`
|
||||
generator expressions gained a ``POSTFIX`` option to control the inclusion
|
||||
of the :prop_tgt:`<CONFIG>_POSTFIX` target property as part of the base
|
||||
names of the corresponding files.
|
||||
|
||||
* The :genex:`TARGET_INTERMEDIATE_DIR` generator expression was
|
||||
added to refer to a target's intermediate files directory in
|
||||
the build tree.
|
||||
|
||||
CPack
|
||||
-----
|
||||
|
||||
* The :variable:`CPACK_PACKAGE_CHECKSUM` variable now supports multiple values.
|
||||
|
||||
* The :cpack_gen:`CPack NSIS Generator` gained a
|
||||
:variable:`CPACK_NSIS_CRC_CHECK` variable for setting the ``CRCCheck``
|
||||
attribute.
|
||||
|
||||
* The :cpack_gen:`CPack WIX Generator` gained a
|
||||
:variable:`CPACK_WIX_CAB_PER_COMPONENT` variable to enable one ``.cab``
|
||||
per component.
|
||||
|
||||
Deprecated and Removed Features
|
||||
===============================
|
||||
|
||||
* The uppercased ``<PACKAGENAME>_FOUND`` result variables of find modules
|
||||
are now deprecated in favor of ``<PackageName>_FOUND`` result variables,
|
||||
where appropriate. See documentation of each find module for details.
|
||||
|
||||
* The :module:`FindwxWidgets` module's result variable
|
||||
``wxWidgets_USE_FILE`` is now deprecated in favor of including the
|
||||
:module:`UsewxWidgets` module directly.
|
||||
|
||||
* The :generator:`Visual Studio 14 2015` generator is now deprecated
|
||||
and will be removed in a future version of CMake.
|
||||
|
||||
Other Changes
|
||||
=============
|
||||
|
||||
* The :genex:`$<CONFIG:cfgs>` generator expression no longer matches multiple
|
||||
configurations. See policy :policy:`CMP0199`.
|
||||
|
||||
* Selection of configuration and location of imported targets is now more
|
||||
consistent. See policy :policy:`CMP0200`.
|
||||
|
||||
* The :variable:`CMAKE_PARENT_LIST_FILE` variable is no longer defined when
|
||||
processing a ``CMakeLists.txt`` file. See policy :policy:`CMP0198`.
|
||||
|
||||
* For builds targeting the MSVC ABI, all generators now add the ``_MBCS``
|
||||
preprocessor definition when compiling sources unless ``_UNICODE`` or
|
||||
``_SBCS`` is found. See policy :policy:`CMP0204`.
|
||||
|
||||
* For builds targeting the MSVC ABI, all generators now add the ``_WINDLL``
|
||||
preprocessor definition when compiling sources in shared libraries.
|
||||
See policy :policy:`CMP0203`.
|
||||
@@ -1,6 +0,0 @@
|
||||
CheckTypeSize
|
||||
-------------
|
||||
|
||||
* The :module:`CheckTypeSize` module's command :command:`check_type_size`
|
||||
gained a new argument ``RESULT_VARIABLE`` to customize the result variable
|
||||
name instead of the default ``HAVE_<size-var>``.
|
||||
@@ -1,6 +0,0 @@
|
||||
ExternalProject
|
||||
---------------
|
||||
|
||||
* The :module:`ExternalProject` module's commands :command:`ExternalProject_Add`
|
||||
and :command:`ExternalProject_Add_Step` now provide options to set
|
||||
environment variables on the configure, build, install, and test steps.
|
||||
@@ -1,6 +0,0 @@
|
||||
FindDevIL
|
||||
---------
|
||||
|
||||
* The :module:`FindDevIL` module now provides a ``DevIL_VERSION`` result
|
||||
variable and version argument and version range can be specified by
|
||||
:command:`find_package`, when finding the DevIL package.
|
||||
@@ -1,5 +0,0 @@
|
||||
FindPython-NumPy-target
|
||||
-----------------------
|
||||
|
||||
* The ``Python::NumPy`` target does not depend on
|
||||
the ``Python::Development.Module`` target. See policy :policy:`CMP0201`.
|
||||
@@ -1,8 +0,0 @@
|
||||
GenEx-COMPILER_LINKER
|
||||
---------------------
|
||||
|
||||
* The :genex:`<LANG>_COMPILER_LINKER_ID <C_COMPILER_LINKER_ID>` and
|
||||
:genex:`<LANG>_COMPILER_LINKER_FRONTEND_VARIANT <C_COMPILER_LINKER_FRONTEND_VARIANT>`
|
||||
families of generator expressions were added to access the value of the
|
||||
associated :variable:`CMAKE_<LANG>_COMPILER_LINKER_ID` and
|
||||
:variable:`CMAKE_<LANG>_COMPILER_LINKER_FRONTEND_VARIANT` variables.
|
||||
@@ -1,11 +0,0 @@
|
||||
GenEx-TARGET_FILE_BASE_NAME-POSTFIX
|
||||
-----------------------------------
|
||||
|
||||
* The :genex:`TARGET_FILE_BASE_NAME`, :genex:`TARGET_IMPORT_FILE_BASE_NAME`,
|
||||
:genex:`TARGET_LINKER_FILE_BASE_NAME`,
|
||||
:genex:`TARGET_LINKER_LIBRARY_FILE_BASE_NAME`,
|
||||
:genex:`TARGET_LINKER_IMPORT_FILE_BASE_NAME`, and
|
||||
:genex:`TARGET_PDB_FILE_BASE_NAME`
|
||||
generator expressions gained the option ``POSTFIX`` to control the inclusion
|
||||
or not of the :prop_tgt:`<CONFIG>_POSTFIX` target property as part of the
|
||||
base name of the target.
|
||||
@@ -1,6 +0,0 @@
|
||||
UseSWIG-POSTFIX
|
||||
---------------
|
||||
|
||||
* The ``swig_add_library()`` command, from the :module:`UseSWIG` module, gained
|
||||
the option ``DEBUG_POSTFIX`` for the management of the
|
||||
:prop_tgt:`DEBUG_POSTFIX` target property.
|
||||
@@ -1,9 +0,0 @@
|
||||
cmake-copy-if-newer
|
||||
-------------------
|
||||
|
||||
* The :manual:`cmake(1)` command-line tool now supports
|
||||
``cmake -E copy_if_newer`` and ``cmake -E copy_directory_if_newer``
|
||||
subcommands to copy files based on timestamp comparison instead of
|
||||
content comparison. These commands copy files only if the source is
|
||||
newer than the destination, providing better performance for build
|
||||
systems compared to ``copy_if_different`` which compares file contents.
|
||||
@@ -1,5 +0,0 @@
|
||||
cmake-parent-fix
|
||||
----------------
|
||||
|
||||
* :variable:`CMAKE_PARENT_LIST_FILE` is no longer defined when processing
|
||||
a ``CMakeLists.txt`` file. See policy :policy:`CMP0198`.
|
||||
@@ -1,5 +0,0 @@
|
||||
cmake_language_TRACE
|
||||
--------------------
|
||||
|
||||
* The :command:`cmake_language` command gained a new ``TRACE`` subcommand
|
||||
to enable or disable tracing during script execution.
|
||||
@@ -1,8 +0,0 @@
|
||||
codemodel-version-directory-target-objects
|
||||
------------------------------------------
|
||||
|
||||
* The :manual:`cmake-file-api(7)` "codemodel" version 2 ``version`` field has
|
||||
been updated to 2.9.
|
||||
|
||||
* The :manual:`cmake-file-api(7)` "codemodel" version 2 "target" and
|
||||
"directory" objects gained a new ``codemodelVersion`` field.
|
||||
@@ -1,5 +0,0 @@
|
||||
config-fix-matching
|
||||
-------------------
|
||||
|
||||
The :genex:`$<CONFIG:cfgs>` generator expression no longer matches multiple
|
||||
configurations. See policy :policy:`CMP0199`.
|
||||
@@ -1,6 +0,0 @@
|
||||
cpack-nsis-crc-check
|
||||
--------------------
|
||||
|
||||
* The :cpack_gen:`CPack NSIS Generator` gained a new
|
||||
:variable:`CPACK_NSIS_CRC_CHECK` variable for setting the ``CRCCheck``
|
||||
attribute.
|
||||
@@ -1,4 +0,0 @@
|
||||
cpack-several-checksums
|
||||
-----------------------
|
||||
|
||||
* :variable:`CPACK_PACKAGE_CHECKSUM` now supports multiple values.
|
||||
@@ -1,7 +0,0 @@
|
||||
cxxmodules-custom-import-std-metadata-file
|
||||
------------------------------------------
|
||||
|
||||
* The ``import std`` support learned to use the
|
||||
:variable:`CMAKE_CXX_STDLIB_MODULES_JSON` variable to set the path to the
|
||||
metadata file for the standard library rather than using the compiler to
|
||||
discover its location.
|
||||
@@ -1,6 +0,0 @@
|
||||
define-msvc-char-set
|
||||
--------------------
|
||||
|
||||
* For builds targeting the MSVC ABI, all generators now add the ``_MBCS``
|
||||
preprocessor definition when compiling sources unless ``_UNICODE`` or ``_SBCS``
|
||||
is found. See policy :policy:`CMP0204`.
|
||||
@@ -1,6 +0,0 @@
|
||||
define-windll
|
||||
-------------
|
||||
|
||||
* For builds targeting the MSVC ABI, all generators now add the ``_WINDLL``
|
||||
preprocessor definition when compiling sources in shared libraries.
|
||||
See policy :policy:`CMP0203`.
|
||||
@@ -1,5 +0,0 @@
|
||||
emscripten-platform
|
||||
-------------------
|
||||
|
||||
* CMake now supports :ref:`Cross Compiling for Emscripten` with simple
|
||||
toolchain files.
|
||||
@@ -1,4 +0,0 @@
|
||||
FASTBuild
|
||||
---------
|
||||
|
||||
* The :generator:`FASTBuild` generator was added.
|
||||
@@ -1,22 +0,0 @@
|
||||
fileapi-direct-dependencies
|
||||
---------------------------
|
||||
|
||||
* The :manual:`cmake-file-api(7)` "codemodel" version 2 now includes imported
|
||||
targets and all interface library targets in its replies. Previously,
|
||||
imported targets were omitted, and only those interface targets that
|
||||
participated in the build system were included. The following changes
|
||||
support these new additions:
|
||||
|
||||
* The "target" object gained ``imported``, ``local``, and ``abstract`` fields.
|
||||
* The "target" object's ``type`` field can now also hold the value
|
||||
``UNKNOWN_LIBRARY``.
|
||||
* The "codemodel" object's ``configurations`` entries gained a new
|
||||
``abstractTargets`` array.
|
||||
* Entries in the ``directories`` and ``projects`` arrays of the "codemodel"
|
||||
object's ``configurations`` entries gained a new ``abstractTargetIndexes``
|
||||
array.
|
||||
|
||||
* The :manual:`cmake-file-api(7)` "codemodel" version 2 "target" object gained
|
||||
new ``linkLibraries``, ``interfaceLinkLibraries``, ``compileDependencies``,
|
||||
``interfaceCompileDependencies``, ``objectDependencies``, and
|
||||
``orderDependencies`` fields.
|
||||
@@ -1,15 +0,0 @@
|
||||
Find Modules
|
||||
------------
|
||||
|
||||
* The uppercased ``<PACKAGENAME>_FOUND`` result variables of find modules
|
||||
are now deprecated in favor of ``<PackageName>_FOUND`` result variables,
|
||||
where appropriate. See documentation of each find module for details.
|
||||
|
||||
* Nearly all find modules now provide a ``<PackageName>_VERSION`` result
|
||||
variable matching the casing of its module name. Existing variants such as
|
||||
``<PackageName>_VERSION_STRING`` and uppercased ``<PACKAGENAME>_VERSION``
|
||||
are deprecated. See documentation of each find module for details.
|
||||
|
||||
* The :module:`FindwxWidgets` module's result variable
|
||||
``wxWidgets_USE_FILE`` is now deprecated in favor of including the
|
||||
:module:`UsewxWidgets` module directly.
|
||||
@@ -1,6 +0,0 @@
|
||||
find-package-UNWIND_INCLUDE
|
||||
---------------------------
|
||||
|
||||
* The :command:`find_package()` command gained a new ``UNWIND_INCLUDE`` option
|
||||
to enable immediate :command:`return` from :command:`include()` commands
|
||||
after a failure to discover a transitive dependency.
|
||||
@@ -1,6 +0,0 @@
|
||||
genex-target-intermediate-dir
|
||||
-----------------------------
|
||||
|
||||
* The :genex:`TARGET_INTERMEDIATE_DIR` generator expression was
|
||||
added to refer to a target's intermediate files directory in
|
||||
the build tree.
|
||||
@@ -1,12 +0,0 @@
|
||||
gtest-use-json-output-for-discovery
|
||||
-----------------------------------
|
||||
|
||||
* The :command:`gtest_discover_tests()` command from the :module:`GoogleTest`
|
||||
module now sets the ``DEF_SOURCE_LINE`` test property for each discovered
|
||||
test if gtest supports the ``--gtest_output=json`` option. This test
|
||||
property is used by some IDEs to locate the source for each test.
|
||||
* The :command:`gtest_discover_tests()` command from the :module:`GoogleTest`
|
||||
module previously parsed certain type-parameterized test names incorrectly.
|
||||
Their names ended up with raw characters from gtest's output and were
|
||||
very obviously misparsed. Those names are now parsed correctly, so projects
|
||||
may see different test names to before for affected tests.
|
||||
@@ -1,5 +0,0 @@
|
||||
imported-config-selection
|
||||
-------------------------
|
||||
|
||||
Location and configuration selection for imported targets is now more
|
||||
consistent. See policy :policy:`CMP0200`.
|
||||
@@ -1,5 +0,0 @@
|
||||
install-object-name-strategy
|
||||
----------------------------
|
||||
|
||||
* The :prop_tgt:`INSTALL_OBJECT_NAME_STRATEGY` target property has been added
|
||||
to control the naming strategy for installed object files.
|
||||
@@ -1,5 +0,0 @@
|
||||
install-object-only-destination
|
||||
-------------------------------
|
||||
|
||||
* The :prop_tgt:`INSTALL_OBJECT_ONLY_USE_DESTINATION` target property has been
|
||||
added to more precisely control the installation path for object files.
|
||||
@@ -1,5 +0,0 @@
|
||||
ninja-per-source-job-pool
|
||||
-------------------------
|
||||
|
||||
* The :prop_sf:`JOB_POOL_COMPILE` source file property was added
|
||||
to assign individual source compilations to :prop_gbl:`JOB_POOLS`.
|
||||
@@ -1,8 +0,0 @@
|
||||
object-name-properties
|
||||
----------------------
|
||||
|
||||
* The :prop_sf:`OBJECT_NAME` source file property may be used to control
|
||||
object names of source files.
|
||||
|
||||
* The :prop_sf:`INSTALL_OBJECT_NAME` source file property may be used to
|
||||
control names of installed object files.
|
||||
@@ -1,5 +0,0 @@
|
||||
set-unset-CACHE
|
||||
---------------
|
||||
|
||||
* The :command:`set` and :command:`unset` commands gain the support of the
|
||||
``CACHE{<variable>}`` syntax to handle cache entries.
|
||||
@@ -1,13 +0,0 @@
|
||||
short-object-names
|
||||
------------------
|
||||
|
||||
* There is now the :variable:`CMAKE_INTERMEDIATE_DIR_STRATEGY` variable (and
|
||||
associated environment variable :envvar:`CMAKE_INTERMEDIATE_DIR_STRATEGY`)
|
||||
that may be used to change the strategy used to name intermediate
|
||||
directories used for object files (and other associated target metadata).
|
||||
|
||||
* There is now the :variable:`CMAKE_AUTOGEN_INTERMEDIATE_DIR_STRATEGY`
|
||||
variable (and associated environment variable
|
||||
:envvar:`CMAKE_AUTOGEN_INTERMEDIATE_DIR_STRATEGY`)
|
||||
that may be used to change the strategy used to name intermediate
|
||||
directories used for :manual:`Qt Autogen <cmake-qt(7)>` files.
|
||||
@@ -1,5 +0,0 @@
|
||||
string-regex-quote
|
||||
------------------
|
||||
|
||||
* The :command:`string(REGEX QUOTE)` command was added to
|
||||
generate a regular expression exactly matching a string.
|
||||
@@ -1,7 +0,0 @@
|
||||
target-SKIP_LINTING
|
||||
-------------------
|
||||
|
||||
* The :variable:`CMAKE_SKIP_LINTING` variable and corresponding
|
||||
:prop_tgt:`SKIP_LINTING` target property were added to tell the
|
||||
:ref:`Command-Line Build Tool Generators` to skip linting all
|
||||
sources in a target.
|
||||
@@ -1,5 +0,0 @@
|
||||
unity-filename-prefix
|
||||
---------------------
|
||||
|
||||
* The :prop_tgt:`UNITY_BUILD_FILENAME_PREFIX` target property was added
|
||||
to control names of source files generated by :prop_tgt:`UNITY_BUILD`.
|
||||
@@ -1,5 +0,0 @@
|
||||
vs14-deprecate
|
||||
--------------
|
||||
|
||||
* The :generator:`Visual Studio 14 2015` generator is now deprecated
|
||||
and will be removed in a future version of CMake.
|
||||
@@ -1,6 +0,0 @@
|
||||
vs2026
|
||||
------
|
||||
|
||||
* The :generator:`Visual Studio 18 2026` generator was added. This is
|
||||
experimental and based on "Visual Studio 2026 Insiders" because this
|
||||
version of VS has not been released.
|
||||
@@ -1,6 +0,0 @@
|
||||
wix-multi-cab
|
||||
-------------
|
||||
|
||||
* :variable:`CPACK_WIX_CAB_PER_COMPONENT` allows CPack WIX opt-in generation of one
|
||||
`.cab` file per component. Having multiple `.cab` files may improve the time it takes
|
||||
to generate installers and may also work around per `.cab` size constraints.
|
||||
@@ -15,6 +15,7 @@ Releases
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
|
||||
4.2 <4.2>
|
||||
4.1 <4.1>
|
||||
4.0 <4.0>
|
||||
3.31 <3.31>
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
CMAKE_FASTBUILD_ALLOW_RESPONSE_FILE
|
||||
-----------------------------------
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
Enables FASTBuild's ``AllowResponseFile`` option.
|
||||
|
||||
See the `FASTBuild Compiler() documentation <https://www.fastbuild.org/docs/functions/compiler.html>`_
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
CMAKE_FASTBUILD_CACHE_PATH
|
||||
--------------------------
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
Specifies the directory for the FASTBuild artifact cache in the generated file.
|
||||
|
||||
If not set, FASTBuild will use the ``FASTBUILD_CACHE_PATH`` environment
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
CMAKE_FASTBUILD_CAPTURE_SYSTEM_ENV
|
||||
----------------------------------
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
Controls capturing of the system environment into ``fbuild.bff``.
|
||||
Setting it to ``OFF`` makes the invocation of all tools (compilers and other external processes) hermetic.
|
||||
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
CMAKE_FASTBUILD_CLANG_GCC_UPDATE_XLANG_ARG
|
||||
------------------------------------------
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
Enables FASTBuild's ``ClangGCCUpdateXLanguageArg`` option.
|
||||
|
||||
See the `FASTBuild Compiler() documentation <https://www.fastbuild.org/docs/functions/compiler.html>`_
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
CMAKE_FASTBUILD_CLANG_REWRITE_INCLUDES
|
||||
--------------------------------------
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
Enables FASTBuild's ``ClangRewriteIncludes`` option.
|
||||
|
||||
See the `FASTBuild Compiler() documentation <https://www.fastbuild.org/docs/functions/compiler.html>`_
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
CMAKE_FASTBUILD_COMPILER_EXTRA_FILES
|
||||
-------------------------------------
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
Specifies a semicolon-separated list of additional files (usually DLLs) to
|
||||
include in the FASTBuild ``Compiler()`` node.
|
||||
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
CMAKE_FASTBUILD_ENV_OVERRIDES
|
||||
-----------------------------
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
Allows overriding environment variables in the captured environment written to
|
||||
``fbuild.bff``.
|
||||
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
CMAKE_FASTBUILD_FORCE_RESPONSE_FILE
|
||||
-----------------------------------
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
Enables FASTBuild's ``ForceResponseFile`` option.
|
||||
|
||||
See the `FASTBuild Compiler() documentation <https://www.fastbuild.org/docs/functions/compiler.html>`_
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
CMAKE_FASTBUILD_SOURCE_MAPPING
|
||||
------------------------------
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
Sets FASTBuild's ``SourceMapping_Experimental`` option.
|
||||
|
||||
Example:
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
CMAKE_FASTBUILD_TRACK_BYPRODUCTS_AS_OUTPUT
|
||||
------------------------------------------
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
By default, custom commands declaring only ``BYPRODUCTS`` will always
|
||||
run unconditionally.
|
||||
You can use this variable to make FASTBuild rerun the command only when its
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
CMAKE_FASTBUILD_USE_DETERMINISTIC_PATHS
|
||||
---------------------------------------
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
Enables FASTBuild's ``UseDeterministicPaths_Experimental`` option.
|
||||
|
||||
See the `FASTBuild Compiler() documentation <https://www.fastbuild.org/docs/functions/compiler.html>`_
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
CMAKE_FASTBUILD_USE_LIGHTCACHE
|
||||
-------------------------------
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
Enables FASTBuild’s *light caching* mode, which accelerates cache lookups by
|
||||
parsing source files directly (instead of invoking the compiler preprocessor).
|
||||
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
CMAKE_FASTBUILD_USE_RELATIVE_PATHS
|
||||
----------------------------------
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
Enables FASTBuild's ``UseRelativePaths_Experimental`` option.
|
||||
|
||||
See the `FASTBuild Compiler() documentation <https://www.fastbuild.org/docs/functions/compiler.html>`_
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
CMAKE_FASTBUILD_VERBOSE_GENERATOR
|
||||
----------------------------------
|
||||
|
||||
.. versionadded:: 4.2
|
||||
|
||||
Enables verbose logging during FASTBuild file generation.
|
||||
|
||||
Initialized by the :envvar:`CMAKE_FASTBUILD_VERBOSE_GENERATOR`
|
||||
|
||||
Reference in New Issue
Block a user