Help: Consolidate 3.19 release notes

Run the `Utilities/Release/consolidate-relnotes.bash` script to move
notes from `Help/release/dev/*` into `Help/release/3.19.rst`.

Help/release/3.19.rst

@@ -0,0 +1,287 @@
+CMake 3.19 Release Notes
+************************
+
+.. only:: html
+
+  .. contents::
+
+Changes made since CMake 3.18 include the following.
+
+* The :command:`add_test` command now (officially) supports whitespace and
+  other special characters in the name for the test it creates.
+  See policy :policy:`CMP0110`.
+
+* The :prop_tgt:`OSX_ARCHITECTURES` target property is now respected for the
+  ``ASM`` language.
+
+* The :command:`set_property`, :command:`get_property`,
+  and :command:`get_directory_property` commands' ``DIRECTORY``
+  options now accept references to binary directory paths,
+  such as the value of :variable:`CMAKE_CURRENT_BINARY_DIR`.
+
+* :ref:`Interface Libraries` may now have source files added via
+  :command:`add_library` or :command:`target_sources`.  Those
+  with sources will be generated as part of the build system.
+
+* The :module:`CheckSourceCompiles` module has been added to
+  generalize :module:`CheckCSourceCompiles` and
+  :module:`CheckCXXSourceCompiles` to more languages.
+
+* The :module:`CheckSourceRuns` module has been added to
+  generalize :module:`CheckCSourceRuns` and
+  :module:`CheckCXXSourceRuns` to more languages.
+
+* The :module:`CheckCompilerFlag` module has been added to
+  generalize :module:`CheckCCompilerFlag` and
+  :module:`CheckCXXCompilerFlag` to more languages.
+
+* A :variable:`CMAKE_CLANG_VFS_OVERLAY` variable was added to tell
+  Clang to use a VFS overlay to support the Windows SDK when
+  cross-compiling from hosts with case-sensitive filesystems.
+
+* The ``Clang`` compiler gained support for handling system include directories
+  when running on Windows.
+
+* The :manual:`cmake(1)` gained a ``-E create_hardlink`` command-line tool
+  that can be used to create hardlinks between files.
+
+* The :manual:`CMake GUI <cmake-gui(1)>` now has an environment variable editor.
+
+* The :command:`cmake_language` command gained a ``DEFER`` mode to
+  schedule command calls to occur at the end of processing a directory.
+
+* :module:`CMakePackageConfigHelpers` module learned to manage version range.
+
+* The :command:`cmake_path` command was added for operations on
+  filesystem paths.
+
+* :manual:`cmake(1)` and :manual:`cmake-gui(1)` now recognize
+  ``CMakePresets.json`` and ``CMakeUserPresets.json`` files.
+
+* The :variable:`CMAKE_<LANG>_COMPILER` variable may now be used to
+  store "mandatory" compiler flags like the :envvar:`CC` and other environment variables.
+
+* The :variable:`CMAKE_<LANG>_FLAGS_INIT` variable will now be considered during
+  the compiler indentification check if other sources like :variable:`CMAKE_<LANG>_FLAGS`
+  or :envvar:`CFLAGS` are not set.
+
+* The :command:`configure_file` command gained a ``NO_SOURCE_PERMISSIONS``
+  option to suppress copying the input file's permissions to the output file.
+
+* :cpack_gen:`CPack External Generator` learned the :variable:`CPACK_EXTERNAL_BUILT_PACKAGES` variable.
+
+* CPack learned the :variable:`CPACK_PRE_BUILD_SCRIPTS`, :variable:`CPACK_POST_BUILD_SCRIPTS`,
+  and :variable:`CPACK_PACKAGE_FILES` variables.
+
+* The :cpack_gen:`CPack WIX Generator` gained a
+  :variable:`CPACK_WIX_CUSTOM_XMLNS` option to specify custom XML namespaces.
+
+* :manual:`ctest(1)` gained support for cuda-memcheck as ``CTEST_MEMORYCHECK_COMMAND``.
+  The different tools (memcheck, racecheck, synccheck, initcheck) supplied by
+  cuda-memcheck can be selected by setting the appropriate flags using the
+  ``CTEST_MEMORYCHECK_COMMAND_OPTIONS`` variable.
+  The default flags are `--tool memcheck --leak-check full`.
+
+* The :module:`CheckCompilerFlag` module was extended to
+  support 'CUDA'.
+
+* The :module:`CheckSourceCompiles` module was extended to
+  support 'CUDA'.
+
+* The :module:`CheckSourceRuns` module was extended to
+  support 'CUDA'.
+
+* The :module:`CheckLinkerFlag` module has been extended to
+  support the validity of CUDA link flags.
+
+* :prop_tgt:`CUDA_SEPARABLE_COMPILATION` is now supported when using Clang.
+
+* If ``CUDA`` compiler detection fails with user-specified
+  :variable:`CMAKE_CUDA_ARCHITECTURES` or :variable:`CMAKE_CUDA_HOST_COMPILER`
+  an error is raised.
+
+* Compiler ABI detection now handles NVCC-style ``-Werror`` flags.
+
+* Scattered toolkit installations are now recognized when crosscompiling
+  ``CUDA`` using Clang.
+* :module:`FindCUDAToolkit` now finds scattered toolkit installations when
+  crosscompiling.
+
+* :ref:`Makefile Generators` no longer repeat custom commands from target
+  dependencies.  See policy :policy:`CMP0113`.
+
+* An explicit deprecation diagnostic was added for policy ``CMP0071``
+  (``CMP0071`` and below were already deprecated).
+  The :manual:`cmake-policies(7)` manual explains that the OLD behaviors
+  of all policies are deprecated and that projects should port to the
+  NEW behaviors.
+
+* Compatibility with versions of CMake older than 2.8.12 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 :prop_tgt:`EXCLUDE_FROM_ALL` target property gained support for
+  :manual:`generator expressions <cmake-generator-expressions(7)>`.
+
+* The :command:`execute_process` command gained a ``COMMAND_ERROR_IS_FATAL``
+  option to specify a fatal error.
+
+* The :module:`ExternalProject` module handling of step target dependencies
+  has been revised.  See policy :policy:`CMP0114`.
+
+* The :manual:`cmake-file-api(7)` "codemodel" version 2 ``version`` field has
+  been updated to 2.2.
+* The :manual:`cmake-file-api(7)` "codemodel" version 2 "target" object gained
+  a new ``languageStandard`` field in the ``compileGroups`` objects.
+
+* The :command:`file(ARCHIVE_CREATE)` command gained a ``COMPRESSION_LEVEL``
+  option to specify the compression level.
+
+* Add :command:`file(CHMOD)` and :command:`file(CHMOD_RECURSE)` to
+  set permissions of files and directories.
+
+* The ``<file>`` argument is now optional for :command:`file(DOWNLOAD)`. If it
+  is not specified, the file is not saved.
+
+* The :command:`file(GENERATE)` command gained a new ``TARGET`` keyword to
+  support resolving target-dependent generator expressions.
+
+* The :command:`file` gained sub-command `REAL_PATH` to compute a path with
+  symlinks resolved.
+
+* The :module:`FindCUDAToolkit` module gained support for finding CUDA toolkits
+  that do not contain ``nvcc``.
+
+* The :command:`find_package` command learned to handle a version range.
+
+* The :command:`find_program` command now requires permission to execute
+  but not to read the file found.  See policy :policy:`CMP0109`.
+
+* The :module:`FindPython3`, :module:`FindPython2` and :module:`FindPython`
+  modules gained the capability to manage a version range.
+
+* The :module:`FindSDL` module now provides:
+
+  * imported target ``SDL::SDL``,
+
+  * result variables ``SDL_LIBRARIES`` and ``SDL_INCLUDE_DIRS``,
+
+  * version variables ``SDL_VERSION``, ``SDL_VERSION_MAJOR``
+    ``SDL_VERSION_MINOR``, and ``SDL_VERSION_PATCH``.
+
+* :module:`FindSWIG` module gains the capability to manage a version range.
+
+* The :module:`FindTIFF` module gained a ``CXX`` component to
+  find the ``tiffxx`` library containing C++ bindings.
+
+* The :module:`FindVulkan` module gained a new output variable
+  ``Vulkan_GLSLC_EXECUTABLE`` which contains the path to the
+  GLSL SPIR-V compiler.
+
+* The :module:`FindVulkan` module gained a new target
+  ``Vulkan::glslc`` which contains the path to the
+  GLSL SPIR-V compiler.
+
+* The :module:`FindPackageHandleStandardArgs` module learned to handle
+  version range. It also gained the ``find_package_check_version()`` command to
+  check the validity of a version against version-related arguments of
+  :command:`find_package` command.
+
+* The :variable:`CMAKE_MFC_FLAG` variable now supports generator expressions.
+
+* A new guide on :guide:`IDE integration <IDE Integration Guide>` has been added.
+
+* An imported target with a missing location now fails during generation if the
+  location is used.  See policy :policy:`CMP0111`.
+
+* The ``--install`` argument of the :manual:`cmake(1)` command line tool gained a
+  ``--default-directory-permissions`` argument.
+
+* The :module:`CheckCompilerFlag` module was extended to
+  support 'ISPC'.
+
+* The :module:`CheckSourceCompiles` module was extended to
+  support 'ISPC'.
+
+
+* CMake learned to support ``ISPC`` as a first-class language that can be
+  enabled via the :command:`project` and :command:`enable_language` commands.
+
+* ``ISPC`` is currently supported by the :ref:`Makefile Generators`
+  and the :generator:`Ninja` generator on Linux, macOS, and Windows.
+
+* The Intel ISPC compiler (``ispc``) is supported.
+
+* Building for macOS will now use the latest SDK available on the system,
+  unless the user has explicitly chosen a SDK using :variable:`CMAKE_OSX_SYSROOT`.
+
+  The deployment target or system macOS version will not affect
+  the choice of SDK.
+
+* macOS SDKs older than 10.5 are no longer supported.
+
+* A new target property, :prop_tgt:`OPTIMIZE_DEPENDENCIES`, was added to
+  avoid unnecessarily building dependencies for a static library.
+* A new variable, :variable:`CMAKE_OPTIMIZE_DEPENDENCIES`, was added to
+  initialize the :prop_tgt:`OPTIMIZE_DEPENDENCIES` target property.
+
+* The :prop_tgt:`PCH_INSTANTIATE_TEMPLATES` target property was added to enable
+  template instantiation in the precompiled header. This is enabled by default
+  and offers a roughly 20% compile time improvement. Currently only supported
+  by Clang 11.
+
+* The following target-based generator expressions that query for directory or
+  file name components no longer add a dependency on the evaluated target.
+  See policy :policy:`CMP0112`.
+
+    - ``TARGET_FILE_DIR``
+    - ``TARGET_LINKER_FILE_BASE_NAME``
+    - ``TARGET_LINKER_FILE_NAME``
+    - ``TARGET_LINKER_FILE_DIR``
+    - ``TARGET_SONAME_FILE_NAME``
+    - ``TARGET_SONAME_FILE_DIR``
+    - ``TARGET_PDB_FILE_NAME``
+    - ``TARGET_PDB_FILE_DIR``
+    - ``TARGET_BUNDLE_DIR``
+    - ``TARGET_BUNDLE_CONTENT_DIR``
+
+* :manual:`cmake-gui(1)` now requires Qt5. Support for compiling with Qt4 has
+  been removed.
+
+* The :manual:`cmake(1)` command-line option ``--warn-unused-vars`` has
+  been removed and is now silently ignored.  The option has not worked
+  correctly since CMake 3.3.
+
+* The :command:`separate_arguments` command gained new ``PROGRAM`` option to
+  search program.
+
+* The :command:`string` command gained set of new ``JSON`` sub commands to provide JSON
+  parsing capabilities.
+
+* :module:`UseSWIG` module gains new source file properties ``OUTPUT_DIR`` and
+  ``OUTFILE_DIR`` to manage output directories on per source basis.
+
+* The :ref:`Visual Studio Generators` for Visual Studio 2015 and above gained
+  support for the Visual Studio Tools for Android. This allows you to set
+  :variable:`CMAKE_SYSTEM_NAME` to `Android` to generate `.vcxproj` files for
+  the Android tools.
+
+* A :variable:`CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION_MAXIMUM` variable
+  was added to tell the :ref:`Visual Studio Generators` what maximumm
+  version of the Windows SDK to choose.
+
+* The :prop_tgt:`WIN32_EXECUTABLE` target property now supports
+  :manual:`generator expressions <cmake-generator-expressions(7)>`.
+
+* The :generator:`Xcode` generator now uses the Xcode "new build system"
+  when generating for Xcode 12.0 or higher.
+  See the :variable:`CMAKE_XCODE_BUILD_SYSTEM` variable.
+  One may use ``-T buildsystem=1`` to switch to the legacy build system.
+
+* The Xcode generator gained support for linking libraries and frameworks
+  via the *Link Binaries With Libraries* build phase instead of always by
+  embedding linker flags directly.  This behavior is controlled by a new
+  :prop_tgt:`XCODE_LINK_BUILD_PHASE_MODE` target property, which is
+  initialized by a new :variable:`CMAKE_XCODE_LINK_BUILD_PHASE_MODE`
+  variable.

