Merge topic 'doc-3.25-relnotes'

286a40cb5b Help: Update Sphinx versionadded directives for 3.25 release
f93f97d6c2 Help: Organize and revise 3.25 release notes
c174ef23f4 Help: Consolidate 3.25 release notes

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7751

42 files changed, 238 insertions, 273 deletions

diff --git a/Help/release/3.25.rst b/Help/release/3.25.rst
new file mode 100644
index 0000000..2250dd4
--- /dev/null
+++ b/Help/release/3.25.rst
@@ -0,0 +1,237 @@
+CMake 3.25 Release Notes
+************************
+
+.. only:: html
+
+  .. contents::
+
+Changes made since CMake 3.24 include the following.
+
+New Features
+============
+
+Presets
+-------
+
+* The :manual:`cmake-presets(7)` schema version has been bumped to ``6``.
+
+* The :manual:`cmake-presets(7)` format now supports a
+  ``packagePresets`` field to specify presets for :option:`cpack --preset`.
+
+* The :manual:`cmake-presets(7)` format now supports a
+  ``workflowPresets`` field to specify presets for :option:`cmake --workflow`.
+
+Languages
+---------
+
+* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
+  is now aware of C++26, and defines a ``cxx_std_26`` meta-feature.
+  C++26 compiler modes may also be specified via the :prop_tgt:`CXX_STANDARD`,
+  :prop_tgt:`CUDA_STANDARD`, :prop_tgt:`HIP_STANDARD`,
+  or :prop_tgt:`OBJCXX_STANDARD` target properties.
+
+* ``CUDA`` language support now includes device link-time optimization when
+  using ``nvcc``.  The :variable:`CMAKE_INTERPROCEDURAL_OPTIMIZATION` variable
+  and the associated :prop_tgt:`INTERPROCEDURAL_OPTIMIZATION` target property
+  will activate device LTO.
+
+Command-Line
+------------
+
+* A :ref:`cmake --workflow --preset <Workflow Mode>` mode was added
+  to drive sequences of configure, build, test, and package operations
+  through a single command.
+
+* The :option:`cmake -E capabilities <cmake-E capabilities>` command
+  gained a new ``tls`` field that tells whether or not TLS is enabled.
+
+* The :option:`cmake -E env <cmake-E env>` command-line tool gained
+  a ``--modify`` flag to support :prop_test:`ENVIRONMENT_MODIFICATION`
+  operations.
+
+* The :option:`cmake --debug-trycompile` option now prints log messages
+  reporting the directory in which each try-compile check is done.
+
+Compilers
+---------
+
+* Support for the `Tasking compiler toolsets`_ (SmartCode, TriCore,
+  Standalone: ARM, MCS, 8051) was added with compiler id ``Tasking``.
+  See the :variable:`CMAKE_TASKING_TOOLSET` variable.
+
+.. _`Tasking compiler toolsets`: https://tasking.com
+
+Commands
+--------
+
+* The :command:`add_subdirectory` command gained a ``SYSTEM`` option
+  to enable the :prop_dir:`SYSTEM` directory property in the subdirectory.
+
+* The :command:`block` and :command:`endblock` commands were added to manage
+  specific scopes (policy or variable) for a contained block of commands.
+
+* The :command:`cmake_language` command gained a new
+  ``GET_MESSAGE_LOG_LEVEL`` sub-command.  It can be used to
+  query the current message logging level.
+
+* The :command:`find_file`, :command:`find_path`, :command:`find_library`, and
+  :command:`find_program` commands gained a ``VALIDATOR`` option to specify a
+  function to be called for each candidate item to validate it.
+
+* The :command:`find_package` command now considers paths of
+  the form ``<prefix>/<name>*/(cmake|CMake)/<name>*/`` when
+  searching for package configuration files.
+
+* The :command:`return` command gained a ``PROPAGATE`` option to propagate
+  variables to the scope to which control returns.
+  See policy :policy:`CMP0140`.
+
+* The :command:`try_compile` and :command:`try_run` commands gained new
+  signatures that more consistently use keyword dispatch and do not require a
+  binary directory to be specified.  Additionally, these signatures use a
+  unique directory for each invocation, which allows multiple outputs to be
+  preserved when using :option:`cmake --debug-trycompile`.
+
+* The :command:`try_compile` and :command:`try_run` commands gained the
+  option ``NO_CACHE`` to store results in normal variables.
+
+* The :command:`try_run` command gained ``RUN_OUTPUT_STDOUT_VARIABLE``
+  and ``RUN_OUTPUT_STDERR_VARIABLE`` options to capture stdout and stderr
+  separately from the output of the compiled program.
+
+Variables
+---------
+
+* The :variable:`BSD` and :variable:`CMAKE_HOST_BSD` variables are now set
+  to a string value when the target or host system is BSD, respectively.
+
+* The :variable:`LINUX` and :variable:`CMAKE_HOST_LINUX` variables are
+  now set to true when the target or host system is Linux, respectively.
+
+* The :variable:`CMAKE_MSVC_DEBUG_INFORMATION_FORMAT` variable and
+  :prop_tgt:`MSVC_DEBUG_INFORMATION_FORMAT` target property were introduced
+  to select the debug information format for compilers targeting the MSVC ABI.
+  See policy :policy:`CMP0141`.
+
+* The :variable:`CMAKE_XCODE_SCHEME_ENABLE_GPU_API_VALIDATION` variable and
+  corresponding :prop_tgt:`XCODE_SCHEME_ENABLE_GPU_API_VALIDATION` target
+  property were added to tell the :generator:`Xcode` generator what to put
+  in the scheme's ``Metal: API Validation`` setting.
+
+* The :variable:`CMAKE_XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION` variable and
+  corresponding :prop_tgt:`XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION` target
+  property were added to tell the :generator:`Xcode` generator what to put
+  in the scheme's ``Metal: Shader Validation`` setting.
+
+* The :variable:`CMAKE_XCODE_SCHEME_LAUNCH_MODE` variable and corresponding
+  :prop_tgt:`XCODE_SCHEME_LAUNCH_MODE` target property were added to tell
+  the :generator:`Xcode` generator what to put in the scheme's "Launch"
+  mode setting.
+
+* The :variable:`CMAKE_XCODE_SCHEME_LAUNCH_CONFIGURATION` variable and
+  corresponding :prop_tgt:`XCODE_SCHEME_LAUNCH_CONFIGURATION` target
+  property were added to tell the :generator:`Xcode` generator what
+  configuration to put in the scheme's Launch action.
+
+Properties
+----------
+
+* The :prop_tgt:`<LANG>_COMPILER_LAUNCHER` target property now supports
+  :manual:`generator expressions <cmake-generator-expressions(7)>`.
+
+* The :prop_tgt:`EXPORT_NO_SYSTEM` target property was added to
+  specify that :command:`install(EXPORT)` and :command:`export`
+  commands will generate na imported target with
+  :prop_tgt:`SYSTEM` property ``OFF``.
+
+* The :prop_tgt:`SYSTEM` target property was added to specify
+  whether a target should be treated as a system library (i.e.
+  its include directories are automatically ``SYSTEM`` when
+  compiling consumers).  If not set, the default is the previous
+  behavior: on for imported targets and off for other targets.
+
+* The :prop_dir:`SYSTEM` directory property was added to initialize the
+  :prop_tgt:`SYSTEM` target property for targets created in that directory.
+
+Modules
+-------
+
+* The :module:`FetchContent` module :command:`FetchContent_Declare`
+  command gained a ``SYSTEM`` option to enable the :prop_dir:`SYSTEM`
+  directory property in the subdirectory.
+
+* The :module:`FindCUDAToolkit` module now provides a target for
+  :ref:`nvtx3 <cuda_toolkit_nvtx3>` for CUDA 10.0+, which supersedes
+  :ref:`nvToolsExt <cuda_toolkit_nvToolsExt>`. A deprecation warning
+  is emitted when using ``nvToolsExt`` if the project requires CMake
+  3.25 and CUDA 10.0+ is used.
+
+* The :module:`FindDoxygen` module's version handling has been improved:
+
+  * Multiple candidate installations will now be considered, if needed,
+    to satisfy version constraints.  Previously, only the first one
+    encountered would be considered.
+
+  * Version ranges are supported.
+
+  * Variations in the version format reported by Doxygen are now
+    tolerated (e.g. a trailing git commit hash).
+
+* The :module:`FindOpenAL` module now provides an imported target.
+
+* The :module:`FindOpenSP` module was added to find the OpenSP library.
+
+* The :module:`FindVulkan` module gained support for new components:
+
+  ``dxc``
+    DirectX Shader Compiler.
+
+  ``volk``
+    Volk open-source vulkan meta-loader.
+
+CPack
+-----
+
+* The :cpack_gen:`CPack Archive Generator` gained a new
+  :variable:`CPACK_ARCHIVE_FILE_EXTENSION` variable to control
+  the package file name extension.
+
+* The :cpack_gen:`CPack NSIS Generator` gained two new variables
+  :variable:`CPACK_NSIS_EXECUTABLE_PRE_ARGUMENTS` and
+  :variable:`CPACK_NSIS_EXECUTABLE_POST_ARGUMENTS`
+  to provide arguments to the nsis executable invocation.
+
+* The :module:`CPack` module gained the :variable:`CPACK_READELF_EXECUTABLE`,
+  :variable:`CPACK_OBJCOPY_EXECUTABLE`, and
+  :variable:`CPACK_OBJDUMP_EXECUTABLE` variables to control the locations
+  of binutils used by :manual:`cpack(1)`.
+
+Deprecated and Removed Features
+===============================
+
+* The :prop_tgt:`IMPORTED_NO_SYSTEM` target property has been deprecated
+  in favor of :prop_tgt:`SYSTEM` and :prop_tgt:`EXPORT_NO_SYSTEM`.
+
+* The :generator:`Visual Studio 10 2010` generator has been removed.
+
+* The :generator:`Visual Studio 11 2012` generator is now deprecated
+  and will be removed in a future version of CMake.
+
+Other Changes
+=============
+
+* On Windows, when targeting the MSVC ABI, the :command:`find_library` command
+  now accepts ``.a`` file names after first considering ``.lib``.  This is
+  symmetric with existing behavior when targeting the GNU ABI, in which the
+  command accepts ``.lib`` file names after first considering ``.a``.
+
+* The :envvar:`SSL_CERT_FILE` and :envvar:`SSL_CERT_DIR` environment
+  variables can now be used to override where to find certificate
+  authorities for TLS/SSL operations.
+
+* If :prop_tgt:`<LANG>_CLANG_TIDY` includes a ``-p`` argument, the
+  full compiler command line is no longer appended after ``--``.
+
+* The :generator:`Xcode` generator no longer adds the per-config suffix
+  ``$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)`` to library search paths.
+  See policy :policy:`CMP0142`.
diff --git a/Help/release/dev/BSD.rst b/Help/release/dev/BSD.rst
deleted file mode 100644
index cd2352b..0000000
--- a/Help/release/dev/BSD.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-Variables
----------
-
-* The :variable:`BSD` variable is set to a string value when the target system is BSD.
-  This value can be one of the following: DragonFlyBSD, FreeBSD, OpenBSD, or NetBSD.
-
-* The :variable:`CMAKE_HOST_BSD` variable is set to a string value when the host system is BSD.
-  This value can be one of the following: DragonFlyBSD, FreeBSD, OpenBSD, or NetBSD.
diff --git a/Help/release/dev/E-capabilities-tls.rst b/Help/release/dev/E-capabilities-tls.rst
deleted file mode 100644
index e2324d2..0000000
--- a/Help/release/dev/E-capabilities-tls.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-E-capabilities-tls
-------------------
-
-* The :manual:`cmake -E capabilities <cmake(1)>` command gained a new ``tls``
-  field that tells whether or not TLS is enabled.
diff --git a/Help/release/dev/FindOpenSP-module.rst b/Help/release/dev/FindOpenSP-module.rst
deleted file mode 100644
index 9df6815..0000000
--- a/Help/release/dev/FindOpenSP-module.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-FindOpenSP-module
------------------
-
-* The :module:`FindOpenSP` module was added to find the OpenSP library.
diff --git a/Help/release/dev/FindVulkan-dxc.rst b/Help/release/dev/FindVulkan-dxc.rst
deleted file mode 100644
index e22f016..0000000
--- a/Help/release/dev/FindVulkan-dxc.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-FindVulkan-dxc
---------------
-
-* The :module:`FindVulkan` module gained support for a DirectX Shader Compiler
-  component, ``dxc``.
diff --git a/Help/release/dev/LINUX.rst b/Help/release/dev/LINUX.rst
deleted file mode 100644
index b837a1f..0000000
--- a/Help/release/dev/LINUX.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Variables
----------
-
-* The :variable:`LINUX` variable is set to true when the target system is Linux.
-
-* The :variable:`CMAKE_HOST_LINUX` variable is set to true when the host system is Linux.
diff --git a/Help/release/dev/MsvcDebugInformationFormatAbstraction.rst b/Help/release/dev/MsvcDebugInformationFormatAbstraction.rst
deleted file mode 100644
index d0c077c..0000000
--- a/Help/release/dev/MsvcDebugInformationFormatAbstraction.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-MsvcDebugInformationFormatAbstraction
--------------------------------------
-
-* The :variable:`CMAKE_MSVC_DEBUG_INFORMATION_FORMAT` variable and
-  :prop_tgt:`MSVC_DEBUG_INFORMATION_FORMAT` target property were introduced
-  to select the debug information format for compilers targeting the MSVC ABI.
-  See policy :policy:`CMP0141`.
diff --git a/Help/release/dev/UseSWIG-perl-extra-files.rst b/Help/release/dev/UseSWIG-perl-extra-files.rst
deleted file mode 100644
index d7490ec..0000000
--- a/Help/release/dev/UseSWIG-perl-extra-files.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-UseSWIG-perl-extra-files
-------------------------
-
-* The :module:`UseSWIG` module gained knowledge about generated Perl module
-  files (extension ``.pm``).
diff --git a/Help/release/dev/add_tasking_compiler.rst b/Help/release/dev/add_tasking_compiler.rst
deleted file mode 100644
index 705f923..0000000
--- a/Help/release/dev/add_tasking_compiler.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-add_tasking_compiler
---------------------
-
- * Support for the `Tasking compiler toolsets`_ (SmartCode, TriCore,
-   Standalone: ARM, MCS, 8051) was added with compiler id ``Tasking``.
-   See the :variable:`CMAKE_TASKING_TOOLSET` variable.
-
-.. _`Tasking compiler toolsets`: https://tasking.com
diff --git a/Help/release/dev/block-command.rst b/Help/release/dev/block-command.rst
deleted file mode 100644
index a740c0b..0000000
--- a/Help/release/dev/block-command.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-block-command
--------------
-
-* CMake language gains the commands :command:`block` and :command:`endblock` to
-  manage specific scopes (policy or variable) for group of commands.
diff --git a/Help/release/dev/clang-tidy-prefer-p-option.rst b/Help/release/dev/clang-tidy-prefer-p-option.rst
deleted file mode 100644
index 816c7dd..0000000
--- a/Help/release/dev/clang-tidy-prefer-p-option.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-clang-tidy-prefer-p-option
---------------------------
-
-* If :prop_tgt:`<LANG>_CLANG_TIDY` includes a ``-p`` argument, the
-  full compiler command line is no longer appended after ``--``.
diff --git a/Help/release/dev/cmake-E-env-modify.rst b/Help/release/dev/cmake-E-env-modify.rst
deleted file mode 100644
index 08f1fb5..0000000
--- a/Help/release/dev/cmake-E-env-modify.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-cmake-E-env-modify
-------------------
-
-* A new ``--modify`` flag was added to :option:`cmake -E env <cmake-E env>` to
-  support :prop_test:`ENVIRONMENT_MODIFICATION` operations.
diff --git a/Help/release/dev/cmake-presets-package.rst b/Help/release/dev/cmake-presets-package.rst
deleted file mode 100644
index 8f7ea6b..0000000
--- a/Help/release/dev/cmake-presets-package.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-cmake-presets-package
----------------------
-
-* The :manual:`cmake-presets(7)` schema version has been bumped to ``6``.
-* The :manual:`cmake-presets(7)` format now supports a ``packagePresets`` field.
diff --git a/Help/release/dev/cmake-presets-workflow.rst b/Help/release/dev/cmake-presets-workflow.rst
deleted file mode 100644
index db93d72..0000000
--- a/Help/release/dev/cmake-presets-workflow.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-cmake-presets-workflow
-----------------------
-
-* The :manual:`cmake-presets(7)` format now supports a ``workflowPresets`` field.
diff --git a/Help/release/dev/cmake_language_GET_MESSAGE_LOG_LEVEL.rst b/Help/release/dev/cmake_language_GET_MESSAGE_LOG_LEVEL.rst
deleted file mode 100644
index 6e99a05..0000000
--- a/Help/release/dev/cmake_language_GET_MESSAGE_LOG_LEVEL.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-cmake-language_GET_MESSAGE_LOG_LEVEL
-------------------------------------
-
-* The :command:`cmake_language` command gained a new
-  ``GET_MESSAGE_LOG_LEVEL`` sub-command.  It can be used to
-  query the current message logging level.
diff --git a/Help/release/dev/compiler-launcher-genexp.rst b/Help/release/dev/compiler-launcher-genexp.rst
deleted file mode 100644
index 0e79992..0000000
--- a/Help/release/dev/compiler-launcher-genexp.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-compiler-launcher-genexp
-------------------------
-
-* The :prop_tgt:`<LANG>_COMPILER_LAUNCHER` target property now supports
-  :manual:`generator expressions <cmake-generator-expressions(7)>`.
diff --git a/Help/release/dev/cpack-archive-custom-extension.rst b/Help/release/dev/cpack-archive-custom-extension.rst
deleted file mode 100644
index 38ad36f..0000000
--- a/Help/release/dev/cpack-archive-custom-extension.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-cpack-archive-custom-extension
-------------------------------
-
-* The :cpack_gen:`CPack Archive Generator` gained a new
-  :variable:`CPACK_ARCHIVE_FILE_EXTENSION` variable to control
-  the package file name extension.
diff --git a/Help/release/dev/cpack-nsis-arguments-command-line.rst b/Help/release/dev/cpack-nsis-arguments-command-line.rst
deleted file mode 100644
index 610a338..0000000
--- a/Help/release/dev/cpack-nsis-arguments-command-line.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-cpack-nsis-arguments-command-line
----------------------------------
-
-* The :cpack_gen:`CPack NSIS Generator` gained two new variables
-  :variable:`CPACK_NSIS_EXECUTABLE_PRE_ARGUMENTS` and
-  :variable:`CPACK_NSIS_EXECUTABLE_POST_ARGUMENTS`
-  to provide arguments to the nsis executable invocation.
diff --git a/Help/release/dev/cpack-reuse-cmake-tools.rst b/Help/release/dev/cpack-reuse-cmake-tools.rst
deleted file mode 100644
index 144a6b3..0000000
--- a/Help/release/dev/cpack-reuse-cmake-tools.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-cpack-reuse-cmake-tools
------------------------
-
-* The :module:`CPack` module gained the :variable:`CPACK_READELF_EXECUTABLE`,
-  :variable:`CPACK_OBJCOPY_EXECUTABLE`, and
-  :variable:`CPACK_OBJDUMP_EXECUTABLE` variables to control the locations
-  of binutils used by :manual:`cpack(1)`.
diff --git a/Help/release/dev/cuda-device-lto.rst b/Help/release/dev/cuda-device-lto.rst
deleted file mode 100644
index 113062b..0000000
--- a/Help/release/dev/cuda-device-lto.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-cuda-device-lto
----------------
-
-* ``CUDA`` language now supports device link time optimization when using
-  ``nvcc``. The :variable:`CMAKE_INTERPROCEDURAL_OPTIMIZATION` variable and
-  the associated :prop_tgt:`INTERPROCEDURAL_OPTIMIZATION` target property will
-  activate device LTO.
diff --git a/Help/release/dev/cxx_std_26.rst b/Help/release/dev/cxx_std_26.rst
deleted file mode 100644
index 831f567..0000000
--- a/Help/release/dev/cxx_std_26.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-cxx_std_26
-----------
-
-* C++26 compiler modes may now be specified via the :prop_tgt:`CXX_STANDARD`,
-  :prop_tgt:`CUDA_STANDARD`, :prop_tgt:`HIP_STANDARD`, or
-  :prop_tgt:`OBJCXX_STANDARD` target properties,
-  or via the :manual:`Compile Features <cmake-compile-features(7)>`
-  functionality's ``cxx_std_26`` meta-feature.
diff --git a/Help/release/dev/detect-lib_foo.a-msvc.rst b/Help/release/dev/detect-lib_foo.a-msvc.rst
deleted file mode 100644
index 4080a5b..0000000
--- a/Help/release/dev/detect-lib_foo.a-msvc.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-detect-lib_foo.a-msvc
----------------------
-
-* On Windows, when targeting the MSVC ABI, the :command:`find_library` command
-  now accepts ``.a`` file names after first considering ``.lib``.  This is
-  symmetric with existing behavior when targeting the GNU ABI, in which the
-  command accepts ``.lib`` file names after first considering ``.a``.
diff --git a/Help/release/dev/env-tls-certs.rst b/Help/release/dev/env-tls-certs.rst
deleted file mode 100644
index 4afadb4..0000000
--- a/Help/release/dev/env-tls-certs.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-env-tls-certs
--------------
-
-* The :envvar:`SSL_CERT_FILE` and :envvar:`SSL_CERT_DIR` environment
-  variables are now used to find certificate authorities for TLS/SSL
-  operations.
diff --git a/Help/release/dev/find-cuda-toolkit-nvtx3.rst b/Help/release/dev/find-cuda-toolkit-nvtx3.rst
deleted file mode 100644
index b16ed9f..0000000
--- a/Help/release/dev/find-cuda-toolkit-nvtx3.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-find-cuda-toolkit-nvtx3
------------------------
-
-* The :module:`FindCUDAToolkit` module now provides a target for
-  :ref:`nvtx3 <cuda_toolkit_nvtx3>` for CUDA 10.0+, which supersedes
-  :ref:`nvToolsExt <cuda_toolkit_nvToolsExt>`. A deprecation warning is emitted
-  when using ``nvToolsExt`` if the project requires CMake 3.25 and CUDA 10.0+
-  is used.
diff --git a/Help/release/dev/find_item-VALIDATOR.rst b/Help/release/dev/find_item-VALIDATOR.rst
deleted file mode 100644
index 2cda421..0000000
--- a/Help/release/dev/find_item-VALIDATOR.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-find_item-VALIDATOR
--------------------
-
-* :command:`find_file`, :command:`find_path`, :command:`find_library`, and
-  :command:`find_program` commands gain the capability to specify a function
-  which will be called for each found item to validate it.
diff --git a/Help/release/dev/find_package-one-more-path.rst b/Help/release/dev/find_package-one-more-path.rst
deleted file mode 100644
index 554b67d..0000000
--- a/Help/release/dev/find_package-one-more-path.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-find_package-one-more-path
---------------------------
-
-* The :command:`find_package` command now considers paths of
-  the form ``<prefix>/<name>*/(cmake|CMake)/<name>*/`` when
-  searching for package configuration files.
diff --git a/Help/release/dev/finddoxygen-better-version-checking.rst b/Help/release/dev/finddoxygen-better-version-checking.rst
deleted file mode 100644
index 3c2215d..0000000
--- a/Help/release/dev/finddoxygen-better-version-checking.rst
+++ /dev/null
@@ -1,11 +0,0 @@
-finddoxygen-better-version-checking
------------------------------------
-
-* The :module:`FindDoxygen` module now evaluates as many candidate
-  Doxygen installs as are necessary to satisfy version constraints,
-  with the package considered to be not found if none are available.
-
-* The :module:`FindDoxygen` module now handles version ranges.
-
-* The :module:`FindDoxygen` module now ignores non-semantic portions
-  of the output from Doxygen's `--version` option.
diff --git a/Help/release/dev/findopenal-add-import-library.rst b/Help/release/dev/findopenal-add-import-library.rst
deleted file mode 100644
index 6c9c93f..0000000
--- a/Help/release/dev/findopenal-add-import-library.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-findopenal-add-import-library
------------------------------
-
-* The :module:`FindOpenAL` module now provides an imported target.
diff --git a/Help/release/dev/findvulkan-volk.rst b/Help/release/dev/findvulkan-volk.rst
deleted file mode 100644
index cb77078..0000000
--- a/Help/release/dev/findvulkan-volk.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-findvulkan-volk
----------------
-
-* The :module:`FindVulkan` module now includes a ``volk`` component
-  for the Volk open source vulkan meta-loader.
diff --git a/Help/release/dev/genex-LINK_LIBRARY-FRAMEWORK-supports-suffix.rst b/Help/release/dev/genex-LINK_LIBRARY-FRAMEWORK-supports-suffix.rst
deleted file mode 100644
index e4d82ee..0000000
--- a/Help/release/dev/genex-LINK_LIBRARY-FRAMEWORK-supports-suffix.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-genex-LINK_LIBRARY-FRAMEWORK-supports-suffix
---------------------------------------------
-
-The :genex:`$<LINK_LIBRARY>` generator expression gains the capability, for the
-``FRAMEWORK`` features, to handle the suffix of the framework library name.
diff --git a/Help/release/dev/p1689r5.rst b/Help/release/dev/p1689r5.rst
deleted file mode 100644
index a630dc4..0000000
--- a/Help/release/dev/p1689r5.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-p1689r5
--------
-
-* C++ module scanning now supports the latest revision, `P1689R5`_.
-
-.. _`P1689r5`: http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p1689r5.html
diff --git a/Help/release/dev/remove-vs10-generator.rst b/Help/release/dev/remove-vs10-generator.rst
deleted file mode 100644
index 32e1da6..0000000
--- a/Help/release/dev/remove-vs10-generator.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-remove-vs10-generator
----------------------
-
-* The :generator:`Visual Studio 10 2010` generator has been removed.
diff --git a/Help/release/dev/return-PROPAGATE.rst b/Help/release/dev/return-PROPAGATE.rst
deleted file mode 100644
index 7308d20..0000000
--- a/Help/release/dev/return-PROPAGATE.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-return-PROPAGATE
-----------------
-
-* The :command:`return` command gains the capability to propagate variables to
-  the include directory of function caller scope. See policy :policy:`CMP0140`.
diff --git a/Help/release/dev/system.rst b/Help/release/dev/system.rst
deleted file mode 100644
index 879e279..0000000
--- a/Help/release/dev/system.rst
+++ /dev/null
@@ -1,25 +0,0 @@
-system
-------
-
-* The :prop_tgt:`SYSTEM` target property was added to specify
-  that a target should be treated as a system library (i.e.
-  its include directories are automatically ``SYSTEM`` when
-  compiling consumers).
-
-* The :prop_dir:`SYSTEM` directory property was added to initialize the
-  :prop_tgt:`SYSTEM` target property for targets created in that directory.
-
-* The :command:`add_subdirectory` command gained a ``SYSTEM`` option
-  to enable the :prop_dir:`SYSTEM` directory property in the subdirectory.
-
-* The :module:`FetchContent` module :command:`FetchContent_Declare`
-  command gained a ``SYSTEM`` option to enable the :prop_dir:`SYSTEM`
-  directory property in the subdirectory.
-
-* The :prop_tgt:`EXPORT_NO_SYSTEM` target property was added to
-  specify that :command:`install(EXPORT)` and :command:`export`
-  commands will generate a imported target with
-  :prop_tgt:`SYSTEM` property `OFF`.
-
-* The :prop_tgt:`IMPORTED_NO_SYSTEM` target property was deprecated
-  in favor of :prop_tgt:`SYSTEM` and :prop_tgt:`EXPORT_NO_SYSTEM`.
diff --git a/Help/release/dev/try_compile-no_cache.rst b/Help/release/dev/try_compile-no_cache.rst
deleted file mode 100644
index ebabcd5..0000000
--- a/Help/release/dev/try_compile-no_cache.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-try_compile-no_cache
---------------------
-
-* The :command:`try_compile` and :command:`try_run` commands gained the option
-  ``NO_CACHE`` to store results in normal variables.
diff --git a/Help/release/dev/try_compile-signatures.rst b/Help/release/dev/try_compile-signatures.rst
deleted file mode 100644
index c32babd..0000000
--- a/Help/release/dev/try_compile-signatures.rst
+++ /dev/null
@@ -1,11 +0,0 @@
-try_compile-signatures
-----------------------
-
-* The :command:`try_compile` and :command:`try_run` commands gained new
-  signatures that more consistently use keyword dispatch and do not require a
-  binary directory to be specified.  Additionally, these signatures use a
-  unique directory for each invocation, which allows multiple outputs to be
-  preserved when using :option:`--debug-trycompile <cmake --debug-trycompile>`.
-
-* The :option:`cmake --debug-trycompile` option now prints log messages
-  reporting the directory in which each try-compile check is done.
diff --git a/Help/release/dev/try_run_split_output.rst b/Help/release/dev/try_run_split_output.rst
deleted file mode 100644
index 98aedd6..0000000
--- a/Help/release/dev/try_run_split_output.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-try_run_split_output
---------------------
-
-* The :command:`try_run` command gained ``RUN_OUTPUT_STDOUT_VARIABLE``
-  and ``RUN_OUTPUT_STDERR_VARIABLE`` options to capture stdout and stderr
-  separately from the output of the compiled program.
diff --git a/Help/release/dev/vs11-deprecate.rst b/Help/release/dev/vs11-deprecate.rst
deleted file mode 100644
index 2ee69bb..0000000
--- a/Help/release/dev/vs11-deprecate.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-vs11-deprecate
---------------
-
-* The :generator:`Visual Studio 11 2012` generator is now deprecated
-  and will be removed in a future version of CMake.
diff --git a/Help/release/dev/xcode-gpu-validation.rst b/Help/release/dev/xcode-gpu-validation.rst
deleted file mode 100644
index 86f7e96..0000000
--- a/Help/release/dev/xcode-gpu-validation.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-xcode-gpu-validation
---------------------
-
-* The :variable:`CMAKE_XCODE_SCHEME_ENABLE_GPU_API_VALIDATION` variable and
-  corresponding :prop_tgt:`XCODE_SCHEME_ENABLE_GPU_API_VALIDATION` target
-  property were added to tell the :generator:`Xcode` generator what to put
-  in the scheme's ``Metal: API Validation`` setting.
-
-* The :variable:`CMAKE_XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION` variable and
-  corresponding :prop_tgt:`XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION` target
-  property were added to tell the :generator:`Xcode` generator what to put
-  in the scheme's ``Metal: Shader Validation`` setting.
diff --git a/Help/release/dev/xcode-launch-mode.rst b/Help/release/dev/xcode-launch-mode.rst
deleted file mode 100644
index 701b502..0000000
--- a/Help/release/dev/xcode-launch-mode.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-xcode-launch-mode
------------------
-
-* The :variable:`CMAKE_XCODE_SCHEME_LAUNCH_MODE` variable and corresponding
-  :prop_tgt:`XCODE_SCHEME_LAUNCH_MODE` target property were added to tell
-  the :generator:`Xcode` generator what to put in the scheme's "Launch"
-  mode setting.
-
-* The :variable:`CMAKE_XCODE_SCHEME_LAUNCH_CONFIGURATION` variable and
-  corresponding :prop_tgt:`XCODE_SCHEME_LAUNCH_CONFIGURATION` target
-  property were added to tell the :generator:`Xcode` generator what
-  configuration to put in the scheme's Launch action.
diff --git a/Help/release/dev/xcode-lib-dirs.rst b/Help/release/dev/xcode-lib-dirs.rst
deleted file mode 100644
index fc1fe1b..0000000
--- a/Help/release/dev/xcode-lib-dirs.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-xcode-lib-dirs
---------------
-
-* The :generator:`Xcode` generator no longer adds the per-config suffix
-  ``$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)`` to library search paths.
-  See policy :policy:`CMP0142`.
diff --git a/Help/release/index.rst b/Help/release/index.rst
index 11d5a11..50e06bb 100644
--- a/Help/release/index.rst
+++ b/Help/release/index.rst
@@ -15,6 +15,7 @@ Releases
 .. toctree::
    :maxdepth: 1
 
+   3.25 <3.25>
    3.24 <3.24>
    3.23 <3.23>
    3.22 <3.22>