Merge topic 'doc-4.2-relnotes'

5e9722866a Help: Update Sphinx versionadded directives for 4.2 release
5c7e90d954 Help: Organize and revise 4.2 release notes
ec28123cb4 Help: Consolidate 4.2 release notes

Acked-by: Kitware Robot <[email protected]>
Merge-request: !11271

Help/envvar/CMAKE_FASTBUILD_VERBOSE_GENERATOR.rst

@@ -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

Help/generator/FASTBuild.rst

@@ -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>`_.
 

Help/prop_sf/JOB_POOL_COMPILE.rst

@@ -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

Help/release/4.2.rst

@@ -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`.

Help/release/dev/CheckTypeSize-RESULT_VARIABLE.rst

@@ -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>``.

Help/release/dev/ExternalProject.rst

@@ -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.

Help/release/dev/FindDevIL.rst

@@ -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.

Help/release/dev/FindPython-NumPy-target.rst

@@ -1,5 +0,0 @@
-FindPython-NumPy-target
------------------------
-
-* The ``Python::NumPy`` target does not depend on
-  the ``Python::Development.Module`` target. See policy :policy:`CMP0201`.

Help/release/dev/GenEx-COMPILER_LINKER.rst

@@ -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.

Help/release/dev/GenEx-TARGET_FILE_BASE_NAME-POSTFIX.rst

@@ -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.

Help/release/dev/UseSWIG-POSTFIX.rst

@@ -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.

Help/release/dev/cmake-copy-if-newer.rst

@@ -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.

Help/release/dev/cmake-parent-fix.rst

@@ -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`.

Help/release/dev/cmake_language_TRACE.rst

@@ -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.

Help/release/dev/codemodel-version-directory-target-objects.rst

@@ -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.

Help/release/dev/config-fix-matching.rst

@@ -1,5 +0,0 @@
-config-fix-matching
--------------------
-
-The :genex:`$<CONFIG:cfgs>` generator expression no longer matches multiple
-configurations.  See policy :policy:`CMP0199`.

Help/release/dev/cpack-nsis-crc-check.rst

@@ -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.

Help/release/dev/cpack-several-checksums.rst

@@ -1,4 +0,0 @@
-cpack-several-checksums
------------------------
-
-* :variable:`CPACK_PACKAGE_CHECKSUM` now supports multiple values.

Help/release/dev/cxxmodules-custom-import-std-metadata-file.rst

@@ -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.

Help/release/dev/define-msvc-char-set.rst

@@ -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`.

Help/release/dev/define-windll.rst

@@ -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`.

Help/release/dev/emscripten-platform.rst

@@ -1,5 +0,0 @@
-emscripten-platform
--------------------
-
-* CMake now supports :ref:`Cross Compiling for Emscripten` with simple
-  toolchain files.

Help/release/dev/fastbuild.rst

@@ -1,4 +0,0 @@
-FASTBuild
----------
-
-* The :generator:`FASTBuild` generator was added.

Help/release/dev/fileapi-direct-dependencies.rst

@@ -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.

Help/release/dev/find-modules.rst

@@ -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.

Help/release/dev/find-package-UNWIND_INCLUDE.rst

@@ -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.

Help/release/dev/genex-target-intermediate-dir.rst

@@ -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.

Help/release/dev/gtest-use-json-output-for-discovery.rst

@@ -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.

Help/release/dev/imported-config-selection.rst

@@ -1,5 +0,0 @@
-imported-config-selection
--------------------------
-
-Location and configuration selection for imported targets is now more
-consistent.  See policy :policy:`CMP0200`.

Help/release/dev/install-object-name-strategy.rst

@@ -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.

Help/release/dev/install-object-only-destination.rst

@@ -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.

Help/release/dev/ninja-per-source-job-pool.rst

@@ -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`.

Help/release/dev/object-name-properties.rst

@@ -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.

Help/release/dev/set_unset-CACHE.rst

@@ -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.

Help/release/dev/short-object-names.rst

@@ -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.

Help/release/dev/string-regex-quote.rst

@@ -1,5 +0,0 @@
-string-regex-quote
-------------------
-
-* The :command:`string(REGEX QUOTE)` command was added to
-  generate a regular expression exactly matching a string.

Help/release/dev/target-SKIP_LINTING.rst

@@ -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.

Help/release/dev/unity-filename-prefix.rst

@@ -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`.

Help/release/dev/vs14-deprecate.rst

@@ -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.

Help/release/dev/vs2026.rst

@@ -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.

Help/release/dev/wix-multi-cab.rst

@@ -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.

Help/release/index.rst

@@ -15,6 +15,7 @@ Releases
 .. toctree::
    :maxdepth: 1
 
+   4.2 <4.2>
    4.1 <4.1>
    4.0 <4.0>
    3.31 <3.31>

Help/variable/CMAKE_FASTBUILD_ALLOW_RESPONSE_FILE.rst

@@ -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>`_

Help/variable/CMAKE_FASTBUILD_CACHE_PATH.rst

@@ -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

Help/variable/CMAKE_FASTBUILD_CAPTURE_SYSTEM_ENV.rst

@@ -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.
 

Help/variable/CMAKE_FASTBUILD_CLANG_GCC_UPDATE_XLANG_ARG.rst

@@ -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>`_

Help/variable/CMAKE_FASTBUILD_CLANG_REWRITE_INCLUDES.rst

@@ -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>`_

Help/variable/CMAKE_FASTBUILD_COMPILER_EXTRA_FILES.rst

@@ -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.
 

Help/variable/CMAKE_FASTBUILD_ENV_OVERRIDES.rst

@@ -1,6 +1,8 @@
 CMAKE_FASTBUILD_ENV_OVERRIDES
 -----------------------------
 
+.. versionadded:: 4.2
+
 Allows overriding environment variables in the captured environment written to
 ``fbuild.bff``.
 

Help/variable/CMAKE_FASTBUILD_FORCE_RESPONSE_FILE.rst

@@ -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>`_

Help/variable/CMAKE_FASTBUILD_SOURCE_MAPPING.rst

@@ -1,6 +1,8 @@
 CMAKE_FASTBUILD_SOURCE_MAPPING
 ------------------------------
 
+.. versionadded:: 4.2
+
 Sets FASTBuild's ``SourceMapping_Experimental`` option.
 
 Example:

Help/variable/CMAKE_FASTBUILD_TRACK_BYPRODUCTS_AS_OUTPUT.rst

@@ -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

Help/variable/CMAKE_FASTBUILD_USE_DETERMINISTIC_PATHS.rst

@@ -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>`_

Help/variable/CMAKE_FASTBUILD_USE_LIGHTCACHE.rst

@@ -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).
 

Help/variable/CMAKE_FASTBUILD_USE_RELATIVE_PATHS.rst

@@ -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>`_

Help/variable/CMAKE_FASTBUILD_VERBOSE_GENERATOR.rst

@@ -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`