Help/release/dev/CMakePackageConfigHelpers-version_range.rst

@@ -1,4 +0,0 @@
-CMakePackageConfigHelpers-version_range
----------------------------------------
-
-* :module:`CMakePackageConfigHelpers` module learned to manage version range.

Help/release/dev/CPACK_EXTERNAL_BUILT_PACKAGES.rst

@@ -1,4 +0,0 @@
-CPACK_EXTERNAL_BUILT_PACKAGES
------------------------------
-
-* :cpack_gen:`CPack External Generator` learned the :variable:`CPACK_EXTERNAL_BUILT_PACKAGES` variable.

Help/release/dev/EXCLUDE_FROM_ALL-genex.rst

@@ -1,5 +0,0 @@
-EXCLUDE_FROM_ALL-genex
-----------------------
-
-* The :prop_tgt:`EXCLUDE_FROM_ALL` target property gained support for
-  :manual:`generator expressions <cmake-generator-expressions(7)>`.

Help/release/dev/ExternalProject-steps-refinement.rst

@@ -1,5 +0,0 @@
-ExternalProject-steps-refinement
---------------------------------
-
-* The :module:`ExternalProject` module handling of step target dependencies
-  has been revised.  See policy :policy:`CMP0114`.

Help/release/dev/FPHSA-version_range.rst

