Merge topic 'doc-3.27-relnotes'

6bc97b453c Help: Update Sphinx versionadded directives for 3.27 release
78d2c9fef0 Help: Organize and revise 3.27 release notes
e6bcda8c39 Help: Consolidate 3.27 release notes

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

46 files changed, 250 insertions, 280 deletions

diff --git a/Help/prop_tgt/AUTOGEN_USE_SYSTEM_INCLUDE.rst b/Help/prop_tgt/AUTOGEN_USE_SYSTEM_INCLUDE.rst
index 84212c8..37d6276 100644
--- a/Help/prop_tgt/AUTOGEN_USE_SYSTEM_INCLUDE.rst
+++ b/Help/prop_tgt/AUTOGEN_USE_SYSTEM_INCLUDE.rst
@@ -1,6 +1,8 @@
 AUTOGEN_USE_SYSTEM_INCLUDE
 --------------------------
 
+.. versionadded:: 3.27
+
 ``AUTOGEN_USE_SYSTEM_INCLUDE`` is a boolean property that can be set
 on a target to indicate that the autogen target include directory should
 be added as a system include directory or normal include directory to the
diff --git a/Help/release/3.27.rst b/Help/release/3.27.rst
new file mode 100644
index 0000000..db087fe
--- /dev/null
+++ b/Help/release/3.27.rst
@@ -0,0 +1,247 @@
+CMake 3.27 Release Notes
+************************
+
+.. only:: html
+
+  .. contents::
+
+Changes made since CMake 3.26 include the following.
+
+New Features
+============
+
+Debugger
+--------
+
+* :manual:`cmake(1)` now supports interactive debugging of the CMake language.
+  See the :option:`--debugger <cmake --debugger>` option.
+
+Presets
+-------
+
+* :manual:`cmake-presets(7)` files now support schema version ``7``.
+
+* :manual:`cmake-presets(7)` now supports ``$penv{}`` macro expansion
+  in ``include`` fields.
+
+Generators
+----------
+
+* The :ref:`Makefile <Makefile Generators>` and :ref:`Ninja <Ninja Generators>`
+  generators now support using the ``--dependency-file`` linker flag,
+  added by GNU Binutils 2.35 and LLVM's LLD 12.0.0, so that files read by the
+  linker will cause a relink if they change (typically modified timestamps).
+  See the :variable:`CMAKE_LINK_DEPENDS_USE_LINKER` variable.
+
+* The :ref:`Visual Studio Generators` for VS 2015 and above learned to
+  select the Windows SDK version explicitly using a ``version=`` field
+  in the :variable:`CMAKE_GENERATOR_PLATFORM` variable.
+  See :ref:`Visual Studio Platform Selection`.
+
+Languages
+---------
+
+* The ``CXX`` language now treats source file extensions
+  ``.ccm``, ``.cxxm``, and ``.c++m`` as C++.
+
+File-Based API
+--------------
+
+* The :manual:`cmake-file-api(7)` "codemodel" version 2 ``version`` field has
+  been updated to 2.6.
+
+* The :manual:`cmake-file-api(7)` "codemodel" version 2 "target" object gained
+  a new "frameworks" field in the "compileGroups" objects.
+
+Platforms
+---------
+
+* Apple text-based stubs (i.e. ``.tbd`` files) may now be created for shared
+  libraries on macOS.  See the :prop_tgt:`ENABLE_EXPORTS` property.
+
+Commands
+--------
+
+* The :command:`add_custom_command` command gained a new
+  ``DEPENDS_EXPLICIT_ONLY`` option to tell the :ref:`Ninja Generators`
+  not to add any dependencies implied by the target to which it is
+  attached.  The :variable:`CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY`
+  variable was added to enable ``DEPENDS_EXPLICIT_ONLY`` on all calls to
+  :command:`add_custom_command` command.
+
+* The :command:`cmake_file_api` command was added for projects to add
+  :manual:`CMake file API <cmake-file-api(7)>` queries for the current
+  CMake run.
+
+* The :command:`find_package` command now searches prefixes specified by
+  upper-case :variable:`<PACKAGENAME>_ROOT` CMake variables and upper-case
+  :envvar:`<PACKAGENAME>_ROOT` environment variables.
+  See policy :policy:`CMP0144`.
+
+* The :command:`install(CODE)` and :command:`install(SCRIPT)` commands
+  now support the :genex:`$<INSTALL_PREFIX>` generator expression.
+
+Variables
+---------
+
+* The :variable:`CMAKE_DLL_NAME_WITH_SOVERSION` variable and associated
+  :prop_tgt:`DLL_NAME_WITH_SOVERSION` target property were added to
+  optionally append the :prop_tgt:`SOVERSION` to the filename of the
+  ``.dll`` part of a shared library on Windows.
+
+* Variables :variable:`CMAKE_VS_DEBUGGER_COMMAND`,
+  :variable:`CMAKE_VS_DEBUGGER_COMMAND_ARGUMENTS`,
+  :variable:`CMAKE_VS_DEBUGGER_ENVIRONMENT`, and
+  :variable:`CMAKE_VS_DEBUGGER_WORKING_DIRECTORY` were added to initialize
+  corresponding target properties.
+
+* The :variable:`CMAKE_VS_WINDOWS_TARGET_PLATFORM_MIN_VERSION` variable
+  was added to initialize the :prop_tgt:`VS_WINDOWS_TARGET_PLATFORM_MIN_VERSION`
+  target property on all targets when they are created.
+
+Properties
+----------
+
+* A :prop_tgt:`CUDA_CUBIN_COMPILATION` target property was added to
+  :ref:`Object Libraries` to support compiling to ``.cubin`` files
+  instead of host object files. Currently only supported with NVIDIA.
+
+* A :prop_tgt:`CUDA_FATBIN_COMPILATION` target property was added to
+  :ref:`Object Libraries` to support compiling to ``.fatbin`` files
+  instead of host object files. Currently only supported with NVIDIA.
+
+* A :prop_tgt:`CUDA_OPTIX_COMPILATION` target property was added to
+  :ref:`Object Libraries` to support compiling to ``.optixir`` files
+  instead of host object files. Currently only supported with NVIDIA.
+
+* The :prop_tgt:`<LANG>_CLANG_TIDY`, :prop_tgt:`<LANG>_CPPCHECK`,
+  :prop_tgt:`<LANG>_CPPLINT`, and :prop_tgt:`<LANG>_INCLUDE_WHAT_YOU_USE`,
+  target properties now support
+  :manual:`generator expressions <cmake-generator-expressions(7)>`.
+
+* The :prop_tgt:`<LANG>_LINKER_LAUNCHER` target property now supports
+  :manual:`generator expressions <cmake-generator-expressions(7)>`.
+
+* The :prop_sf:`SKIP_LINTING` source file property was added to suppress
+  target-wide code checks on specific sources.
+
+Modules
+-------
+
+* The :module:`FindCUDAToolkit` module now provides an imported target for
+  ``cudla``, if found.
+
+* The :module:`FindDoxygen` module's :command:`doxygen_add_docs` command gained
+  a ``CONFIG_FILE`` option to specify a custom doxygen configuration file.
+
+* The :module:`FindOpenGL` module gained support for components
+  ``GLES2`` and ``GLES3``.
+
+* The :module:`FindwxWidgets` module now provides an imported target.
+
+Generator Expressions
+---------------------
+
+* The :genex:`COMPILE_ONLY` generator expression was added to specify
+  compilation usage requirements without any linking requirements.
+
+* ``$<LIST:...>`` generator expressions were added for
+  :ref:`query <GenEx List Queries>`,
+  :ref:`transformation <GenEx List Transformations>`, and
+  :ref:`ordering <GenEx List Ordering>` operations on
+  :ref:`lists <CMake Language Lists>`.
+
+* ``$<PATH:...>`` generator expressions for
+  :ref:`decomposition <GenEx Path Decomposition>` and
+  :ref:`transformation <GenEx Path Transformations>` operations learned
+  to process :ref:`lists <CMake Language Lists>` of paths element-wise.
+
+Autogen
+-------
+
+* The :variable:`CMAKE_AUTOMOC_EXECUTABLE`,
+  :variable:`CMAKE_AUTORCC_EXECUTABLE`, and
+  :variable:`CMAKE_AUTOUIC_EXECUTABLE` variables were added to initialize the
+  corresponding target properties as targets are created.
+
+* The :prop_tgt:`AUTOGEN_USE_SYSTEM_INCLUDE` target property and
+  corresponding :variable:`CMAKE_AUTOGEN_USE_SYSTEM_INCLUDE` variable were
+  added to explicitly control whether autogen headers are
+  considered system headers.
+
+* The :prop_tgt:`INTERFACE_AUTOMOC_MACRO_NAMES` target property was added to
+  specify macro names for ``moc`` as a transitive usage requirement.
+
+CTest
+-----
+
+* The :prop_test:`TIMEOUT_SIGNAL_NAME` and
+  :prop_test:`TIMEOUT_SIGNAL_GRACE_PERIOD` test properties were added
+  to specify a POSIX signal to send to a test process when its timeout
+  is reached.
+
+CPack
+-----
+
+* The :cpack_gen:`CPack Inno Setup Generator` was added to package using
+  Inno Setup.
+
+Deprecated and Removed Features
+===============================
+
+* Compatibility with versions of CMake older than 3.5 is now deprecated
+  and will be removed from a future version.  Calls to
+  :command:`cmake_minimum_required` or :command:`cmake_policy` that set
+  the policy version to an older value now issue a deprecation diagnostic.
+
+* The :ref:`Extra Generators` have been deprecated.  IDEs may use the
+  :manual:`cmake-file-api(7)` to view CMake-generated project build trees.
+
+* The :module:`FindCUDA` module, which has been deprecated since CMake 3.10,
+  has been removed by policy :policy:`CMP0146`.  Port projects to CMake's
+  first-class ``CUDA`` language support.
+
+* The :module:`FindPythonInterp` and :module:`FindPythonLibs` modules,
+  which have been deprecated since CMake 3.12, have been removed by
+  policy :policy:`CMP0148`.  Port projects to :module:`FindPython3`,
+  :module:`FindPython2`, or :module:`FindPython`.
+
+* The :module:`Dart` and :module:`FindDart` modules have been deprecated via
+  policy :policy:`CMP0145`.  Port projects to the :module:`CTest` module.
+
+* The :generator:`Visual Studio 9 2008` generator is now deprecated
+  and will be removed in a future version of CMake.
+
+Other Changes
+=============
+
+* ``cmake --build $dir --verbose`` will now print the working directory and
+  command line used to perform the build.
+
+* The :module:`ExternalProject` and :module:`FetchContent` modules
+  now resolve relative ``GIT_REPOSITORY`` paths as relative to the
+  parent project's remote, not as a relative local file system path.
+  See :policy:`CMP0150`.
+
+* The :module:`ExternalProject` ``configure`` step no longer re-runs on
+  every build when the ``UPDATE_DISCONNECTED`` option is enabled.
+  It will only re-run if details of the ``download``, ``update``,
+  or ``patch`` step change.
+
+* The :module:`ExternalProject` ``update`` and ``patch`` steps now always
+  re-run if any of their details change, even if the ``UPDATE_DISCONNECTED``
+  option is enabled.  If using the ``GIT`` download method, and the ``GIT_TAG``
+  is changed to a commit that is not already known locally, an error is now
+  issued instead of silently using the previous ``GIT_TAG``.
+
+* The :module:`FindPython`, :module:`FindPython2` and :module:`FindPython3`
+  modules now support the Windows ARM64 platform.
+
+* The :command:`file(GET_RUNTIME_DEPENDENCIES)` command now case-preserves
+  DLL names reported on Windows.  They are still converted to lowercase
+  for filter matching.
+
+* The :prop_tgt:`SYSTEM` target property is now honored for Apple Frameworks.
+
+* :ref:`Visual Studio Generators`, for VS 15.8 (2017) and newer, now
+  build custom commands in parallel.  See policy :policy:`CMP0147`.
diff --git a/Help/release/dev/Apple-tbd-files-management.rst b/Help/release/dev/Apple-tbd-files-management.rst
deleted file mode 100644
index edcfe55..0000000
--- a/Help/release/dev/Apple-tbd-files-management.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Apple-tbd-files-management
---------------------------
-
-* Support for text-based stubs (i.e. ``.tbd`` files) was added on macOS
-  platform. This capability is managed through the :prop_tgt:`ENABLE_EXPORTS`
-  property.
diff --git a/Help/release/dev/ExternalProject-FetchContent-relative-git-remotes.rst b/Help/release/dev/ExternalProject-FetchContent-relative-git-remotes.rst
deleted file mode 100644
index d467620..0000000
--- a/Help/release/dev/ExternalProject-FetchContent-relative-git-remotes.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-ExternalProject-FetchContent-Relative-git-remotes
--------------------------------------------------
-
-* The :module:`ExternalProject` and :module:`FetchContent` modules
-  now resolve relative `GIT_REPOSITORY` paths as relative to the
-  parent project's remote, not as a relative local file system path.
-  See :policy:`CMP0150`.
diff --git a/Help/release/dev/FileAPI-Frameworks.rst b/Help/release/dev/FileAPI-Frameworks.rst
deleted file mode 100644
index 65cf043..0000000
--- a/Help/release/dev/FileAPI-Frameworks.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-FileAPI-Frameworks
-------------------
-
-* The :manual:`cmake-file-api(7)` "codemodel" version 2 ``version`` field has
-  been updated to 2.6.
-* The :manual:`cmake-file-api(7)` "codemodel" version 2 "target" object gained
-  a new "frameworks" field in the "compileGroups" objects.
diff --git a/Help/release/dev/FindCUDA-remove.rst b/Help/release/dev/FindCUDA-remove.rst
deleted file mode 100644
index e8b09d4..0000000
--- a/Help/release/dev/FindCUDA-remove.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-FindCUDA-remove
----------------
-
-* The :module:`FindCUDA` module has been fully deprecated via policy
-  :policy:`CMP0146`.  Port projects to CMake's first-class ``CUDA``
-  language support.
diff --git a/Help/release/dev/FindCUDAToolkit-target-for-cudla.rst b/Help/release/dev/FindCUDAToolkit-target-for-cudla.rst
deleted file mode 100644
index 9de456e..0000000
--- a/Help/release/dev/FindCUDAToolkit-target-for-cudla.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-FindCUDAToolkit-target-for-cudla
---------------------------------
-
-* The :module:`FindCUDAToolkit` module now provides an imported target for ``cudla``, if found.
diff --git a/Help/release/dev/FindDoxygen-custom-config-file.rst b/Help/release/dev/FindDoxygen-custom-config-file.rst
deleted file mode 100644
index badc26e..0000000
--- a/Help/release/dev/FindDoxygen-custom-config-file.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-FindDoxygen-custom-config-file
-------------------------------
-
-* The :module:`FindDoxygen` module's ``doxygen_add_docs`` command gained
-  a ``CONFIG_FILE`` option to specify a custom doxygen configuration file.
diff --git a/Help/release/dev/FindOpenGL-gles.rst b/Help/release/dev/FindOpenGL-gles.rst
deleted file mode 100644
index fcbc516..0000000
--- a/Help/release/dev/FindOpenGL-gles.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-FindOpenGL-gles
----------------
-
-* The :module:`FindOpenGL` module gained support for components
-  ``GLES2`` and ``GLES3``.
diff --git a/Help/release/dev/FindPython-Windows-ARM.rst b/Help/release/dev/FindPython-Windows-ARM.rst
deleted file mode 100644
index d88a65a..0000000
--- a/Help/release/dev/FindPython-Windows-ARM.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-FindPython-Windows-ARM
-----------------------
-
-* :module:`FindPython`, :module:`FindPython2` and :module:`FindPython3` modules
-  learn to manage ``Windows/ARM`` platform.
diff --git a/Help/release/dev/FindwxWidgets-imported-target.rst b/Help/release/dev/FindwxWidgets-imported-target.rst
deleted file mode 100644
index c04e0ac..0000000
--- a/Help/release/dev/FindwxWidgets-imported-target.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-FindwxWidgets-imported-target
------------------------------
-
-* The :module:`FindwxWidgets` module now provides an imported target.
diff --git a/Help/release/dev/GenEx-LIST.rst b/Help/release/dev/GenEx-LIST.rst
deleted file mode 100644
index f65a092..0000000
--- a/Help/release/dev/GenEx-LIST.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-GenEx-LIST
-----------
-
-* The :genex:`LIST` generator expression was added to manage lists.
diff --git a/Help/release/dev/PATH-genex-support-list.rst b/Help/release/dev/PATH-genex-support-list.rst
deleted file mode 100644
index ce87fdd..0000000
--- a/Help/release/dev/PATH-genex-support-list.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-PATH-genex-supports-list
-------------------------
-
-* The :genex:`$<PATH>` generator expression learned to process list of paths
-  for decomposition and transformation operations.
diff --git a/Help/release/dev/System-Framework.rst b/Help/release/dev/System-Framework.rst
deleted file mode 100644
index 106cf23..0000000
--- a/Help/release/dev/System-Framework.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-System-Framework
-----------------
-
-* The :prop_tgt:`SYSTEM` target property is now honored for Apple Frameworks.
diff --git a/Help/release/dev/autogen-exe-vars.rst b/Help/release/dev/autogen-exe-vars.rst
deleted file mode 100644
index a386b4f..0000000
--- a/Help/release/dev/autogen-exe-vars.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-autogen-exe-vars
-----------------
-
-* The :variable:`CMAKE_AUTOMOC_EXECUTABLE`,
-  :variable:`CMAKE_AUTORCC_EXECUTABLE`, and
-  :variable:`CMAKE_AUTOUIC_EXECUTABLE` variables were added to initialize the
-  corresponding target properties as targets are created.
diff --git a/Help/release/dev/autogen-system-include.rst b/Help/release/dev/autogen-system-include.rst
deleted file mode 100644
index aea81be..0000000
--- a/Help/release/dev/autogen-system-include.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-autogen-system-include
-----------------------
-
-* The :prop_tgt:`AUTOGEN_USE_SYSTEM_INCLUDE` target property and
-  corresponding :variable:`CMAKE_AUTOGEN_USE_SYSTEM_INCLUDE` were
-  added to explicitly control whether autogen headers are
-  considered system headers.
diff --git a/Help/release/dev/automoc-macro-names.rst b/Help/release/dev/automoc-macro-names.rst
deleted file mode 100644
index 9c037b3..0000000
--- a/Help/release/dev/automoc-macro-names.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-automoc-macro-names
--------------------
-
-* The :prop_tgt:`INTERFACE_AUTOMOC_MACRO_NAMES` target property was added to
-  specify macro names for ``moc`` as a transitive usage requirement.
diff --git a/Help/release/dev/cmake-debugger.rst b/Help/release/dev/cmake-debugger.rst
deleted file mode 100644
index bfc4f6c..0000000
--- a/Help/release/dev/cmake-debugger.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-cmake-debugger
---------------
-
-* :manual:`cmake(1)` now supports interactive debugging of the CMake language.
-  See the :option:`--debugger <cmake --debugger>` option.
diff --git a/Help/release/dev/cmake-verbose-print-build-tool-command.rst b/Help/release/dev/cmake-verbose-print-build-tool-command.rst
deleted file mode 100644
index 4f13231..0000000
--- a/Help/release/dev/cmake-verbose-print-build-tool-command.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-cmake-verbose-print-build-tool-command
---------------------------------------
-
-* ``cmake --build $dir --verbose`` will now print the working directory and
-  command line used to perform the build.
diff --git a/Help/release/dev/cpack-innosetup.rst b/Help/release/dev/cpack-innosetup.rst
deleted file mode 100644
index a9f8e8e..0000000
--- a/Help/release/dev/cpack-innosetup.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-cpack-innosetup
----------------
-
-* The :cpack_gen:`CPack Inno Setup Generator` was added to package using
-  Inno Setup.
-
-  The new generator adds:
-
-  * A lot of options to customize the Inno Setup installer (e.g. custom
-    installation rules)
-  * Start menu and desktop shortcuts
-  * Components (and also downloaded components)
diff --git a/Help/release/dev/ctest-timeout-signal.rst b/Help/release/dev/ctest-timeout-signal.rst
deleted file mode 100644
index f182429..0000000
--- a/Help/release/dev/ctest-timeout-signal.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-ctest-timeout-signal
---------------------
-
-* The :prop_test:`TIMEOUT_SIGNAL_NAME` and
-  :prop_test:`TIMEOUT_SIGNAL_GRACE_PERIOD` test properties were added
-  to specify a POSIX signal to send to a test process when its timeout
-  is reached.
diff --git a/Help/release/dev/cuda-support-new-compile-modes.rst b/Help/release/dev/cuda-support-new-compile-modes.rst
deleted file mode 100644
index 2d24c16..0000000
--- a/Help/release/dev/cuda-support-new-compile-modes.rst
+++ /dev/null
@@ -1,14 +0,0 @@
-cuda-support-new-compile-modes
-------------------------------
-
-* A :prop_tgt:`CUDA_CUBIN_COMPILATION` target property was added to
-  :ref:`Object Libraries` to support compiling to ``.cubin`` files
-  instead of host object files. Currently only supported with NVIDIA.
-
-* A :prop_tgt:`CUDA_FATBIN_COMPILATION` target property was added to
-  :ref:`Object Libraries` to support compiling to ``.fatbin`` files
-  instead of host object files. Currently only supported with NVIDIA.
-
-* A :prop_tgt:`CUDA_OPTIX_COMPILATION` target property was added to
-  :ref:`Object Libraries` to support compiling to ``.optixir`` files
-  instead of host object files. Currently only supported with NVIDIA.
diff --git a/Help/release/dev/cxx-module-extensions.rst b/Help/release/dev/cxx-module-extensions.rst
deleted file mode 100644
index 92df86a..0000000
--- a/Help/release/dev/cxx-module-extensions.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-cxx-module-extensions
----------------------
-
-* Source file extensions ``.ccm``, ``.cxxm``, or ``.c++m`` are now
-  treated as C++.
diff --git a/Help/release/dev/deprecate-extra-generators.rst b/Help/release/dev/deprecate-extra-generators.rst
deleted file mode 100644
index ceb2f4e..0000000
--- a/Help/release/dev/deprecate-extra-generators.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-deprecate-extra-generators
---------------------------
-
-* The :ref:`Extra Generators` have been deprecated.  IDEs may use the
-  :manual:`cmake-file-api(7)` to view CMake-generated project build trees.
diff --git a/Help/release/dev/deprecate-policy-old.rst b/Help/release/dev/deprecate-policy-old.rst
deleted file mode 100644
index 9c38866..0000000
--- a/Help/release/dev/deprecate-policy-old.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-deprecate-policy-old
---------------------
-
-* Compatibility with versions of CMake older than 3.5 is now deprecated
-  and will be removed from a future version.  Calls to
-  :command:`cmake_minimum_required` or :command:`cmake_policy` that set
-  the policy version to an older value now issue a deprecation diagnostic.
diff --git a/Help/release/dev/dll-name-soversion.rst b/Help/release/dev/dll-name-soversion.rst
deleted file mode 100644
index 56d0842..0000000
--- a/Help/release/dev/dll-name-soversion.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-dll-name-soversion
-------------------
-
-* The :variable:`CMAKE_DLL_NAME_WITH_SOVERSION` variable and associated
-  :prop_tgt:`DLL_NAME_WITH_SOVERSION` target property were added to
-  optionally append the :prop_tgt:`SOVERSION` to the filename of the
-  ``.dll`` part of a shared library on Windows.
diff --git a/Help/release/dev/ep-update-disconnected.rst b/Help/release/dev/ep-update-disconnected.rst
deleted file mode 100644
index a162698..0000000
--- a/Help/release/dev/ep-update-disconnected.rst
+++ /dev/null
@@ -1,14 +0,0 @@
-ep-update-disconnected
-----------------------
-
-* The ``update`` and ``patch`` steps of an :module:`ExternalProject` will now
-  always re-execute if any of their details change, even if
-  ``UPDATE_DISCONNECTED`` was set to true in the call to
-  :command:`ExternalProject_Add`. If using the GIT download method and the
-  ``GIT_TAG`` is changed and the new ``GIT_TAG`` isn't already known locally,
-  this is now a fatal error instead of silently using the previous ``GIT_TAG``.
-
-* When ``UPDATE_DISCONNECTED`` is set to true in a call to
-  :command:`ExternalProject_Add`, the ``configure`` step will no longer
-  re-run on every build. It will only re-run if details of the ``download``,
-  ``update`` or ``patch`` step change.
diff --git a/Help/release/dev/file-GET_RUNTIME_DEPENDENCIES-windows-casing.rst b/Help/release/dev/file-GET_RUNTIME_DEPENDENCIES-windows-casing.rst
deleted file mode 100644
index 858f8b3..0000000
--- a/Help/release/dev/file-GET_RUNTIME_DEPENDENCIES-windows-casing.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-file-GET_RUNTIME_DEPENDENCIES-windows-casing
---------------------------------------------
-
-
-* The :command:`file(GET_RUNTIME_DEPENDENCIES)` command now case-preserves
-  DLL names reported on Windows.  They are still converted to lowercase
-  for filter matching.
diff --git a/Help/release/dev/file-api-query-command.rst b/Help/release/dev/file-api-query-command.rst
deleted file mode 100644
index 66ae7d9..0000000
--- a/Help/release/dev/file-api-query-command.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-file-api-query-command
-----------------------
-
-* The :command:`cmake_file_api` command was added, enabling projects to
-  add :manual:`CMake file API <cmake-file-api(7)>` queries for the current
-  CMake run.
diff --git a/Help/release/dev/find_package-PACKAGENAME_ROOT.rst b/Help/release/dev/find_package-PACKAGENAME_ROOT.rst
deleted file mode 100644
index 0388271..0000000
--- a/Help/release/dev/find_package-PACKAGENAME_ROOT.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-find_package-PACKAGENAME_ROOT
------------------------------
-
-* The :command:`find_package` command now searches prefixes specified by
-  upper-case :variable:`<PACKAGENAME>_ROOT` CMake variables and upper-case
-  :envvar:`<PACKAGENAME>_ROOT` environment variables.
-  See policy :policy:`CMP0144`.
diff --git a/Help/release/dev/genex-compile-only.rst b/Help/release/dev/genex-compile-only.rst
deleted file mode 100644
index 1f898d8..0000000
--- a/Help/release/dev/genex-compile-only.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-genex-compile-only
-------------------
-
-* The :genex:`COMPILE_ONLY` generator expression has been added which provides
-  compilation usage requirements without any linking requirements.
diff --git a/Help/release/dev/install-prefix-genex-install-code-script.rst b/Help/release/dev/install-prefix-genex-install-code-script.rst
deleted file mode 100644
index 810f448..0000000
--- a/Help/release/dev/install-prefix-genex-install-code-script.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-install-prefix-genex-install-code-script
-----------------------------------------
-
-* The :command:`install(CODE)` and :command:`install(SCRIPT)` commands
-  now support the :genex:`$<INSTALL_PREFIX>` generator expression.
diff --git a/Help/release/dev/lang-linker-launcher-genex.rst b/Help/release/dev/lang-linker-launcher-genex.rst
deleted file mode 100644
index b6494eb..0000000
--- a/Help/release/dev/lang-linker-launcher-genex.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-lang-linker-launcher-genex
---------------------------
-
-* The :prop_tgt:`<LANG>_LINKER_LAUNCHER` target property now supports
-  :manual:`generator expressions <cmake-generator-expressions(7)>`.
diff --git a/Help/release/dev/lint-genex.rst b/Help/release/dev/lint-genex.rst
deleted file mode 100644
index 8da30b0..0000000
--- a/Help/release/dev/lint-genex.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-lint-genex
-----------
-
-* The :prop_tgt:`<LANG>_CLANG_TIDY`, :prop_tgt:`<LANG>_CPPCHECK`,
-  :prop_tgt:`<LANG>_CPPLINT`, and :prop_tgt:`<LANG>_INCLUDE_WHAT_YOU_USE`,
-  target properties now support
-  :manual:`generator expressions <cmake-generator-expressions(7)>`.
diff --git a/Help/release/dev/ninja-custom-command-depends.rst b/Help/release/dev/ninja-custom-command-depends.rst
deleted file mode 100644
index 0b7840c..0000000
--- a/Help/release/dev/ninja-custom-command-depends.rst
+++ /dev/null
@@ -1,11 +0,0 @@
-ninja-custom-command-depends
-----------------------------
-
-* The :command:`add_custom_command` command gained a new
-  ``DEPENDS_EXPLICIT_ONLY`` option to tell the :ref:`Ninja Generators`
-  not to add any dependencies implied by the target to which it is
-  attached.
-
-* The :variable:`CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY` variable can
-  be set to enable ``DEPENDS_EXPLICIT_ONLY`` in all uses of
-  :command:`add_custom_command` command.
diff --git a/Help/release/dev/preset-includes-macro-expansion.rst b/Help/release/dev/preset-includes-macro-expansion.rst
deleted file mode 100644
index e1f0030..0000000
--- a/Help/release/dev/preset-includes-macro-expansion.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-preset-includes-macro-expansion
--------------------------------
-
-* :manual:`cmake-presets(7)` files now support schema version ``7``.
-
-* :manual:`cmake-presets(7)` now supports ``$penv{}`` macro expansion
-  in ``include`` fields.
diff --git a/Help/release/dev/remove-FindPythonInterp-FindPythonLibs.rst b/Help/release/dev/remove-FindPythonInterp-FindPythonLibs.rst
deleted file mode 100644
index 426febb..0000000
--- a/Help/release/dev/remove-FindPythonInterp-FindPythonLibs.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-remove-FindPythonInterp-FindPythonLibs
---------------------------------------
-
-* The :module:`FindPythonInterp` and :module:`FindPythonLibs` modules have
-  been fully deprecated via policy :policy:`CMP0148`.  Port projects to
-  :module:`FindPython3`, :module:`FindPython2`, or :module:`FindPython`.
diff --git a/Help/release/dev/remove-dart-modules.rst b/Help/release/dev/remove-dart-modules.rst
deleted file mode 100644
index 5da2eda..0000000
--- a/Help/release/dev/remove-dart-modules.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-remove-dart-modules
--------------------
-
-* The :module:`Dart` and :module:`FindDart` modules have been deprecated via
-  policy :policy:`CMP0145`.  Port projects to the :module:`CTest` module.
diff --git a/Help/release/dev/skip-linting.rst b/Help/release/dev/skip-linting.rst
deleted file mode 100644
index 199571c..0000000
--- a/Help/release/dev/skip-linting.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-skip-linting
-------------
-
-* The :prop_sf:`SKIP_LINTING` source file property was added to suppress
-  target-wide code checks on specific sources.
diff --git a/Help/release/dev/use-linker-depfile.rst b/Help/release/dev/use-linker-depfile.rst
deleted file mode 100644
index 1123707..0000000
--- a/Help/release/dev/use-linker-depfile.rst
+++ /dev/null
@@ -1,11 +0,0 @@
-use-linker-depfile
-------------------
-
-* GNU (and GNU-compatible) linkers gained support for a ``--dependency-file``
-  flag in GNU Binutils 2.35 and LLVM's LLD 12.0.0. The
-  :ref:`Makefile <Makefile Generators>` and :ref:`Ninja <Ninja Generators>`
-  generators will now add these flags so that files read by the linker will
-  cause a relink if they change (typically modified timestamps).
-
-  This feature can be controlled by the variable
-  :variable:`CMAKE_LINK_DEPENDS_USE_LINKER`.
diff --git a/Help/release/dev/vs-BuildInParallel.rst b/Help/release/dev/vs-BuildInParallel.rst
deleted file mode 100644
index ef344c7..0000000
--- a/Help/release/dev/vs-BuildInParallel.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-vs-BuildInParallel
-------------------
-
-* :ref:`Visual Studio Generators`, for VS 15.8 (2017) and newer, now
-  build custom commands in parallel.  See policy :policy:`CMP0147`.
diff --git a/Help/release/dev/vs-debugger-init.rst b/Help/release/dev/vs-debugger-init.rst
deleted file mode 100644
index aa86839..0000000
--- a/Help/release/dev/vs-debugger-init.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-vs-debugger-init
-----------------
-
-* Variables :variable:`CMAKE_VS_DEBUGGER_COMMAND`,
-  :variable:`CMAKE_VS_DEBUGGER_COMMAND_ARGUMENTS`,
-  :variable:`CMAKE_VS_DEBUGGER_ENVIRONMENT`, and
-  :variable:`CMAKE_VS_DEBUGGER_WORKING_DIRECTORY` were added to initialize
-  corresponding target properties.
diff --git a/Help/release/dev/vs-sdk-selection.rst b/Help/release/dev/vs-sdk-selection.rst
deleted file mode 100644
index 856a203..0000000
--- a/Help/release/dev/vs-sdk-selection.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-vs-sdk-selection
-----------------
-
-* The :ref:`Visual Studio Generators` for VS 2015 and above learned to
-  select the Windows SDK version explicitly using a ``version=`` field
-  in the :variable:`CMAKE_GENERATOR_PLATFORM` variable.
-  See :ref:`Visual Studio Platform Selection`.
diff --git a/Help/release/dev/vs-windows-min-version.rst b/Help/release/dev/vs-windows-min-version.rst
deleted file mode 100644
index cb39159..0000000
--- a/Help/release/dev/vs-windows-min-version.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-vs-windows-min-version
-----------------------
-
-* The :variable:`CMAKE_VS_WINDOWS_TARGET_PLATFORM_MIN_VERSION` variable
-  was added to initialize the :prop_tgt:`VS_WINDOWS_TARGET_PLATFORM_MIN_VERSION`
-  target property on all targets when they are created.
diff --git a/Help/release/dev/vs9-deprecate.rst b/Help/release/dev/vs9-deprecate.rst
deleted file mode 100644
index 46568f8..0000000
--- a/Help/release/dev/vs9-deprecate.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-vs9-deprecate
--------------
-
-* The :generator:`Visual Studio 9 2008` generator is now deprecated
-  and will be removed in a future version of CMake.
diff --git a/Help/release/index.rst b/Help/release/index.rst
index d434a3a..3851b7e 100644
--- a/Help/release/index.rst
+++ b/Help/release/index.rst
@@ -15,6 +15,7 @@ Releases
 .. toctree::
    :maxdepth: 1
 
+   3.27 <3.27>
    3.26 <3.26>
    3.25 <3.25>
    3.24 <3.24>