mirror/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2026-05-07 06:40:16 -05:00
Code Issues Packages Projects Releases Wiki Activity

Help: Organize and revise 4.1 release notes

Browse Source 
Add section headers similar to the 4.0 release notes and move each
individual bullet into an appropriate section.  Revise a few bullets.
This commit is contained in:
Brad King
2025-06-12 15:17:29 -04:00
parent f841c65b53
commit c00896a7f5
1 changed files with 162 additions and 109 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Help/release/4.1.rst
+162 -109
View File
@@ -7,15 +7,74 @@ CMake 4.1 Release Notes
Changes made since CMake 4.0 include the following. Changes made since CMake 4.0 include the following.
New Features
============
File-Based API
--------------
* The :manual:`cmake-file-api(7)` :ref:`v1 <file-api v1>` now writes
partial replies when buildsystem generation fails with an error.
See the :ref:`v1 Reply Error Index <file-api reply error index>`.
Generators
----------
* :ref:`Makefile Generators` and :ref:`Ninja Generators` gained support
for adding a linker launcher with ``Fortran``, ``CUDA``, and ``HIP``.
See the :variable:`CMAKE_<LANG>_LINKER_LAUNCHER` variable
and :prop_tgt:`<LANG>_LINKER_LAUNCHER` target property for details.
Command-Line
------------
* The :ref:`cmake --build <Build Tool Mode>` command-line tool, when used
with the :generator:`Xcode` generator, now detects when a third-party
tool has wrapped the generated ``.xcodeproj`` in a ``.xcworkspace``,
and drives the build through the workspace instead.
Configure Log
-------------
* The :manual:`cmake-configure-log(7)` now reports events from
:command:`find_package` (in ``CONFIG`` mode), :command:`find_path`,
:command:`find_file`, :command:`find_library`, and :command:`find_program`
commands when first invoked, when their results transition between
"not found" and "found", or when enabled explicitly by the
:option:`--debug-find <cmake --debug-find>` command-line option.
See :ref:`find configure-log event` and
:ref:`find_package configure-log event`. Logging may also be controlled
by the :variable:`CMAKE_FIND_DEBUG_MODE` and
:variable:`CMAKE_FIND_DEBUG_MODE_NO_IMPLICIT_CONFIGURE_LOG` variables.
Compilers
---------
* `Diab compilers from Wind River Systems`_, versions 5.9.x+, are now
supported with :variable:`compiler id <CMAKE_<LANG>_COMPILER_ID>` ``Diab``
for languages ``ASM``, ``C``, and ``CXX``.
.. _`Diab compilers from Wind River Systems`: https://www.windriver.com/resource/wind-river-diab-compiler-product-overview
Commands
--------
* The :command:`add_dependencies` command may be called with no dependencies. * The :command:`add_dependencies` command may be called with no dependencies.
* Enabling ``ASM`` no longer accidentally succeeds using ``MSVC``'s ``cl`` * The :command:`cmake_pkg_config` command now supports the ``IMPORT`` and
C compiler as an assembler. See policy :policy:`CMP0194`. ``POPULATE`` subcommands for interfacing CMake targets with pkg-config based
dependencies.
* The :prop_tgt:`AUTOMOC_INCLUDE_DIRECTORIES` target property and associated * The :command:`install(DIRECTORY)` command gained a new
:variable:`CMAKE_AUTOMOC_INCLUDE_DIRECTORIES` variable were added to ``EXCLUDE_EMPTY_DIRECTORIES`` option to skip installation
override the automatic discovery of moc includes from a target's transitive of empty directories.
include directories.
* The :command:`project` command now has experimental support for the
``COMPAT_VERSION`` keyword, gated by
``CMAKE_EXPERIMENTAL_EXPORT_PACKAGE_INFO``.
Variables
---------
* The :variable:`CMAKE_FIND_REQUIRED` variable was added to tell * The :variable:`CMAKE_FIND_REQUIRED` variable was added to tell
:command:`find_package`, :command:`find_path`, :command:`find_file`, :command:`find_package`, :command:`find_path`, :command:`find_file`,
@@ -23,17 +82,80 @@ Changes made since CMake 4.0 include the following.
by default. The commands also gained an ``OPTIONAL`` keyword to ignore by default. The commands also gained an ``OPTIONAL`` keyword to ignore
the variable for a specific call. the variable for a specific call.
* The :command:`cmake_pkg_config` command now supports the ``IMPORT`` and
``POPULATE`` subcommands for interfacing CMake targets with pkg-config based
dependencies.
* The :variable:`CMAKE_<LANG>_COMPILER_ARCHITECTURE_ID` variable is now * The :variable:`CMAKE_<LANG>_COMPILER_ARCHITECTURE_ID` variable is now
populated for most compilers, and documented for public use. populated for most compilers, and documented for public use.
* The :ref:`find configure-log event` ``find-v1`` has been added to * The :variable:`CMAKE_<LANG>_ICSTAT` variable and corresponding
:manual:`cmake-configure-log(7)` to track calls to the :command:`find_file`, :prop_tgt:`<LANG>_ICSTAT` target property were added to tell
:command:`find_path`, :command:`find_library`, and :command:`find_program` the :ref:`Makefile Generators` and the :ref:`Ninja Generators`
commands. to run the IAR ``icstat`` tool along with the compiler for
``C`` and ``CXX`` languages.
Environment Variables
---------------------
* The :envvar:`CMAKE_<LANG>_IMPLICIT_LINK_LIBRARIES_EXCLUDE` environment
variable was added to optionally exclude specific libraries from the
detected set of :variable:`CMAKE_<LANG>_IMPLICIT_LINK_LIBRARIES`.
Properties
----------
* The :prop_tgt:`AUTOMOC_INCLUDE_DIRECTORIES` target property and associated
:variable:`CMAKE_AUTOMOC_INCLUDE_DIRECTORIES` variable were added to
override the automatic discovery of moc includes from a target's transitive
include directories.
* The :prop_sf:`MACOSX_PACKAGE_LOCATION` source file property now
works when set on a source directory, and copies its entire tree
into the bundle.
* The :prop_tgt:`PDB_NAME` and :prop_tgt:`COMPILE_PDB_NAME` target properties
now support :manual:`generator expressions <cmake-generator-expressions(7)>`.
Modules
-------
* The :module:`FindASPELL` module now provides a version variable, imported
targets, and components to optionally select the Aspell library and
executable separately.
* The :module:`FindBLAS` and :module:`FindLAPACK` modules now support the
NVIDIA Performance Libraries (NVPL).
* The :module:`FindProtobuf` module's :command:`protobuf_generate(DEPENDENCIES)`
command argument now accepts multiple values.
* The :module:`FindProtobuf` module's :command:`protobuf_generate_cpp` and
:command:`protobuf_generate_python` commands, together with their
``Protobuf_IMPORT_DIRS`` and ``PROTOBUF_GENERATE_CPP_APPEND_PATH`` hint
variables, are now deprecated in favor of the :command:`protobuf_generate`
command.
Regular Expressions
-------------------
* The :command:`string(REGEX MATCHALL)`, :command:`string(REGEX REPLACE)`, and
:command:`list(TRANSFORM REPLACE)` commands now match the regular expression
``^`` anchor at most once in repeated searches, at the start of the input.
See policy :policy:`CMP0186`.
* The :command:`string(REGEX REPLACE)` command now allows references to
unmatched groups. They are replaced with empty strings.
* The :command:`string(REGEX MATCH)`, :command:`string(REGEX MATCHALL)`, and
:command:`string(REGEX REPLACE)` commands now allow zero-length matches.
CTest
-----
* :manual:`ctest(1)` gained a
:option:`--schedule-random-seed <ctest --schedule-random-seed>`
option to specify a numeric random seed to make
:option:`ctest --schedule-random` deterministic for reproduction.
CPack
-----
* The :cpack_gen:`CPack NuGet Generator` gained option * The :cpack_gen:`CPack NuGet Generator` gained option
:variable:`CPACK_NUGET_SYMBOL_PACKAGE` to generate NuGet :variable:`CPACK_NUGET_SYMBOL_PACKAGE` to generate NuGet
@@ -45,48 +167,35 @@ Changes made since CMake 4.0 include the following.
:variable:`CPACK_RPM_PACKAGE_SUPPLEMENTS` :variable:`CPACK_RPM_PACKAGE_SUPPLEMENTS`
variables to specify the corresponding RPM spec fields. variables to specify the corresponding RPM spec fields.
* :manual:`ctest(1)` gained a Deprecated and Removed Features
:option:`--schedule-random-seed <ctest --schedule-random-seed>` ===============================
option to specify a numeric random seed to make
:option:`ctest --schedule-random` deterministic for reproduction.
* `Diab compilers from Wind River Systems`_, versions 5.9.x+, are now
supported with :variable:`compiler id <CMAKE_<LANG>_COMPILER_ID>` ``Diab``
for languages ``ASM``, ``C``, and ``CXX``.
.. _`Diab compilers from Wind River Systems`: https://www.windriver.com/resource/wind-river-diab-compiler-product-overview
* The :module:`ExternalProject` module no longer checks the ``URL`` archive
file extension. Any archive type that :option:`cmake -E tar <cmake-E tar>`
can extract is now allowed.
* The :manual:`cmake-file-api(7)` :ref:`v1 <file-api v1>` now writes
partial replies when buildsystem generation fails with an error.
See the :ref:`v1 Reply Error Index <file-api reply error index>`.
* The :module:`FindASPELL` module now provides version variable, imported
targets, and components to optionally select Aspell library and executable
separately.
* The :module:`FindGTest` module's result variables ``GTEST_INCLUDE_DIRS``, * The :module:`FindGTest` module's result variables ``GTEST_INCLUDE_DIRS``,
``GTEST_LIBRARIES``, ``GTEST_MAIN_LIBRARIES``, and ``GTEST_BOTH_LIBRARIES`` ``GTEST_LIBRARIES``, ``GTEST_MAIN_LIBRARIES``, and ``GTEST_BOTH_LIBRARIES``
are now deprecated in favor of using ``GTest::gtest`` and are now deprecated in favor of using ``GTest::gtest`` and
``GTest::gtest_main`` imported targets. ``GTest::gtest_main`` imported targets.
* The :module:`FindProtobuf` module's :command:`protobuf_generate(DEPENDENCIES)` * The :module:`FindGCCXML` module has been deprecated via policy
command argument now accepts multiple values. :policy:`CMP0188`. Port projects to CastXML instead.
* The :module:`FindProtobuf` module's commands :command:`protobuf_generate_cpp`
and :command:`protobuf_generate_python` together with their hint variables
``Protobuf_IMPORT_DIRS`` and ``PROTOBUF_GENERATE_CPP_APPEND_PATH`` are now
deprecated in favor of :command:`protobuf_generate`.
* Modules :module:`FindPython3`, :module:`FindPython2` and :module:`FindPython` * The :module:`FindCABLE` module has been deprecated via policy
enforce consistency of artifacts in cross-compiling mode. This prevent mixing :policy:`CMP0191`.
host and target artifacts. See policy :policy:`CMP0190` for more information.
* The :genex:`TARGET_PROPERTY` generator expression now evaluates the * The :module:`CMakeDetermineVSServicePack` module has been deprecated
:prop_tgt:`LINK_LIBRARIES` and :prop_tgt:`INTERFACE_LINK_LIBRARIES` via policy :policy:`CMP0196`. Port projects to the
target properties transitively. See policy :policy:`CMP0189`. :variable:`CMAKE_<LANG>_COMPILER_VERSION` variable instead.
Other Changes
=============
* The :module:`ExternalProject` module no longer checks the ``URL`` archive
file extension. Any archive type that :option:`cmake -E tar <cmake-E tar>`
can extract is now allowed.
* Modules :module:`FindPython3`, :module:`FindPython2` and
:module:`FindPython` now enforce consistency of artifacts in
cross-compiling mode. This prevents mixing host and target artifacts.
See policy :policy:`CMP0190`.
* The :module:`GNUInstallDirs` module now prefers to default * The :module:`GNUInstallDirs` module now prefers to default
``SYSCONFDIR``, ``LOCALSTATEDIR``, and ``RUNSTATEDIR`` to ``SYSCONFDIR``, ``LOCALSTATEDIR``, and ``RUNSTATEDIR`` to
@@ -97,73 +206,17 @@ Changes made since CMake 4.0 include the following.
variables with their leading ``usr/`` for install prefix ``/``. variables with their leading ``usr/`` for install prefix ``/``.
See policy :policy:`CMP0193`. See policy :policy:`CMP0193`.
* The :variable:`CMAKE_<LANG>_ICSTAT` variable and corresponding
:prop_tgt:`<LANG>_ICSTAT` target property were added to tell
the :ref:`Makefile Generators` and the :ref:`Ninja Generators`
to run the IAR ``icstat`` tool along with the compiler for
``C`` and ``CXX`` languages.
* The :manual:`cmake-configure-log(7)` will report events from ``find_``
commands without any find-debug flags (e.g.,
:variable:`CMAKE_FIND_DEBUG_MODE`) when they transition between "found" and
"not found" or when they are first defined. The
:variable:`CMAKE_FIND_DEBUG_MODE_NO_IMPLICIT_CONFIGURE_LOG` variable will
suppress these events without any explicit request for a debug mode.
* The :envvar:`CMAKE_<LANG>_IMPLICIT_LINK_LIBRARIES_EXCLUDE` environment
variable was added to optionally exclude specific libraries from the
detected set of :variable:`CMAKE_<LANG>_IMPLICIT_LINK_LIBRARIES`.
* The :command:`install(DIRECTORY)` command gained a new
``EXCLUDE_EMPTY_DIRECTORIES`` option to skip installation
of empty directories.
* The :command:`install(TARGETS)` command no longer ignores file sets which * The :command:`install(TARGETS)` command no longer ignores file sets which
haven't been defined at the point it is called. The ordering of haven't been defined at the point it is called. The ordering of
:command:`target_sources(FILE_SET)` and ``install(TARGETS)`` is no longer :command:`target_sources(FILE_SET)` and ``install(TARGETS)`` is no longer
semantically relevant. semantically relevant.
* :ref:`Makefile Generators` and :ref:`Ninja Generators` gained support * Enabling ``ASM`` no longer accidentally succeeds using ``MSVC``'s ``cl``
for adding a linker launcher with ``Fortran``, ``CUDA``, and ``HIP``. C compiler as an assembler. See policy :policy:`CMP0194`.
See the :variable:`CMAKE_<LANG>_LINKER_LAUNCHER` variable
and :prop_tgt:`<LANG>_LINKER_LAUNCHER` target property for details.
* The :prop_sf:`MACOSX_PACKAGE_LOCATION` source file property now
works when set on a source directory, and copies its entire tree
into the bundle.
* The MSVC link ``-machine:`` flag is no longer added to the * The MSVC link ``-machine:`` flag is no longer added to the
``CMAKE_*_LINKER_FLAGS`` variables. See policy :policy:`CMP0197`. ``CMAKE_*_LINKER_FLAGS`` variables. See policy :policy:`CMP0197`.
* The :module:`FindBLAS` and :module:`FindLAPACK` modules now support the * The :genex:`TARGET_PROPERTY` generator expression now evaluates the
NVIDIA Performance Libraries (NVPL). :prop_tgt:`LINK_LIBRARIES` and :prop_tgt:`INTERFACE_LINK_LIBRARIES`
target properties transitively. See policy :policy:`CMP0189`.
* The :prop_tgt:`PDB_NAME` and :prop_tgt:`COMPILE_PDB_NAME` target properties
now support :manual:`generator expressions <cmake-generator-expressions(7)>`.
* The :command:`project` command now has experimental support for the
``COMPAT_VERSION`` keyword, gated by
``CMAKE_EXPERIMENTAL_EXPORT_PACKAGE_INFO``.
* Regular expressions match the ``^`` anchor at most once in repeated
searches, at the start of the input. See policy :policy:`CMP0186`.
* References to unmatched groups are allowed, they are replaced with empty
strings.
* Zero-length matches are always allowed.
* The :module`:CMakeDetermineVSServicePack` module has been deprecated
via policy :policy:`CMP0196`. Port projects to the
:variable:`CMAKE_<LANG>_COMPILER_VERSION` variable instead.
* The :module:`FindCABLE` module has been deprecated via policy
:policy:`CMP0191`.
* The :module:`FindGCCXML` module has been deprecated via policy
:policy:`CMP0188`. Port projects to CastXML instead.
* The :ref:`cmake --build <Build Tool Mode>` command-line tool, when used
with the :generator:`Xcode` generator, now detects when a third-party
tool has wrapped the generated ``.xcodeproj`` in a ``.xcworkspace``,
and drives the build through the workspace instead.