@@ -1,7 +0,0 @@
-FPHSA-version_range
--------------------
-
-* The :module:`FindPackageHandleStandardArgs` module learned to handle
-  version range. It also gained the ``find_package_check_version()`` command to
-  check the validity of a version against version-related arguments of
-  :command:`find_package` command.

Help/release/dev/FindCUDAToolkit-no-nvcc.rst

@@ -1,5 +0,0 @@
-FindCUDAToolkit-no-nvcc
------------------------
-
-* The :module:`FindCUDAToolkit` module gained support for finding CUDA toolkits
-  that do not contain ``nvcc``.

Help/release/dev/FindPython-version_range.rst

@@ -1,5 +0,0 @@
-FindPython-version_range
-------------------------
-
-* The :module:`FindPython3`, :module:`FindPython2` and :module:`FindPython`
-  modules gained the capability to manage a version range.

Help/release/dev/FindSDL-update.rst

@@ -1,11 +0,0 @@
-FindSDL-update
---------------
-
-* The :module:`FindSDL` module now provides:
-
-  * imported target ``SDL::SDL``,
-
-  * result variables ``SDL_LIBRARIES`` and ``SDL_INCLUDE_DIRS``,
-
-  * version variables ``SDL_VERSION``, ``SDL_VERSION_MAJOR``
-    ``SDL_VERSION_MINOR``, and ``SDL_VERSION_PATCH``.

