diff options
author | Brad King <brad.king@kitware.com> | 2022-06-07 19:05:57 (GMT) |
---|---|---|
committer | Brad King <brad.king@kitware.com> | 2022-06-07 19:05:57 (GMT) |
commit | a3fc4698826172ec187844c4590cef58a310e074 (patch) | |
tree | 776b0ac1fb4f66887b219241c2cfe46b08788e0a /Help/release | |
parent | 031fa14b7eab1e85882eb5a9e10cb8f7f66c1350 (diff) | |
download | CMake-a3fc4698826172ec187844c4590cef58a310e074.zip CMake-a3fc4698826172ec187844c4590cef58a310e074.tar.gz CMake-a3fc4698826172ec187844c4590cef58a310e074.tar.bz2 |
Help: Consolidate 3.24 release notes
Run the `Utilities/Release/consolidate-relnotes.bash` script to move
notes from `Help/release/dev/*` into `Help/release/3.24.rst`.
Diffstat (limited to 'Help/release')
56 files changed, 307 insertions, 406 deletions
diff --git a/Help/release/3.24.rst b/Help/release/3.24.rst new file mode 100644 index 0000000..803d7dc --- /dev/null +++ b/Help/release/3.24.rst @@ -0,0 +1,306 @@ +CMake 3.24 Release Notes +************************ + +.. only:: html + + .. contents:: + +Changes made since CMake 3.23 include the following. + +* The ADSP compiler (SHARC and Blackfin) now supports + both CCES and VDSP++ installations, + with required configuration now done in the compiler module itself + rather than the Generic-ADSP platform module. + +* A dedicated ``ADSP`` platform has been added + to replace the existing ``Generic-ADSP`` implementation. + This features automatic detection of the latest CCES/VDSP++ install + and compiler selection (``cc21k`` vs. ``ccblkfn``) + based off of the :variable:`CMAKE_SYSTEM_PROCESSOR` variable. + +* The :genex:`LINK_LIBRARY` generator expression gained the ability to link + frameworks in various ways when targeting ``Apple`` platforms. The following + new features were added: + + * ``FRAMEWORK`` + * ``NEEDED_FRAMEWORK`` + * ``REEXPORT_FRAMEWORK`` + * ``WEAK_FRAMEWORK`` + +* The :genex:`LINK_LIBRARY` generator expression gained the ability to link + libraries in various ways when targeting ``Apple`` platforms. The following + new features were added: + + * ``NEEDED_LIBRARY`` + * ``REEXPORT_LIBRARY`` + * ``WEAK_LIBRARY`` + +* :command:`cmake_host_system_information` command gains the capability, on + ``Windows`` platform, to query the registry. + +* The :manual:`cmake(1)` ``-E tar`` command gained the ``--touch`` option + to keep the current local timestamp instead of extracting file timestamps + from the archive. + +* :manual:`cmake(1)` gained the ``--fresh`` command-line option to remove + any existing ``CMakeCache.txt`` when configuring a build tree. + +* The :variable:`CMAKE_PROJECT_TOP_LEVEL_INCLUDES` variable was added to allow + injecting custom code at the site of the first :command:`project` call, + after the host and target platform details have been determined. + +* The :manual:`cmake(1)` ``-E`` commands ``cat`` and ``env`` learned to respect + a double dash (``--``) argument that acts as a delimiter indicating the end of + options. Any following arguments are treated as operands/positional arguments, + even if they begin with a dash ``-`` character. + +* The :variable:`CMAKE_COLOR_DIAGNOSTICS` variable was added to control + color diagnostics generated by compilers. This variable also controls + color buildsystem messages with :ref:`Makefile Generators`, replacing + :variable:`CMAKE_COLOR_MAKEFILE`. + + The :envvar:`CMAKE_COLOR_DIAGNOSTICS` environment was added to set + a default value for :variable:`CMAKE_COLOR_DIAGNOSTICS`. + +* The :module:`CPack` module no longer enables the SLA by default in the + :cpack_gen:`CPack DragNDrop Generator`. See policy :policy:`CMP0133` + and the :variable:`CPACK_DMG_SLA_USE_RESOURCE_FILE_LICENSE` variable. + +* The :cpack_gen:`CPack WIX Generator` gained a new variable, + :variable:`CPACK_WIX_ARCHITECTURE`, to specify the installer architecture + in order to support computers running Windows for ARM. + +* CPack now supports the :variable:`CPACK_THREADS` option for ``zstd`` + compression when compiled with libarchive 3.6 or higher. It is + supported by official CMake binaries available on ``cmake.org``. + +* :manual:`ctest(1)` gained a ``--test-output-truncation`` option (and + corresponding :variable:`CTEST_CUSTOM_TEST_OUTPUT_TRUNCATION` variable) to + specify the truncation mode once the maximum test output size has been + reached. Possible values are ``tail`` (default), ``middle`` or ``head``. +* :manual:`cmake-presets(7)` files now support schema version ``5``. +* :manual:`cmake-presets(7)` files gained support for specifying a + ``testOutputTruncation`` field in test presets, which specifies the truncation + mode once the maximum test output size has been reached. + +* The :variable:`CMAKE_CUDA_ARCHITECTURES` variable and associated + :prop_tgt:`CUDA_ARCHITECTURES` target property now support the + special ``native`` value to compile for the architectures(s) + of the host's GPU(s). + +* The :command:`cmake_language` command gained a new + ``SET_DEPENDENCY_PROVIDER`` sub-command. When a dependency provider is set, + calls to :command:`find_package` and :command:`FetchContent_MakeAvailable` + can be redirected through a custom command, which can choose to fulfill the + request directly, modify how the request is processed, or leave it to be + fulfilled by the built-in implementation. See :ref:`dependency_providers`. + +* The :command:`ExternalProject_Add` command gained a new + ``DOWNLOAD_EXTRACT_TIMESTAMP`` option for controlling whether the timestamps + of extracted contents are set to match those in the archive when the ``URL`` + download method is used. A new policy :policy:`CMP0135` was added to control + the default behavior when the new option is not used. + +* Integration has been added between the :module:`FetchContent` module and the + :command:`find_package` command, enabling the following new capabilities: + + * :command:`FetchContent_MakeAvailable` can now try to satisfy a dependency + by calling :command:`find_package` first. A new + :variable:`FETCHCONTENT_TRY_FIND_PACKAGE_MODE` variable controls whether + this is done by default for all dependencies, is opt-in per dependency, + or is disabled entirely. + + * :command:`find_package` can be re-routed to call + :command:`FetchContent_MakeAvailable` instead. A new read-only + :variable:`CMAKE_FIND_PACKAGE_REDIRECTS_DIR` variable points to a + directory where config package files can be located to facilitate these + re-routed calls. + +* Add the fields ``RANGE_START`` and ``RANGE_END`` to ``file(DOWNLOAD)``. + Those fields provide a convenient way to specify the range, passed to the + libcurl, which can be useful for downloading parts of big binary files. + +* The :command:`find_file`, :command:`find_library`, :command:`find_path`, + :command:`find_package`, and :command:`find_program` commands have gained + the `NO_CMAKE_INSTALL_PREFIX` option to control searching + `CMAKE_INSTALL_PREFIX`. + +* Adds support for :variable:`CMAKE_FIND_USE_INSTALL_PREFIX` to toggle + behavior of the :command:`find_file`, :command:`find_library`, :command:`find_path`, + :command:`find_package`, and :command:`find_program` commands new + `NO_CMAKE_INSTALL_PREFIX` option. + +* The :module:`FindGLUT` module no longer provides the undocumented + result variables ``GLUT_LIBRARY`` and ``GLUT_INCLUDE_PATH``. + +* :command:`find_file`, :command:`find_path`, :command:`find_library`, + :command:`find_program`, and :command:`find_package` commands gain the + capability to specify which registry views must be queried. + +* The :module:`FindJNI` module now provides imported targets. + +* The :module:`FindMatlab` module :command:`matlab_add_mex` function + gained a ``NO_IMPLICIT_LINK_TO_MATLAB_LIBRARIES`` option to disable + automatic linking of MATLAB libraries. + +* The :command:`find_package` command gained a `GLOBAL` option that + allows for the promotion of imported targets to global scope fur the + duration of the :command:`find_package` call. + +* Adds support for :variable:`CMAKE_FIND_PACKAGE_TARGETS_GLOBAL` to + toggle behavior of the :command:`find_package` command's new GLOBAL option + +* The :module:`FindZLIB` learned a new ``ZLIB_USE_STATIC_LIBS`` variable to + search only for static libraries. + +* The :genex:`LINK_GROUP` generator expression was added to manage the grouping + of libraries during the link step. The variables + :variable:`CMAKE_<LANG>_LINK_GROUP_USING_<FEATURE>` and + :variable:`CMAKE_LINK_GROUP_USING_<FEATURE>` are used to define features + usable by the :genex:`LINK_GROUP` generator expression. + +* The :genex:`LINK_LIBRARY` generator expression was added to manage how + libraries are specified during the link step. The variables + :variable:`CMAKE_<LANG>_LINK_LIBRARY_USING_<FEATURE>` and + :variable:`CMAKE_LINK_LIBRARY_USING_<FEATURE>` are used to define features + usable by the :genex:`LINK_LIBRARY` generator expression. Moreover, the + :prop_tgt:`LINK_LIBRARY_OVERRIDE` and + :prop_tgt:`LINK_LIBRARY_OVERRIDE_<LIBRARY>` target properties are available + to resolve incompatible features. + +* The :genex:`PATH_EQUAL` generator expression was added to manage path + comparisons. + +* The :genex:`PATH` generator expression was added to manage paths. + +* A new predefined target `RERUN_CMAKE` is added for + :generator:`Green Hills MULTI` generator to easily rerun + CMake if any CMake files were updated. + +* The :command:`if` command gains the capability to compare paths by using the + ``PATH_EQUAL`` operator. See policy :policy:`CMP0139`. + +* The :prop_tgt:`INTERFACE_LINK_LIBRARIES_DIRECT` and + :prop_tgt:`INTERFACE_LINK_LIBRARIES_DIRECT_EXCLUDE` target properties + were added to express usage requirements affecting a consumer's + direct link dependencies. + +* The :prop_tgt:`LINK_LIBRARIES` target property now supports + the :genex:`$<LINK_ONLY:...>` generator expression. + See policy :policy:`CMP0131`. + +* The :genex:`LINK_LIBRARY` generator expression gained the feature + ``WHOLE_ARCHIVE`` to force load of all members in a static library. This + feature is supported on the following target platforms: + + * all ``Apple`` variants + * ``Linux`` + * all ``BSD`` variants + * ``SunOS`` + * ``Windows`` + * ``CYGWIN`` + * ``MSYS`` + +* LLVM's `flang`_ Fortran compiler is now supported, with compiler id ``LLVMFlang``. + +.. _`flang`: https://github.com/llvm/llvm-project/tree/main/flang + +* The :generator:`MSYS Makefiles` and :generator:`MinGW Makefiles` + generators, when a compiler is not explicitly specified, now select + the first compiler (of any name) found in directories listed by the + ``PATH`` environment variable. + +* With MSVC compilers, debug configurations now use ``-ZI`` by default + instead of ``/Zi``. See policy :policy:`CMP0138`. + +* The :module:`FindPkgConfig` module learned to find static libraries + in addition to the default search for shared libraries. + :command:`pkg_check_modules` gained a ``STATIC_TARGET`` option + to make the imported target reference static libraries. + +* :manual:`cmake-presets(7)` files now support a ``${pathListSep}`` macro, + which expands to ``:`` or ``;`` based on the platform. + +* The precompiled macOS binaries provided on + `cmake.org <https://cmake.org/download/>`_ no longer attach a SLA + to the ``.dmg`` packages. This was removed because macOS 12 deprecated + the tools used to attach ``.dmg`` resources. + +* The deprecated ``PackageMaker`` :manual:`cpack(1)` generator has + been removed. + +* The :genex:`LINK_GROUP` generator expression gained the ability to manage, on + ``Linux`` and ``BSD`` systems, circular references between static libraries + by using ``RESCAN`` feature. + +* CMake no longer sets environment variables like :envvar:`CC`, :envvar:`CXX`, + etc. when enabling the corresponding language during the first CMake run in + a build directory. See policy :policy:`CMP0132`. + +* Added the new :genex:`TARGET_BUNDLE_DIR_NAME` generator expression + which evaluates to the name of the bundle directory for a given bundle + target. + +* Add the field ``global_frame`` to the json-v1 trace format. This + frame tracks the depth of the call stack globally across all + ``CMakeLists.txt`` files involved in the trace, and will let tools + reconstruct stack traces that span from the top-level ``CMakeLists.txt`` + file of the project. + +* Add the field ``line_end`` to the json-v1 trace format. This + field tells you the line in file ``file`` at which the function + call ends. Tools can use this new field, together with ``line`` + and ``file``, to map traces to lines of CMake source code. + +* The :command:`try_compile` command + :ref:`whole-project <Try Compiling Whole Projects>` signature + now propagates platform variables. See policy :policy:`CMP0137`. + +* The :variable:`CMAKE_TRY_COMPILE_NO_PLATFORM_VARIABLES` variable + was added to tell the :command:`try_compile` command not to + pass any platform variables to the test project. + +* A new :prop_tgt:`VERIFY_INTERFACE_HEADER_SETS` target property was added, + which can be used to verify that all headers in header sets can be used on + their own. +* A new :variable:`CMAKE_VERIFY_INTERFACE_HEADER_SETS` variable was added, + which is used to initialize the :prop_tgt:`VERIFY_INTERFACE_HEADER_SETS` + target property. +* A new :prop_tgt:`INTERFACE_HEADER_SETS_TO_VERIFY` target property was added, + which can be used to specify which header sets should be verified by + :prop_tgt:`VERIFY_INTERFACE_HEADER_SETS`. + +* The :prop_tgt:`VS_NO_COMPILE_BATCHING` target property was added to + tell :ref:`Visual Studio Generators` whether to disable compiler parallelism + and call the compiler with one c/cpp file at a time. + +* The :prop_tgt:`VS_DOTNET_STARTUP_OBJECT` target property was added to + tell :ref:`Visual Studio Generators` which startup class shall be used + when the program or project is executed. This is necessary when more + than one ``static void Main(string[])`` function signature is available + in a managed .NET project. + +* :ref:`Visual Studio Generators` now support ``SYSTEM`` headers. + +* The :variable:`CMAKE_WATCOM_RUNTIME_LIBRARY` variable and + :prop_tgt:`WATCOM_RUNTIME_LIBRARY` target property were introduced to + select the runtime library used by compilers targeting the Watcom ABI. + See policy :policy:`CMP0136`. + +* Added the Target Property :prop_tgt:`COMPILE_WARNING_AS_ERROR` and the + Variable :variable:`CMAKE_COMPILE_WARNING_AS_ERROR` which initializes the + Target Property. If :prop_tgt:`COMPILE_WARNING_AS_ERROR` is true, it expands + to a different flag depending on the compiler such that any warnings at + compile will be treated as errors. + +* :manual:`cmake(1)` gained the command-line option + ``--compile-no-warning-as-error`` which causes the values of + the :prop_tgt:`COMPILE_WARNING_AS_ERROR` target property and + :variable:`CMAKE_COMPILE_WARNING_AS_ERROR` variable to be ignored. + +* The :command:`while` command now diagnoses errors during condition + evaluation. See policy :policy:`CMP0130`. + +* The Xcode generator learned to handle global and target specific + ``xcconfig`` files with the :variable:`CMAKE_XCODE_XCCONFIG` + variable and :prop_tgt:`XCODE_XCCONFIG` target property. diff --git a/Help/release/dev/Apple-link-framework.rst b/Help/release/dev/Apple-link-framework.rst deleted file mode 100644 index e194c15..0000000 --- a/Help/release/dev/Apple-link-framework.rst +++ /dev/null @@ -1,11 +0,0 @@ -Apple-link-framework --------------------- - -* The :genex:`LINK_LIBRARY` generator expression gained the ability to link - frameworks in various ways when targeting ``Apple`` platforms. The following - new features were added: - - * ``FRAMEWORK`` - * ``NEEDED_FRAMEWORK`` - * ``REEXPORT_FRAMEWORK`` - * ``WEAK_FRAMEWORK`` diff --git a/Help/release/dev/Apple-link-library.rst b/Help/release/dev/Apple-link-library.rst deleted file mode 100644 index ec4e3b6..0000000 --- a/Help/release/dev/Apple-link-library.rst +++ /dev/null @@ -1,10 +0,0 @@ -Apple-link-library ------------------- - -* The :genex:`LINK_LIBRARY` generator expression gained the ability to link - libraries in various ways when targeting ``Apple`` platforms. The following - new features were added: - - * ``NEEDED_LIBRARY`` - * ``REEXPORT_LIBRARY`` - * ``WEAK_LIBRARY`` diff --git a/Help/release/dev/CMAKE_PROJECT_TOP_LEVEL_INCLUDES.rst b/Help/release/dev/CMAKE_PROJECT_TOP_LEVEL_INCLUDES.rst deleted file mode 100644 index ca2d223..0000000 --- a/Help/release/dev/CMAKE_PROJECT_TOP_LEVEL_INCLUDES.rst +++ /dev/null @@ -1,6 +0,0 @@ -CMAKE_PROJECT_TOP_LEVEL_INCLUDES --------------------------------- - -* The :variable:`CMAKE_PROJECT_TOP_LEVEL_INCLUDES` variable was added to allow - injecting custom code at the site of the first :command:`project` call, - after the host and target platform details have been determined. diff --git a/Help/release/dev/ExternalProject-no-extract-timestamp.rst b/Help/release/dev/ExternalProject-no-extract-timestamp.rst deleted file mode 100644 index 0e8c01e..0000000 --- a/Help/release/dev/ExternalProject-no-extract-timestamp.rst +++ /dev/null @@ -1,8 +0,0 @@ -ExternalProject-no-extract-timestamp ------------------------------------- - -* The :command:`ExternalProject_Add` command gained a new - ``DOWNLOAD_EXTRACT_TIMESTAMP`` option for controlling whether the timestamps - of extracted contents are set to match those in the archive when the ``URL`` - download method is used. A new policy :policy:`CMP0135` was added to control - the default behavior when the new option is not used. diff --git a/Help/release/dev/FetchContent_find_package_integration.rst b/Help/release/dev/FetchContent_find_package_integration.rst deleted file mode 100644 index 4ca7afc..0000000 --- a/Help/release/dev/FetchContent_find_package_integration.rst +++ /dev/null @@ -1,17 +0,0 @@ -FetchContent_find_package_integration -------------------------------------- - -* Integration has been added between the :module:`FetchContent` module and the - :command:`find_package` command, enabling the following new capabilities: - - * :command:`FetchContent_MakeAvailable` can now try to satisfy a dependency - by calling :command:`find_package` first. A new - :variable:`FETCHCONTENT_TRY_FIND_PACKAGE_MODE` variable controls whether - this is done by default for all dependencies, is opt-in per dependency, - or is disabled entirely. - - * :command:`find_package` can be re-routed to call - :command:`FetchContent_MakeAvailable` instead. A new read-only - :variable:`CMAKE_FIND_PACKAGE_REDIRECTS_DIR` variable points to a - directory where config package files can be located to facilitate these - re-routed calls. diff --git a/Help/release/dev/FindGLUT-remove-undocumented-vars.rst b/Help/release/dev/FindGLUT-remove-undocumented-vars.rst deleted file mode 100644 index 6a0c904..0000000 --- a/Help/release/dev/FindGLUT-remove-undocumented-vars.rst +++ /dev/null @@ -1,5 +0,0 @@ -FindGLUT-remove-undocumented-vars ---------------------------------- - -* The :module:`FindGLUT` module no longer provides the undocumented - result variables ``GLUT_LIBRARY`` and ``GLUT_INCLUDE_PATH``. diff --git a/Help/release/dev/FindJNI-targets.rst b/Help/release/dev/FindJNI-targets.rst deleted file mode 100644 index 76e390f..0000000 --- a/Help/release/dev/FindJNI-targets.rst +++ /dev/null @@ -1,4 +0,0 @@ -FindJNI-targets ---------------- - -* The :module:`FindJNI` module now provides imported targets. diff --git a/Help/release/dev/FindMatlab-no-implicit-link.txt b/Help/release/dev/FindMatlab-no-implicit-link.txt deleted file mode 100644 index 7ecc17f..0000000 --- a/Help/release/dev/FindMatlab-no-implicit-link.txt +++ /dev/null @@ -1,6 +0,0 @@ -FindMatlab-no-implicit-link ---------------------------- - -* The :module:`FindMatlab` module :command:`matlab_add_mex` function - gained a ``NO_IMPLICIT_LINK_TO_MATLAB_LIBRARIES`` option to disable - automatic linking of MATLAB libraries. diff --git a/Help/release/dev/Genex-LINK_GROUP.rst b/Help/release/dev/Genex-LINK_GROUP.rst deleted file mode 100644 index aa9e318..0000000 --- a/Help/release/dev/Genex-LINK_GROUP.rst +++ /dev/null @@ -1,8 +0,0 @@ -Genex-LINK_GROUP ----------------- - -* The :genex:`LINK_GROUP` generator expression was added to manage the grouping - of libraries during the link step. The variables - :variable:`CMAKE_<LANG>_LINK_GROUP_USING_<FEATURE>` and - :variable:`CMAKE_LINK_GROUP_USING_<FEATURE>` are used to define features - usable by the :genex:`LINK_GROUP` generator expression. diff --git a/Help/release/dev/Genex-LINK_LIBRARY.rst b/Help/release/dev/Genex-LINK_LIBRARY.rst deleted file mode 100644 index fe44dbc..0000000 --- a/Help/release/dev/Genex-LINK_LIBRARY.rst +++ /dev/null @@ -1,11 +0,0 @@ -Genex-LINK_LIBRARY ------------------- - -* The :genex:`LINK_LIBRARY` generator expression was added to manage how - libraries are specified during the link step. The variables - :variable:`CMAKE_<LANG>_LINK_LIBRARY_USING_<FEATURE>` and - :variable:`CMAKE_LINK_LIBRARY_USING_<FEATURE>` are used to define features - usable by the :genex:`LINK_LIBRARY` generator expression. Moreover, the - :prop_tgt:`LINK_LIBRARY_OVERRIDE` and - :prop_tgt:`LINK_LIBRARY_OVERRIDE_<LIBRARY>` target properties are available - to resolve incompatible features. diff --git a/Help/release/dev/Genex-PATH.rst b/Help/release/dev/Genex-PATH.rst deleted file mode 100644 index 870ee23..0000000 --- a/Help/release/dev/Genex-PATH.rst +++ /dev/null @@ -1,4 +0,0 @@ -Genex-PATH ----------- - -* The :genex:`PATH` generator expression was added to manage paths. diff --git a/Help/release/dev/Genex-PATH_EQUAL.rst b/Help/release/dev/Genex-PATH_EQUAL.rst deleted file mode 100644 index 953ac26..0000000 --- a/Help/release/dev/Genex-PATH_EQUAL.rst +++ /dev/null @@ -1,5 +0,0 @@ -Genex-PATH_EQUAL ----------------- - -* The :genex:`PATH_EQUAL` generator expression was added to manage path - comparisons. diff --git a/Help/release/dev/LINK_LIBRARY-WHOLE_ARCHIVE.rst b/Help/release/dev/LINK_LIBRARY-WHOLE_ARCHIVE.rst deleted file mode 100644 index abaf3a9..0000000 --- a/Help/release/dev/LINK_LIBRARY-WHOLE_ARCHIVE.rst +++ /dev/null @@ -1,14 +0,0 @@ -LINK_LIBRARY-WHOLE_ARCHIVE --------------------------- - -* The :genex:`LINK_LIBRARY` generator expression gained the feature - ``WHOLE_ARCHIVE`` to force load of all members in a static library. This - feature is supported on the following target platforms: - - * all ``Apple`` variants - * ``Linux`` - * all ``BSD`` variants - * ``SunOS`` - * ``Windows`` - * ``CYGWIN`` - * ``MSYS`` diff --git a/Help/release/dev/LLVMFlang-compiler.rst b/Help/release/dev/LLVMFlang-compiler.rst deleted file mode 100644 index 1d29449..0000000 --- a/Help/release/dev/LLVMFlang-compiler.rst +++ /dev/null @@ -1,6 +0,0 @@ -LLVMFlang-compiler ------------------- - -* LLVM's `flang`_ Fortran compiler is now supported, with compiler id ``LLVMFlang``. - -.. _`flang`: https://github.com/llvm/llvm-project/tree/main/flang diff --git a/Help/release/dev/adsp-platform-and-compilers.rst b/Help/release/dev/adsp-platform-and-compilers.rst deleted file mode 100644 index 396b29d..0000000 --- a/Help/release/dev/adsp-platform-and-compilers.rst +++ /dev/null @@ -1,13 +0,0 @@ -adsp-platform-and-compilers ---------------------------- - -* The ADSP compiler (SHARC and Blackfin) now supports - both CCES and VDSP++ installations, - with required configuration now done in the compiler module itself - rather than the Generic-ADSP platform module. - -* A dedicated ``ADSP`` platform has been added - to replace the existing ``Generic-ADSP`` implementation. - This features automatic detection of the latest CCES/VDSP++ install - and compiler selection (``cc21k`` vs. ``ccblkfn``) - based off of the :variable:`CMAKE_SYSTEM_PROCESSOR` variable. diff --git a/Help/release/dev/chsi-query-windows-registry.rst b/Help/release/dev/chsi-query-windows-registry.rst deleted file mode 100644 index e75bbd8..0000000 --- a/Help/release/dev/chsi-query-windows-registry.rst +++ /dev/null @@ -1,5 +0,0 @@ -chsi-query-windows-registry ---------------------------- - -* :command:`cmake_host_system_information` command gains the capability, on - ``Windows`` platform, to query the registry. diff --git a/Help/release/dev/cmake-E-tar-touch.rst b/Help/release/dev/cmake-E-tar-touch.rst deleted file mode 100644 index 6d1338d..0000000 --- a/Help/release/dev/cmake-E-tar-touch.rst +++ /dev/null @@ -1,6 +0,0 @@ -cmake-E-tar-touch ------------------ - -* The :manual:`cmake(1)` ``-E tar`` command gained the ``--touch`` option - to keep the current local timestamp instead of extracting file timestamps - from the archive. diff --git a/Help/release/dev/cmake-fresh.rst b/Help/release/dev/cmake-fresh.rst deleted file mode 100644 index 6de5b4e..0000000 --- a/Help/release/dev/cmake-fresh.rst +++ /dev/null @@ -1,5 +0,0 @@ -cmake-fresh ------------ - -* :manual:`cmake(1)` gained the ``--fresh`` command-line option to remove - any existing ``CMakeCache.txt`` when configuring a build tree. diff --git a/Help/release/dev/cmcmd-end-of-options-delimiter.rst b/Help/release/dev/cmcmd-end-of-options-delimiter.rst deleted file mode 100644 index bc9cc21..0000000 --- a/Help/release/dev/cmcmd-end-of-options-delimiter.rst +++ /dev/null @@ -1,7 +0,0 @@ -cmcmd-end-of-options-delimiter ------------------------------- - -* The :manual:`cmake(1)` ``-E`` commands ``cat`` and ``env`` learned to respect - a double dash (``--``) argument that acts as a delimiter indicating the end of - options. Any following arguments are treated as operands/positional arguments, - even if they begin with a dash ``-`` character. diff --git a/Help/release/dev/color-diagnostics.rst b/Help/release/dev/color-diagnostics.rst deleted file mode 100644 index 8e0e225..0000000 --- a/Help/release/dev/color-diagnostics.rst +++ /dev/null @@ -1,10 +0,0 @@ -color-diagnostics ------------------ - -* The :variable:`CMAKE_COLOR_DIAGNOSTICS` variable was added to control - color diagnostics generated by compilers. This variable also controls - color buildsystem messages with :ref:`Makefile Generators`, replacing - :variable:`CMAKE_COLOR_MAKEFILE`. - - The :envvar:`CMAKE_COLOR_DIAGNOSTICS` environment was added to set - a default value for :variable:`CMAKE_COLOR_DIAGNOSTICS`. diff --git a/Help/release/dev/cpack-dmg-sla.rst b/Help/release/dev/cpack-dmg-sla.rst deleted file mode 100644 index 34c3cff..0000000 --- a/Help/release/dev/cpack-dmg-sla.rst +++ /dev/null @@ -1,6 +0,0 @@ -cpack-dmg-sla -------------- - -* The :module:`CPack` module no longer enables the SLA by default in the - :cpack_gen:`CPack DragNDrop Generator`. See policy :policy:`CMP0133` - and the :variable:`CPACK_DMG_SLA_USE_RESOURCE_FILE_LICENSE` variable. diff --git a/Help/release/dev/cpack-wix-arch.rst b/Help/release/dev/cpack-wix-arch.rst deleted file mode 100644 index e7fd1ad..0000000 --- a/Help/release/dev/cpack-wix-arch.rst +++ /dev/null @@ -1,6 +0,0 @@ -cpack-wix-arch --------------- - -* The :cpack_gen:`CPack WIX Generator` gained a new variable, - :variable:`CPACK_WIX_ARCHITECTURE`, to specify the installer architecture - in order to support computers running Windows for ARM. diff --git a/Help/release/dev/cpack-zstd-parallel.rst b/Help/release/dev/cpack-zstd-parallel.rst deleted file mode 100644 index da22625..0000000 --- a/Help/release/dev/cpack-zstd-parallel.rst +++ /dev/null @@ -1,6 +0,0 @@ -cpack-zstd-parallel -------------------- - -* CPack now supports the :variable:`CPACK_THREADS` option for ``zstd`` - compression when compiled with libarchive 3.6 or higher. It is - supported by official CMake binaries available on ``cmake.org``. diff --git a/Help/release/dev/ctest-output-truncation.rst b/Help/release/dev/ctest-output-truncation.rst deleted file mode 100644 index 85fb37c..0000000 --- a/Help/release/dev/ctest-output-truncation.rst +++ /dev/null @@ -1,11 +0,0 @@ -ctest-output-truncation ------------------------ - -* :manual:`ctest(1)` gained a ``--test-output-truncation`` option (and - corresponding :variable:`CTEST_CUSTOM_TEST_OUTPUT_TRUNCATION` variable) to - specify the truncation mode once the maximum test output size has been - reached. Possible values are ``tail`` (default), ``middle`` or ``head``. -* :manual:`cmake-presets(7)` files now support schema version ``5``. -* :manual:`cmake-presets(7)` files gained support for specifying a - ``testOutputTruncation`` field in test presets, which specifies the truncation - mode once the maximum test output size has been reached. diff --git a/Help/release/dev/cuda-arch-native.rst b/Help/release/dev/cuda-arch-native.rst deleted file mode 100644 index f44a668..0000000 --- a/Help/release/dev/cuda-arch-native.rst +++ /dev/null @@ -1,7 +0,0 @@ -cuda-arch-native ----------------- - -* The :variable:`CMAKE_CUDA_ARCHITECTURES` variable and associated - :prop_tgt:`CUDA_ARCHITECTURES` target property now support the - special ``native`` value to compile for the architectures(s) - of the host's GPU(s). diff --git a/Help/release/dev/dependency-providers.rst b/Help/release/dev/dependency-providers.rst deleted file mode 100644 index 8b2cf06..0000000 --- a/Help/release/dev/dependency-providers.rst +++ /dev/null @@ -1,9 +0,0 @@ -dependency-providers --------------------- - -* The :command:`cmake_language` command gained a new - ``SET_DEPENDENCY_PROVIDER`` sub-command. When a dependency provider is set, - calls to :command:`find_package` and :command:`FetchContent_MakeAvailable` - can be redirected through a custom command, which can choose to fulfill the - request directly, modify how the request is processed, or leave it to be - fulfilled by the built-in implementation. See :ref:`dependency_providers`. diff --git a/Help/release/dev/file-download-range.rst b/Help/release/dev/file-download-range.rst deleted file mode 100644 index 194100d..0000000 --- a/Help/release/dev/file-download-range.rst +++ /dev/null @@ -1,6 +0,0 @@ -file-download-range -------------------- - -* Add the fields ``RANGE_START`` and ``RANGE_END`` to ``file(DOWNLOAD)``. - Those fields provide a convenient way to specify the range, passed to the - libcurl, which can be useful for downloading parts of big binary files. diff --git a/Help/release/dev/find-calls-search-install-prefix.rst b/Help/release/dev/find-calls-search-install-prefix.rst deleted file mode 100644 index a111a91..0000000 --- a/Help/release/dev/find-calls-search-install-prefix.rst +++ /dev/null @@ -1,12 +0,0 @@ -find-calls-search-install-prefix --------------------------------- - -* The :command:`find_file`, :command:`find_library`, :command:`find_path`, - :command:`find_package`, and :command:`find_program` commands have gained - the `NO_CMAKE_INSTALL_PREFIX` option to control searching - `CMAKE_INSTALL_PREFIX`. - -* Adds support for :variable:`CMAKE_FIND_USE_INSTALL_PREFIX` to toggle - behavior of the :command:`find_file`, :command:`find_library`, :command:`find_path`, - :command:`find_package`, and :command:`find_program` commands new - `NO_CMAKE_INSTALL_PREFIX` option. diff --git a/Help/release/dev/find_item-query-windows-registry.rst b/Help/release/dev/find_item-query-windows-registry.rst deleted file mode 100644 index ff0bd40..0000000 --- a/Help/release/dev/find_item-query-windows-registry.rst +++ /dev/null @@ -1,6 +0,0 @@ -find_item-query-windows-registry.rst ------------------------------------- - -* :command:`find_file`, :command:`find_path`, :command:`find_library`, - :command:`find_program`, and :command:`find_package` commands gain the - capability to specify which registry views must be queried. diff --git a/Help/release/dev/find_package-global-imported.rst b/Help/release/dev/find_package-global-imported.rst deleted file mode 100644 index b32d18d..0000000 --- a/Help/release/dev/find_package-global-imported.rst +++ /dev/null @@ -1,9 +0,0 @@ -find_package-global-imported ----------------------------- - -* The :command:`find_package` command gained a `GLOBAL` option that - allows for the promotion of imported targets to global scope fur the - duration of the :command:`find_package` call. - -* Adds support for :variable:`CMAKE_FIND_PACKAGE_TARGETS_GLOBAL` to - toggle behavior of the :command:`find_package` command's new GLOBAL option diff --git a/Help/release/dev/findzlib-static.rst b/Help/release/dev/findzlib-static.rst deleted file mode 100644 index 35855f6..0000000 --- a/Help/release/dev/findzlib-static.rst +++ /dev/null @@ -1,5 +0,0 @@ -findzlib-static ---------------- - -* The :module:`FindZLIB` learned a new ``ZLIB_USE_STATIC_LIBS`` variable to - search only for static libraries. diff --git a/Help/release/dev/ghs_predefined_targets.rst b/Help/release/dev/ghs_predefined_targets.rst deleted file mode 100644 index eeca5a9..0000000 --- a/Help/release/dev/ghs_predefined_targets.rst +++ /dev/null @@ -1,6 +0,0 @@ -ghs_predefined_targets ----------------------- - -* A new predefined target `RERUN_CMAKE` is added for - :generator:`Green Hills MULTI` generator to easily rerun - CMake if any CMake files were updated. diff --git a/Help/release/dev/if-PATH_EQUAL.rst b/Help/release/dev/if-PATH_EQUAL.rst deleted file mode 100644 index 45f02e8..0000000 --- a/Help/release/dev/if-PATH_EQUAL.rst +++ /dev/null @@ -1,5 +0,0 @@ -if-PATH_EQUAL -------------- - -* The :command:`if` command gains the capability to compare paths by using the - ``PATH_EQUAL`` operator. See policy :policy:`CMP0139`. diff --git a/Help/release/dev/link-interface-direct.rst b/Help/release/dev/link-interface-direct.rst deleted file mode 100644 index 8b858e2..0000000 --- a/Help/release/dev/link-interface-direct.rst +++ /dev/null @@ -1,11 +0,0 @@ -link-interface-direct ---------------------- - -* The :prop_tgt:`INTERFACE_LINK_LIBRARIES_DIRECT` and - :prop_tgt:`INTERFACE_LINK_LIBRARIES_DIRECT_EXCLUDE` target properties - were added to express usage requirements affecting a consumer's - direct link dependencies. - -* The :prop_tgt:`LINK_LIBRARIES` target property now supports - the :genex:`$<LINK_ONLY:...>` generator expression. - See policy :policy:`CMP0131`. diff --git a/Help/release/dev/mingw-compiler-PATH.rst b/Help/release/dev/mingw-compiler-PATH.rst deleted file mode 100644 index 7452da0..0000000 --- a/Help/release/dev/mingw-compiler-PATH.rst +++ /dev/null @@ -1,7 +0,0 @@ -mingw-compiler-PATH -------------------- - -* The :generator:`MSYS Makefiles` and :generator:`MinGW Makefiles` - generators, when a compiler is not explicitly specified, now select - the first compiler (of any name) found in directories listed by the - ``PATH`` environment variable. diff --git a/Help/release/dev/msvc-compilers-default-to-ZI.rst b/Help/release/dev/msvc-compilers-default-to-ZI.rst deleted file mode 100644 index 61ea877..0000000 --- a/Help/release/dev/msvc-compilers-default-to-ZI.rst +++ /dev/null @@ -1,5 +0,0 @@ -msvc-compilers-default-to-ZI ----------------------------- - -* With MSVC compilers, debug configurations now use ``-ZI`` by default - instead of ``/Zi``. See policy :policy:`CMP0138`. diff --git a/Help/release/dev/pkgconfig-static-libs.rst b/Help/release/dev/pkgconfig-static-libs.rst deleted file mode 100644 index 8f7ab0e..0000000 --- a/Help/release/dev/pkgconfig-static-libs.rst +++ /dev/null @@ -1,7 +0,0 @@ -pkgconfig-static-libs ---------------------- - -* The :module:`FindPkgConfig` module learned to find static libraries - in addition to the default search for shared libraries. - :command:`pkg_check_modules` gained a ``STATIC_TARGET`` option - to make the imported target reference static libraries. diff --git a/Help/release/dev/presets-pathListSep.rst b/Help/release/dev/presets-pathListSep.rst deleted file mode 100644 index 84b129f..0000000 --- a/Help/release/dev/presets-pathListSep.rst +++ /dev/null @@ -1,5 +0,0 @@ -presets-pathListSep -------------------- - -* :manual:`cmake-presets(7)` files now support a ``${pathListSep}`` macro, - which expands to ``:`` or ``;`` based on the platform. diff --git a/Help/release/dev/rel-macos-dmg-no-sla.rst b/Help/release/dev/rel-macos-dmg-no-sla.rst deleted file mode 100644 index 2f20aab..0000000 --- a/Help/release/dev/rel-macos-dmg-no-sla.rst +++ /dev/null @@ -1,7 +0,0 @@ -rel-macos-dmg-no-sla --------------------- - -* The precompiled macOS binaries provided on - `cmake.org <https://cmake.org/download/>`_ no longer attach a SLA - to the ``.dmg`` packages. This was removed because macOS 12 deprecated - the tools used to attach ``.dmg`` resources. diff --git a/Help/release/dev/remove-PackageMaker-generator.rst b/Help/release/dev/remove-PackageMaker-generator.rst deleted file mode 100644 index f20a08c..0000000 --- a/Help/release/dev/remove-PackageMaker-generator.rst +++ /dev/null @@ -1,5 +0,0 @@ -remove-PackageMaker-generator ------------------------------ - -* The deprecated ``PackageMaker`` :manual:`cpack(1)` generator has - been removed. diff --git a/Help/release/dev/rescan-static-libraries.rst b/Help/release/dev/rescan-static-libraries.rst deleted file mode 100644 index 8892d70..0000000 --- a/Help/release/dev/rescan-static-libraries.rst +++ /dev/null @@ -1,6 +0,0 @@ -rescan-static-libraries ------------------------ - -* The :genex:`LINK_GROUP` generator expression gained the ability to manage, on - ``Linux`` and ``BSD`` systems, circular references between static libraries - by using ``RESCAN`` feature. diff --git a/Help/release/dev/set-env-var-first-run.rst b/Help/release/dev/set-env-var-first-run.rst deleted file mode 100644 index c3f7d9f..0000000 --- a/Help/release/dev/set-env-var-first-run.rst +++ /dev/null @@ -1,6 +0,0 @@ -set-env-var-first-run ---------------------- - -* CMake no longer sets environment variables like :envvar:`CC`, :envvar:`CXX`, - etc. when enabling the corresponding language during the first CMake run in - a build directory. See policy :policy:`CMP0132`. diff --git a/Help/release/dev/target-bundle-dir-name-genex.rst b/Help/release/dev/target-bundle-dir-name-genex.rst deleted file mode 100644 index 0ae835a..0000000 --- a/Help/release/dev/target-bundle-dir-name-genex.rst +++ /dev/null @@ -1,6 +0,0 @@ -target-bundle-dir-name-genex ----------------------------- - -* Added the new :genex:`TARGET_BUNDLE_DIR_NAME` generator expression - which evaluates to the name of the bundle directory for a given bundle - target. diff --git a/Help/release/dev/trace-global-frame.rst b/Help/release/dev/trace-global-frame.rst deleted file mode 100644 index fdc4b5c..0000000 --- a/Help/release/dev/trace-global-frame.rst +++ /dev/null @@ -1,8 +0,0 @@ -trace-global-frame ------------------- - -* Add the field ``global_frame`` to the json-v1 trace format. This - frame tracks the depth of the call stack globally across all - ``CMakeLists.txt`` files involved in the trace, and will let tools - reconstruct stack traces that span from the top-level ``CMakeLists.txt`` - file of the project. diff --git a/Help/release/dev/trace-line-end.rst b/Help/release/dev/trace-line-end.rst deleted file mode 100644 index beade4b..0000000 --- a/Help/release/dev/trace-line-end.rst +++ /dev/null @@ -1,7 +0,0 @@ -trace-line-end --------------- - -* Add the field ``line_end`` to the json-v1 trace format. This - field tells you the line in file ``file`` at which the function - call ends. Tools can use this new field, together with ``line`` - and ``file``, to map traces to lines of CMake source code. diff --git a/Help/release/dev/try_compile-project-platform-vars.rst b/Help/release/dev/try_compile-project-platform-vars.rst deleted file mode 100644 index 06596d4..0000000 --- a/Help/release/dev/try_compile-project-platform-vars.rst +++ /dev/null @@ -1,10 +0,0 @@ -try_compile-project-platform-vars ---------------------------------- - -* The :command:`try_compile` command - :ref:`whole-project <Try Compiling Whole Projects>` signature - now propagates platform variables. See policy :policy:`CMP0137`. - -* The :variable:`CMAKE_TRY_COMPILE_NO_PLATFORM_VARIABLES` variable - was added to tell the :command:`try_compile` command not to - pass any platform variables to the test project. diff --git a/Help/release/dev/verify-interface-header-sets.rst b/Help/release/dev/verify-interface-header-sets.rst deleted file mode 100644 index 9e6856d..0000000 --- a/Help/release/dev/verify-interface-header-sets.rst +++ /dev/null @@ -1,12 +0,0 @@ -verify-interface-header-sets ----------------------------- - -* A new :prop_tgt:`VERIFY_INTERFACE_HEADER_SETS` target property was added, - which can be used to verify that all headers in header sets can be used on - their own. -* A new :variable:`CMAKE_VERIFY_INTERFACE_HEADER_SETS` variable was added, - which is used to initialize the :prop_tgt:`VERIFY_INTERFACE_HEADER_SETS` - target property. -* A new :prop_tgt:`INTERFACE_HEADER_SETS_TO_VERIFY` target property was added, - which can be used to specify which header sets should be verified by - :prop_tgt:`VERIFY_INTERFACE_HEADER_SETS`. diff --git a/Help/release/dev/vs-system-include.rst b/Help/release/dev/vs-system-include.rst deleted file mode 100644 index 5f42dba..0000000 --- a/Help/release/dev/vs-system-include.rst +++ /dev/null @@ -1,4 +0,0 @@ -vs-system-include ------------------ - -* :ref:`Visual Studio Generators` now support ``SYSTEM`` headers. diff --git a/Help/release/dev/vs_buildcache_support.rst b/Help/release/dev/vs_buildcache_support.rst deleted file mode 100644 index bdda675..0000000 --- a/Help/release/dev/vs_buildcache_support.rst +++ /dev/null @@ -1,6 +0,0 @@ -vs_buildcache_support ---------------------- - -* The :prop_tgt:`VS_NO_COMPILE_BATCHING` target property was added to - tell :ref:`Visual Studio Generators` whether to disable compiler parallelism - and call the compiler with one c/cpp file at a time. diff --git a/Help/release/dev/vs_dotnet_startup_object_support.rst b/Help/release/dev/vs_dotnet_startup_object_support.rst deleted file mode 100644 index 1f0672f..0000000 --- a/Help/release/dev/vs_dotnet_startup_object_support.rst +++ /dev/null @@ -1,8 +0,0 @@ -vs_dotnet_startup_object_support --------------------------------- - -* The :prop_tgt:`VS_DOTNET_STARTUP_OBJECT` target property was added to - tell :ref:`Visual Studio Generators` which startup class shall be used - when the program or project is executed. This is necessary when more - than one ``static void Main(string[])`` function signature is available - in a managed .NET project. diff --git a/Help/release/dev/watcom-runtime-library.rst b/Help/release/dev/watcom-runtime-library.rst deleted file mode 100644 index 3a07b32..0000000 --- a/Help/release/dev/watcom-runtime-library.rst +++ /dev/null @@ -1,7 +0,0 @@ -watcom-runtime-library ----------------------- - -* The :variable:`CMAKE_WATCOM_RUNTIME_LIBRARY` variable and - :prop_tgt:`WATCOM_RUNTIME_LIBRARY` target property were introduced to - select the runtime library used by compilers targeting the Watcom ABI. - See policy :policy:`CMP0136`. diff --git a/Help/release/dev/werror-property.rst b/Help/release/dev/werror-property.rst deleted file mode 100644 index 84c825f..0000000 --- a/Help/release/dev/werror-property.rst +++ /dev/null @@ -1,13 +0,0 @@ -werror-property ---------------- - -* Added the Target Property :prop_tgt:`COMPILE_WARNING_AS_ERROR` and the - Variable :variable:`CMAKE_COMPILE_WARNING_AS_ERROR` which initializes the - Target Property. If :prop_tgt:`COMPILE_WARNING_AS_ERROR` is true, it expands - to a different flag depending on the compiler such that any warnings at - compile will be treated as errors. - -* :manual:`cmake(1)` gained the command-line option - ``--compile-no-warning-as-error`` which causes the values of - the :prop_tgt:`COMPILE_WARNING_AS_ERROR` target property and - :variable:`CMAKE_COMPILE_WARNING_AS_ERROR` variable to be ignored. diff --git a/Help/release/dev/while-errors.rst b/Help/release/dev/while-errors.rst deleted file mode 100644 index c39e6e8..0000000 --- a/Help/release/dev/while-errors.rst +++ /dev/null @@ -1,5 +0,0 @@ -while-errors ------------- - -* The :command:`while` command now diagnoses errors during condition - evaluation. See policy :policy:`CMP0130`. diff --git a/Help/release/dev/xcode-xcconfig.rst b/Help/release/dev/xcode-xcconfig.rst deleted file mode 100644 index 4ad4cbe..0000000 --- a/Help/release/dev/xcode-xcconfig.rst +++ /dev/null @@ -1,6 +0,0 @@ -xcode-xcconfig --------------- - -* The Xcode generator learned to handle global and target specific - ``xcconfig`` files with the :variable:`CMAKE_XCODE_XCCONFIG` - variable and :prop_tgt:`XCODE_XCCONFIG` target property. diff --git a/Help/release/index.rst b/Help/release/index.rst index ad33705..11d5a11 100644 --- a/Help/release/index.rst +++ b/Help/release/index.rst @@ -15,6 +15,7 @@ Releases .. toctree:: :maxdepth: 1 + 3.24 <3.24> 3.23 <3.23> 3.22 <3.22> 3.21 <3.21> |