Help/release/dev/FindSWIG-version-range.rst

@@ -1,4 +0,0 @@
-FindSWIG-version-range
-----------------------
-
-* :module:`FindSWIG` module gains the capability to manage a version range.

Help/release/dev/FindTIFF-tiffxx.rst

@@ -1,5 +0,0 @@
-FindTIFF-tiffxx
----------------
-
-* The :module:`FindTIFF` module gained a ``CXX`` component to
-  find the ``tiffxx`` library containing C++ bindings.

Help/release/dev/FindVulkan-glslc.rst

@@ -1,10 +0,0 @@
-FindVulkan-glslc
-----------------
-
-* The :module:`FindVulkan` module gained a new output variable
-  ``Vulkan_GLSLC_EXECUTABLE`` which contains the path to the
-  GLSL SPIR-V compiler.
-
-* The :module:`FindVulkan` module gained a new target
-  ``Vulkan::glslc`` which contains the path to the
-  GLSL SPIR-V compiler.

Help/release/dev/PCH_INSTANTIATE_TEMPLATES.rst

@@ -1,7 +0,0 @@
-PCH_INSTANTIATE_TEMPLATES
--------------------------
-
-* The :prop_tgt:`PCH_INSTANTIATE_TEMPLATES` target property was added to enable
-  template instantiation in the precompiled header. This is enabled by default
-  and offers a roughly 20% compile time improvement. Currently only supported
-  by Clang 11.

Help/release/dev/UseSWIG-output-source-properties.rst

@@ -1,5 +0,0 @@
-UseSwig-output-source-properties
---------------------------------
-
-* :module:`UseSWIG` module gains new source file properties ``OUTPUT_DIR`` and
-  ``OUTFILE_DIR`` to manage output directories on per source basis.

Help/release/dev/add_test-special-chars-in-name.rst

@@ -1,6 +0,0 @@
-add_test-special-chars-in-name
-------------------------------
-
-* The :command:`add_test` command now (officially) supports whitespace and
-  other special characters in the name for the test it creates.
-  See policy :policy:`CMP0110`.

Help/release/dev/asm-osx-architectures.rst

@@ -1,5 +0,0 @@
-asm-osx-architectures
----------------------
-
-* The :prop_tgt:`OSX_ARCHITECTURES` target property is now respected for the
-  ``ASM`` language.

Help/release/dev/binary-dir-props.rst

@@ -1,7 +0,0 @@
-binary-dir-props
-----------------
-
-* The :command:`set_property`, :command:`get_property`,
-  and :command:`get_directory_property` commands' ``DIRECTORY``
-  options now accept references to binary directory paths,
-  such as the value of :variable:`CMAKE_CURRENT_BINARY_DIR`.

Help/release/dev/build-interface-targets.rst

@@ -1,6 +0,0 @@
-build-interface-targets
------------------------
-
-* :ref:`Interface Libraries` may now have source files added via
-  :command:`add_library` or :command:`target_sources`.  Those
-  with sources will be generated as part of the build system.

Help/release/dev/check-source-modules.rst

@@ -1,14 +0,0 @@
-check-source-modules
-^^^^^^^^^^^^^^^^^^^^
-
-* The :module:`CheckSourceCompiles` module has been added to
-  generalize :module:`CheckCSourceCompiles` and
-  :module:`CheckCXXSourceCompiles` to more languages.
-
-* The :module:`CheckSourceRuns` module has been added to
-  generalize :module:`CheckCSourceRuns` and
-  :module:`CheckCXXSourceRuns` to more languages.
-
-* The :module:`CheckCompilerFlag` module has been added to
-  generalize :module:`CheckCCompilerFlag` and
-  :module:`CheckCXXCompilerFlag` to more languages.

Help/release/dev/clang-cl-vfs.rst

@@ -1,6 +0,0 @@
-clang-cl-vfs
-------------
-
-* A :variable:`CMAKE_CLANG_VFS_OVERLAY` variable was added to tell
-  Clang to use a VFS overlay to support the Windows SDK when
-  cross-compiling from hosts with case-sensitive filesystems.

Help/release/dev/clang-windows-system-includes.rst

@@ -1,5 +0,0 @@
-clang-windows-system-includes
------------------------------
-
-* The ``Clang`` compiler gained support for handling system include directories
-  when running on Windows.

Help/release/dev/cmake-E-create_hardlink.rst

@@ -1,5 +0,0 @@
-cmake-E-create_hardlink
------------------------
-
-* The :manual:`cmake(1)` gained a ``-E create_hardlink`` command-line tool
-  that can be used to create hardlinks between files.

Help/release/dev/cmake-gui-environment.rst

@@ -1,4 +0,0 @@
-cmake-gui-environment
----------------------
-
-* The :manual:`CMake GUI <cmake-gui(1)>` now has an environment variable editor.

Help/release/dev/cmake-presets.rst

@@ -1,5 +0,0 @@
-cmake-presets
--------------
-
-* :manual:`cmake(1)` and :manual:`cmake-gui(1)` now recognize
-  ``CMakePresets.json`` and ``CMakeUserPresets.json`` files.

Help/release/dev/cmake_language-DEFER.rst

@@ -1,5 +0,0 @@
-cmake_language-DEFER
---------------------
-
-* The :command:`cmake_language` command gained a ``DEFER`` mode to
-  schedule command calls to occur at the end of processing a directory.

Help/release/dev/cmake_path-command.rst

@@ -1,5 +0,0 @@
-cmake_path-command
-------------------
-
-* The :command:`cmake_path` command was added for operations on
-  filesystem paths.

Help/release/dev/compiler_flags.rst

@@ -1,9 +0,0 @@
-compiler_flags
------------------
-
-* The :variable:`CMAKE_<LANG>_COMPILER` variable may now be used to
-  store "mandatory" compiler flags like the :envvar:`CC` and other environment variables.
-
-* The :variable:`CMAKE_<LANG>_FLAGS_INIT` variable will now be considered during
-  the compiler indentification check if other sources like :variable:`CMAKE_<LANG>_FLAGS`
-  or :envvar:`CFLAGS` are not set.

Help/release/dev/configure_file-permission-control.rst

@@ -1,5 +0,0 @@
-configure_file-permission-control
----------------------------------
-
-* The :command:`configure_file` command gained a ``NO_SOURCE_PERMISSIONS``
-  option to suppress copying the input file's permissions to the output file.

Help/release/dev/cpack-pre-and-post-build-scripts.rst

@@ -1,5 +0,0 @@
-cpack-pre-and-post-build-scripts
---------------------------------
-
-* CPack learned the :variable:`CPACK_PRE_BUILD_SCRIPTS`, :variable:`CPACK_POST_BUILD_SCRIPTS`,
-  and :variable:`CPACK_PACKAGE_FILES` variables.

Help/release/dev/cpack-wix-custom-xmlns.rst

@@ -1,5 +0,0 @@
-cpack-wix-custom-xmlns
-----------------------
-
-* The :cpack_gen:`CPack WIX Generator` gained a
-  :variable:`CPACK_WIX_CUSTOM_XMLNS` option to specify custom XML namespaces.

Help/release/dev/ctest-cuda-memcheck.rst

@@ -1,8 +0,0 @@
-CTest
------
-
-* :manual:`ctest(1)` gained support for cuda-memcheck as ``CTEST_MEMORYCHECK_COMMAND``.
-  The different tools (memcheck, racecheck, synccheck, initcheck) supplied by
-  cuda-memcheck can be selected by setting the appropriate flags using the
-  ``CTEST_MEMORYCHECK_COMMAND_OPTIONS`` variable.
-  The default flags are `--tool memcheck --leak-check full`.

Help/release/dev/cuda-check-support.rst

@@ -1,14 +0,0 @@
-cuda-check-support
-------------------
-
-* The :module:`CheckCompilerFlag` module was extended to
-  support 'CUDA'.
-
-* The :module:`CheckSourceCompiles` module was extended to
-  support 'CUDA'.
-
-* The :module:`CheckSourceRuns` module was extended to
-  support 'CUDA'.
-
-* The :module:`CheckLinkerFlag` module has been extended to
-  support the validity of CUDA link flags.

Help/release/dev/cuda-clang-separable-compilation.rst

@@ -1,4 +0,0 @@
-cuda-clang-separable-compilation
---------------------------------
-
-* :prop_tgt:`CUDA_SEPARABLE_COMPILATION` is now supported when using Clang.

Help/release/dev/cuda-fail-fast.rst

@@ -1,6 +0,0 @@
-cuda-fail-fast
---------------
-
-* If ``CUDA`` compiler detection fails with user-specified
-  :variable:`CMAKE_CUDA_ARCHITECTURES` or :variable:`CMAKE_CUDA_HOST_COMPILER`
-  an error is raised.

Help/release/dev/cuda-nvcc-werror-abi.rst

@@ -1,4 +0,0 @@
-cuda-nvcc-werror-abi
---------------------
-
-* Compiler ABI detection now handles NVCC-style ``-Werror`` flags.

Help/release/dev/cuda-scattered-cross.rst

@@ -1,7 +0,0 @@
-cuda-scattered-cross
---------------------
-
-* Scattered toolkit installations are now recognized when crosscompiling
-  ``CUDA`` using Clang.
-* :module:`FindCUDAToolkit` now finds scattered toolkit installations when
-  crosscompiling.

Help/release/dev/custom-command-dedup.rst

@@ -1,5 +0,0 @@
-custom-command-dedup
---------------------
-
-* :ref:`Makefile Generators` no longer repeat custom commands from target
-  dependencies.  See policy :policy:`CMP0113`.

Help/release/dev/deprecate-policy-old.rst

@@ -1,13 +0,0 @@
-deprecate-policy-old
---------------------
-
-* An explicit deprecation diagnostic was added for policy ``CMP0071``
-  (``CMP0071`` and below were already deprecated).
-  The :manual:`cmake-policies(7)` manual explains that the OLD behaviors
-  of all policies are deprecated and that projects should port to the
-  NEW behaviors.
-
-* Compatibility with versions of CMake older than 2.8.12 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.

Help/release/dev/execute-process-command-error-is-fatal.rst

@@ -1,5 +0,0 @@
-execute-process-command-error-is-fatal
---------------------------------------
-
-* The :command:`execute_process` command gained a ``COMMAND_ERROR_IS_FATAL``
-  option to specify a fatal error.

Help/release/dev/file-ARCHIVE-compression-level.rst

@@ -1,5 +0,0 @@
-file-ARCHIVE-compression-level
-------------------------------
-
-* The :command:`file(ARCHIVE_CREATE)` command gained a ``COMPRESSION_LEVEL``
-  option to specify the compression level.

Help/release/dev/file-CHMOD.rst

@@ -1,5 +0,0 @@
-file-CHMOD
-----------
-
-* Add :command:`file(CHMOD)` and :command:`file(CHMOD_RECURSE)` to
-  set permissions of files and directories.

Help/release/dev/file-REAL_PATH.rst

@@ -1,5 +0,0 @@
-file-REAL_PATH
---------------
-
-* The :command:`file` gained sub-command `REAL_PATH` to compute a path with
-  symlinks resolved.

Help/release/dev/file-download-optional-file.rst

@@ -1,5 +0,0 @@
-file-download-optional-file
----------------------------
-
-* The ``<file>`` argument is now optional for :command:`file(DOWNLOAD)`. If it
-  is not specified, the file is not saved.

Help/release/dev/file-generate-target.rst

@@ -1,5 +0,0 @@
-file-generate-target
---------------------
-
-* The :command:`file(GENERATE)` command gained a new ``TARGET`` keyword to
-  support resolving target-dependent generator expressions.

Help/release/dev/fileapi-codemodel-2.2.rst

@@ -1,7 +0,0 @@
-fileapi-codemodel-2.2
----------------------
-
-* The :manual:`cmake-file-api(7)` "codemodel" version 2 ``version`` field has
-  been updated to 2.2.
-* The :manual:`cmake-file-api(7)` "codemodel" version 2 "target" object gained
-  a new ``languageStandard`` field in the ``compileGroups`` objects.

Help/release/dev/find_package-version_range.rst

@@ -1,4 +0,0 @@
-find_package-version_range
---------------------------
-
-* The :command:`find_package` command learned to handle a version range.

Help/release/dev/find_program-exe-no-read.rst

@@ -1,5 +0,0 @@
-find_program-exe-no-read
-------------------------
-
-* The :command:`find_program` command now requires permission to execute
-  but not to read the file found.  See policy :policy:`CMP0109`.

Help/release/dev/genexpr-for-mfc-flag.rst

@@ -1,4 +0,0 @@
-genexpr-for-mfc-flag
---------------------
-
-* The :variable:`CMAKE_MFC_FLAG` variable now supports generator expressions.

Help/release/dev/ide-integration-guide.rst

@@ -1,4 +0,0 @@
-ide-integration-guide
----------------------
-
-* A new guide on :guide:`IDE integration <IDE Integration Guide>` has been added.

Help/release/dev/imported-target-location-required.rst

@@ -1,5 +0,0 @@
-imported-target-location-required
----------------------------------
-
-* An imported target with a missing location now fails during generation if the
-  location is used.  See policy :policy:`CMP0111`.

Help/release/dev/install-default-directory-permissions.rst

@@ -1,5 +0,0 @@
-install-default-directory-permissions
--------------------------------------
-
-* The ``--install`` argument of the :manual:`cmake(1)` command line tool gained a
-  ``--default-directory-permissions`` argument.

Help/release/dev/ispc-check-support.rst

@@ -1,8 +0,0 @@
-ispc-check-support
-------------------
-
-* The :module:`CheckCompilerFlag` module was extended to
-  support 'ISPC'.
-
-* The :module:`CheckSourceCompiles` module was extended to
-  support 'ISPC'.

Help/release/dev/ispc-language-support.rst

@@ -1,11 +0,0 @@
-cmake-ispc-support
-------------------
-
-
-* CMake learned to support ``ISPC`` as a first-class language that can be
-  enabled via the :command:`project` and :command:`enable_language` commands.
-
-* ``ISPC`` is currently supported by the :ref:`Makefile Generators`
-  and the :generator:`Ninja` generator on Linux, macOS, and Windows.
-
-* The Intel ISPC compiler (``ispc``) is supported.

Help/release/dev/macOS-sdk-latest.rst

@@ -1,10 +0,0 @@
-macOS-sdk-latest
-----------------
-
-* Building for macOS will now use the latest SDK available on the system,
-  unless the user has explicitly chosen a SDK using :variable:`CMAKE_OSX_SYSROOT`.
-
-  The deployment target or system macOS version will not affect
-  the choice of SDK.
-
-* macOS SDKs older than 10.5 are no longer supported.

Help/release/dev/optimize-link-dependencies.rst

@@ -1,7 +0,0 @@
-optimize-link-dependencies
---------------------------
-
-* A new target property, :prop_tgt:`OPTIMIZE_DEPENDENCIES`, was added to
-  avoid unnecessarily building dependencies for a static library.
-* A new variable, :variable:`CMAKE_OPTIMIZE_DEPENDENCIES`, was added to
-  initialize the :prop_tgt:`OPTIMIZE_DEPENDENCIES` target property.

Help/release/dev/relax-target-generator-expression-dependency-addition.rst

@@ -1,17 +0,0 @@
-relax-target-generator-expression-dependency-addition
------------------------------------------------------
-
-* The following target-based generator expressions that query for directory or
-  file name components no longer add a dependency on the evaluated target.
-  See policy :policy:`CMP0112`.
-
-    - ``TARGET_FILE_DIR``
-    - ``TARGET_LINKER_FILE_BASE_NAME``
-    - ``TARGET_LINKER_FILE_NAME``
-    - ``TARGET_LINKER_FILE_DIR``
-    - ``TARGET_SONAME_FILE_NAME``
-    - ``TARGET_SONAME_FILE_DIR``
-    - ``TARGET_PDB_FILE_NAME``
-    - ``TARGET_PDB_FILE_DIR``
-    - ``TARGET_BUNDLE_DIR``
-    - ``TARGET_BUNDLE_CONTENT_DIR``

Help/release/dev/remove-cmake-gui-qt4.rst

@@ -1,5 +0,0 @@
-remove-cmake-gui-qt4
---------------------
-
-* :manual:`cmake-gui(1)` now requires Qt5. Support for compiling with Qt4 has
-  been removed.

Help/release/dev/remove-warn-unused-vars.rst

@@ -1,6 +0,0 @@
-remove-warn-unused-vars
------------------------
-
-* The :manual:`cmake(1)` command-line option ``--warn-unused-vars`` has
-  been removed and is now silently ignored.  The option has not worked
-  correctly since CMake 3.3.

Help/release/dev/separate_arguments-PROGRAM.rst

@@ -1,5 +0,0 @@
-separate_arguments-PROGRAM
---------------------------
-
-* The :command:`separate_arguments` command gained new ``PROGRAM`` option to
-  search program.

Help/release/dev/string-json-support.rst

@@ -1,5 +0,0 @@
-string-json-support
--------------------
-
-* The :command:`string` command gained set of new ``JSON`` sub commands to provide JSON
-  parsing capabilities.

Help/release/dev/visual-studio-android.rst

@@ -1,7 +0,0 @@
-visual-studio-android
----------------------
-
-* The :ref:`Visual Studio Generators` for Visual Studio 2015 and above gained
-  support for the Visual Studio Tools for Android. This allows you to set
-  :variable:`CMAKE_SYSTEM_NAME` to `Android` to generate `.vcxproj` files for
-  the Android tools.

Help/release/dev/vs-win-sdk-custom-max.rst

@@ -1,6 +0,0 @@
-vs-win-sdk-custom-max
----------------------
-
-* A :variable:`CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION_MAXIMUM` variable
-  was added to tell the :ref:`Visual Studio Generators` what maximumm
-  version of the Windows SDK to choose.

Help/release/dev/win32-executable-genex.rst

@@ -1,5 +0,0 @@
-win32-executable-genex
-----------------------
-
-* The :prop_tgt:`WIN32_EXECUTABLE` target property now supports
-  :manual:`generator expressions <cmake-generator-expressions(7)>`.

Help/release/dev/xcode-12-new-build-system.rst

@@ -1,7 +0,0 @@
-xcode-12-new-build-system
--------------------------
-
-* The :generator:`Xcode` generator now uses the Xcode "new build system"
-  when generating for Xcode 12.0 or higher.
-  See the :variable:`CMAKE_XCODE_BUILD_SYSTEM` variable.
-  One may use ``-T buildsystem=1`` to switch to the legacy build system.

Help/release/dev/xcode-link-phase-all.rst

@@ -1,9 +0,0 @@
-xcode-link-phase-all
---------------------
-
-* The Xcode generator gained support for linking libraries and frameworks
-  via the *Link Binaries With Libraries* build phase instead of always by
-  embedding linker flags directly.  This behavior is controlled by a new
-  :prop_tgt:`XCODE_LINK_BUILD_PHASE_MODE` target property, which is
-  initialized by a new :variable:`CMAKE_XCODE_LINK_BUILD_PHASE_MODE`
-  variable.

Help/release/index.rst

@@ -15,6 +15,7 @@ Releases
 .. toctree::
    :maxdepth: 1
 
+   3.19 <3.19>
    3.18 <3.18>
    3.17 <3.17>
    3.16 <3.16>