diff options
66 files changed, 288 insertions, 407 deletions
diff --git a/Help/release/3.19.rst b/Help/release/3.19.rst new file mode 100644 index 0000000..38c3e63 --- /dev/null +++ b/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. diff --git a/Help/release/dev/CMakePackageConfigHelpers-version_range.rst b/Help/release/dev/CMakePackageConfigHelpers-version_range.rst deleted file mode 100644 index 6900529..0000000 --- a/Help/release/dev/CMakePackageConfigHelpers-version_range.rst +++ /dev/null @@ -1,4 +0,0 @@ -CMakePackageConfigHelpers-version_range ---------------------------------------- - -* :module:`CMakePackageConfigHelpers` module learned to manage version range. diff --git a/Help/release/dev/CPACK_EXTERNAL_BUILT_PACKAGES.rst b/Help/release/dev/CPACK_EXTERNAL_BUILT_PACKAGES.rst deleted file mode 100644 index af446d2..0000000 --- a/Help/release/dev/CPACK_EXTERNAL_BUILT_PACKAGES.rst +++ /dev/null @@ -1,4 +0,0 @@ -CPACK_EXTERNAL_BUILT_PACKAGES ------------------------------ - -* :cpack_gen:`CPack External Generator` learned the :variable:`CPACK_EXTERNAL_BUILT_PACKAGES` variable. diff --git a/Help/release/dev/EXCLUDE_FROM_ALL-genex.rst b/Help/release/dev/EXCLUDE_FROM_ALL-genex.rst deleted file mode 100644 index 4d5a83c..0000000 --- a/Help/release/dev/EXCLUDE_FROM_ALL-genex.rst +++ /dev/null @@ -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)>`. diff --git a/Help/release/dev/ExternalProject-steps-refinement.rst b/Help/release/dev/ExternalProject-steps-refinement.rst deleted file mode 100644 index 9762927..0000000 --- a/Help/release/dev/ExternalProject-steps-refinement.rst +++ /dev/null @@ -1,5 +0,0 @@ -ExternalProject-steps-refinement --------------------------------- - -* The :module:`ExternalProject` module handling of step target dependencies - has been revised. See policy :policy:`CMP0114`. diff --git a/Help/release/dev/FPHSA-version_range.rst b/Help/release/dev/FPHSA-version_range.rst deleted file mode 100644 index 18996c4..0000000 --- a/Help/release/dev/FPHSA-version_range.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/FindCUDAToolkit-no-nvcc.rst b/Help/release/dev/FindCUDAToolkit-no-nvcc.rst deleted file mode 100644 index e815876..0000000 --- a/Help/release/dev/FindCUDAToolkit-no-nvcc.rst +++ /dev/null @@ -1,5 +0,0 @@ -FindCUDAToolkit-no-nvcc ------------------------ - -* The :module:`FindCUDAToolkit` module gained support for finding CUDA toolkits - that do not contain ``nvcc``. diff --git a/Help/release/dev/FindPython-version_range.rst b/Help/release/dev/FindPython-version_range.rst deleted file mode 100644 index 06318b4..0000000 --- a/Help/release/dev/FindPython-version_range.rst +++ /dev/null @@ -1,5 +0,0 @@ -FindPython-version_range ------------------------- - -* The :module:`FindPython3`, :module:`FindPython2` and :module:`FindPython` - modules gained the capability to manage a version range. diff --git a/Help/release/dev/FindSDL-update.rst b/Help/release/dev/FindSDL-update.rst deleted file mode 100644 index a85d2b9..0000000 --- a/Help/release/dev/FindSDL-update.rst +++ /dev/null @@ -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``. diff --git a/Help/release/dev/FindSWIG-version-range.rst b/Help/release/dev/FindSWIG-version-range.rst deleted file mode 100644 index 37567d3..0000000 --- a/Help/release/dev/FindSWIG-version-range.rst +++ /dev/null @@ -1,4 +0,0 @@ -FindSWIG-version-range ----------------------- - -* :module:`FindSWIG` module gains the capability to manage a version range. diff --git a/Help/release/dev/FindTIFF-tiffxx.rst b/Help/release/dev/FindTIFF-tiffxx.rst deleted file mode 100644 index 656d38f..0000000 --- a/Help/release/dev/FindTIFF-tiffxx.rst +++ /dev/null @@ -1,5 +0,0 @@ -FindTIFF-tiffxx ---------------- - -* The :module:`FindTIFF` module gained a ``CXX`` component to - find the ``tiffxx`` library containing C++ bindings. diff --git a/Help/release/dev/FindVulkan-glslc.rst b/Help/release/dev/FindVulkan-glslc.rst deleted file mode 100644 index 246bc8f..0000000 --- a/Help/release/dev/FindVulkan-glslc.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/PCH_INSTANTIATE_TEMPLATES.rst b/Help/release/dev/PCH_INSTANTIATE_TEMPLATES.rst deleted file mode 100644 index 0334204..0000000 --- a/Help/release/dev/PCH_INSTANTIATE_TEMPLATES.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/UseSWIG-output-source-properties.rst b/Help/release/dev/UseSWIG-output-source-properties.rst deleted file mode 100644 index 62796a2..0000000 --- a/Help/release/dev/UseSWIG-output-source-properties.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/add_test-special-chars-in-name.rst b/Help/release/dev/add_test-special-chars-in-name.rst deleted file mode 100644 index 5bb9a23..0000000 --- a/Help/release/dev/add_test-special-chars-in-name.rst +++ /dev/null @@ -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`. diff --git a/Help/release/dev/asm-osx-architectures.rst b/Help/release/dev/asm-osx-architectures.rst deleted file mode 100644 index d8d0660..0000000 --- a/Help/release/dev/asm-osx-architectures.rst +++ /dev/null @@ -1,5 +0,0 @@ -asm-osx-architectures ---------------------- - -* The :prop_tgt:`OSX_ARCHITECTURES` target property is now respected for the - ``ASM`` language. diff --git a/Help/release/dev/binary-dir-props.rst b/Help/release/dev/binary-dir-props.rst deleted file mode 100644 index b36d86d..0000000 --- a/Help/release/dev/binary-dir-props.rst +++ /dev/null @@ -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`. diff --git a/Help/release/dev/build-interface-targets.rst b/Help/release/dev/build-interface-targets.rst deleted file mode 100644 index 37bded4..0000000 --- a/Help/release/dev/build-interface-targets.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/check-source-modules.rst b/Help/release/dev/check-source-modules.rst deleted file mode 100644 index e6cccbe..0000000 --- a/Help/release/dev/check-source-modules.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/clang-cl-vfs.rst b/Help/release/dev/clang-cl-vfs.rst deleted file mode 100644 index 40b19ef..0000000 --- a/Help/release/dev/clang-cl-vfs.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/clang-windows-system-includes.rst b/Help/release/dev/clang-windows-system-includes.rst deleted file mode 100644 index d1a3be2..0000000 --- a/Help/release/dev/clang-windows-system-includes.rst +++ /dev/null @@ -1,5 +0,0 @@ -clang-windows-system-includes ------------------------------ - -* The ``Clang`` compiler gained support for handling system include directories - when running on Windows. diff --git a/Help/release/dev/cmake-E-create_hardlink.rst b/Help/release/dev/cmake-E-create_hardlink.rst deleted file mode 100644 index 66cdc87..0000000 --- a/Help/release/dev/cmake-E-create_hardlink.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/cmake-gui-environment.rst b/Help/release/dev/cmake-gui-environment.rst deleted file mode 100644 index 1c8485e..0000000 --- a/Help/release/dev/cmake-gui-environment.rst +++ /dev/null @@ -1,4 +0,0 @@ -cmake-gui-environment ---------------------- - -* The :manual:`CMake GUI <cmake-gui(1)>` now has an environment variable editor. diff --git a/Help/release/dev/cmake-presets.rst b/Help/release/dev/cmake-presets.rst deleted file mode 100644 index a901f10..0000000 --- a/Help/release/dev/cmake-presets.rst +++ /dev/null @@ -1,5 +0,0 @@ -cmake-presets -------------- - -* :manual:`cmake(1)` and :manual:`cmake-gui(1)` now recognize - ``CMakePresets.json`` and ``CMakeUserPresets.json`` files. diff --git a/Help/release/dev/cmake_language-DEFER.rst b/Help/release/dev/cmake_language-DEFER.rst deleted file mode 100644 index 8bd0ee9..0000000 --- a/Help/release/dev/cmake_language-DEFER.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/cmake_path-command.rst b/Help/release/dev/cmake_path-command.rst deleted file mode 100644 index f4d9f27..0000000 --- a/Help/release/dev/cmake_path-command.rst +++ /dev/null @@ -1,5 +0,0 @@ -cmake_path-command ------------------- - -* The :command:`cmake_path` command was added for operations on - filesystem paths. diff --git a/Help/release/dev/compiler_flags.rst b/Help/release/dev/compiler_flags.rst deleted file mode 100644 index 7138e80..0000000 --- a/Help/release/dev/compiler_flags.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/configure_file-permission-control.rst b/Help/release/dev/configure_file-permission-control.rst deleted file mode 100644 index 54b52b7..0000000 --- a/Help/release/dev/configure_file-permission-control.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/cpack-pre-and-post-build-scripts.rst b/Help/release/dev/cpack-pre-and-post-build-scripts.rst deleted file mode 100644 index bf7958b..0000000 --- a/Help/release/dev/cpack-pre-and-post-build-scripts.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/cpack-wix-custom-xmlns.rst b/Help/release/dev/cpack-wix-custom-xmlns.rst deleted file mode 100644 index 84934cb..0000000 --- a/Help/release/dev/cpack-wix-custom-xmlns.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/ctest-cuda-memcheck.rst b/Help/release/dev/ctest-cuda-memcheck.rst deleted file mode 100644 index f8f861a..0000000 --- a/Help/release/dev/ctest-cuda-memcheck.rst +++ /dev/null @@ -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`. diff --git a/Help/release/dev/cuda-check-support.rst b/Help/release/dev/cuda-check-support.rst deleted file mode 100644 index d88ef94..0000000 --- a/Help/release/dev/cuda-check-support.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/cuda-clang-separable-compilation.rst b/Help/release/dev/cuda-clang-separable-compilation.rst deleted file mode 100644 index 8ff4cf4..0000000 --- a/Help/release/dev/cuda-clang-separable-compilation.rst +++ /dev/null @@ -1,4 +0,0 @@ -cuda-clang-separable-compilation --------------------------------- - -* :prop_tgt:`CUDA_SEPARABLE_COMPILATION` is now supported when using Clang. diff --git a/Help/release/dev/cuda-fail-fast.rst b/Help/release/dev/cuda-fail-fast.rst deleted file mode 100644 index d857eb2..0000000 --- a/Help/release/dev/cuda-fail-fast.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/cuda-nvcc-werror-abi.rst b/Help/release/dev/cuda-nvcc-werror-abi.rst deleted file mode 100644 index 73e6ee6..0000000 --- a/Help/release/dev/cuda-nvcc-werror-abi.rst +++ /dev/null @@ -1,4 +0,0 @@ -cuda-nvcc-werror-abi --------------------- - -* Compiler ABI detection now handles NVCC-style ``-Werror`` flags. diff --git a/Help/release/dev/cuda-scattered-cross.rst b/Help/release/dev/cuda-scattered-cross.rst deleted file mode 100644 index a76407c..0000000 --- a/Help/release/dev/cuda-scattered-cross.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/custom-command-dedup.rst b/Help/release/dev/custom-command-dedup.rst deleted file mode 100644 index 65fa303..0000000 --- a/Help/release/dev/custom-command-dedup.rst +++ /dev/null @@ -1,5 +0,0 @@ -custom-command-dedup --------------------- - -* :ref:`Makefile Generators` no longer repeat custom commands from target - dependencies. See policy :policy:`CMP0113`. diff --git a/Help/release/dev/deprecate-policy-old.rst b/Help/release/dev/deprecate-policy-old.rst deleted file mode 100644 index 1dc01cc..0000000 --- a/Help/release/dev/deprecate-policy-old.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/execute-process-command-error-is-fatal.rst b/Help/release/dev/execute-process-command-error-is-fatal.rst deleted file mode 100644 index fbc54bf..0000000 --- a/Help/release/dev/execute-process-command-error-is-fatal.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/file-ARCHIVE-compression-level.rst b/Help/release/dev/file-ARCHIVE-compression-level.rst deleted file mode 100644 index 719b694..0000000 --- a/Help/release/dev/file-ARCHIVE-compression-level.rst +++ /dev/null @@ -1,5 +0,0 @@ -file-ARCHIVE-compression-level ------------------------------- - -* The :command:`file(ARCHIVE_CREATE)` command gained a ``COMPRESSION_LEVEL`` - option to specify the compression level. diff --git a/Help/release/dev/file-CHMOD.rst b/Help/release/dev/file-CHMOD.rst deleted file mode 100644 index 994b529..0000000 --- a/Help/release/dev/file-CHMOD.rst +++ /dev/null @@ -1,5 +0,0 @@ -file-CHMOD ----------- - -* Add :command:`file(CHMOD)` and :command:`file(CHMOD_RECURSE)` to - set permissions of files and directories. diff --git a/Help/release/dev/file-REAL_PATH.rst b/Help/release/dev/file-REAL_PATH.rst deleted file mode 100644 index 32768ca..0000000 --- a/Help/release/dev/file-REAL_PATH.rst +++ /dev/null @@ -1,5 +0,0 @@ -file-REAL_PATH --------------- - -* The :command:`file` gained sub-command `REAL_PATH` to compute a path with - symlinks resolved. diff --git a/Help/release/dev/file-download-optional-file.rst b/Help/release/dev/file-download-optional-file.rst deleted file mode 100644 index f3dc24c..0000000 --- a/Help/release/dev/file-download-optional-file.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/file-generate-target.rst b/Help/release/dev/file-generate-target.rst deleted file mode 100644 index 09fb460..0000000 --- a/Help/release/dev/file-generate-target.rst +++ /dev/null @@ -1,5 +0,0 @@ -file-generate-target --------------------- - -* The :command:`file(GENERATE)` command gained a new ``TARGET`` keyword to - support resolving target-dependent generator expressions. diff --git a/Help/release/dev/fileapi-codemodel-2.2.rst b/Help/release/dev/fileapi-codemodel-2.2.rst deleted file mode 100644 index 5954df6..0000000 --- a/Help/release/dev/fileapi-codemodel-2.2.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/find_package-version_range.rst b/Help/release/dev/find_package-version_range.rst deleted file mode 100644 index 5305518..0000000 --- a/Help/release/dev/find_package-version_range.rst +++ /dev/null @@ -1,4 +0,0 @@ -find_package-version_range --------------------------- - -* The :command:`find_package` command learned to handle a version range. diff --git a/Help/release/dev/find_program-exe-no-read.rst b/Help/release/dev/find_program-exe-no-read.rst deleted file mode 100644 index 161b5db..0000000 --- a/Help/release/dev/find_program-exe-no-read.rst +++ /dev/null @@ -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`. diff --git a/Help/release/dev/genexpr-for-mfc-flag.rst b/Help/release/dev/genexpr-for-mfc-flag.rst deleted file mode 100644 index c56a290..0000000 --- a/Help/release/dev/genexpr-for-mfc-flag.rst +++ /dev/null @@ -1,4 +0,0 @@ -genexpr-for-mfc-flag --------------------- - -* The :variable:`CMAKE_MFC_FLAG` variable now supports generator expressions. diff --git a/Help/release/dev/ide-integration-guide.rst b/Help/release/dev/ide-integration-guide.rst deleted file mode 100644 index f11fadd..0000000 --- a/Help/release/dev/ide-integration-guide.rst +++ /dev/null @@ -1,4 +0,0 @@ -ide-integration-guide ---------------------- - -* A new guide on :guide:`IDE integration <IDE Integration Guide>` has been added. diff --git a/Help/release/dev/imported-target-location-required.rst b/Help/release/dev/imported-target-location-required.rst deleted file mode 100644 index 3625242..0000000 --- a/Help/release/dev/imported-target-location-required.rst +++ /dev/null @@ -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`. diff --git a/Help/release/dev/install-default-directory-permissions.rst b/Help/release/dev/install-default-directory-permissions.rst deleted file mode 100644 index 27cffee..0000000 --- a/Help/release/dev/install-default-directory-permissions.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/ispc-check-support.rst b/Help/release/dev/ispc-check-support.rst deleted file mode 100644 index 0023f0c..0000000 --- a/Help/release/dev/ispc-check-support.rst +++ /dev/null @@ -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'. diff --git a/Help/release/dev/ispc-language-support.rst b/Help/release/dev/ispc-language-support.rst deleted file mode 100644 index 254442e..0000000 --- a/Help/release/dev/ispc-language-support.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/macOS-sdk-latest.rst b/Help/release/dev/macOS-sdk-latest.rst deleted file mode 100644 index c5ac3a6..0000000 --- a/Help/release/dev/macOS-sdk-latest.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/optimize-link-dependencies.rst b/Help/release/dev/optimize-link-dependencies.rst deleted file mode 100644 index cfda826..0000000 --- a/Help/release/dev/optimize-link-dependencies.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/relax-target-generator-expression-dependency-addition.rst b/Help/release/dev/relax-target-generator-expression-dependency-addition.rst deleted file mode 100644 index 6d30596..0000000 --- a/Help/release/dev/relax-target-generator-expression-dependency-addition.rst +++ /dev/null @@ -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`` diff --git a/Help/release/dev/remove-cmake-gui-qt4.rst b/Help/release/dev/remove-cmake-gui-qt4.rst deleted file mode 100644 index 2b29b75..0000000 --- a/Help/release/dev/remove-cmake-gui-qt4.rst +++ /dev/null @@ -1,5 +0,0 @@ -remove-cmake-gui-qt4 --------------------- - -* :manual:`cmake-gui(1)` now requires Qt5. Support for compiling with Qt4 has - been removed. diff --git a/Help/release/dev/remove-warn-unused-vars.rst b/Help/release/dev/remove-warn-unused-vars.rst deleted file mode 100644 index 7a06e91..0000000 --- a/Help/release/dev/remove-warn-unused-vars.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/separate_arguments-PROGRAM.rst b/Help/release/dev/separate_arguments-PROGRAM.rst deleted file mode 100644 index 428bfda..0000000 --- a/Help/release/dev/separate_arguments-PROGRAM.rst +++ /dev/null @@ -1,5 +0,0 @@ -separate_arguments-PROGRAM --------------------------- - -* The :command:`separate_arguments` command gained new ``PROGRAM`` option to - search program. diff --git a/Help/release/dev/string-json-support.rst b/Help/release/dev/string-json-support.rst deleted file mode 100644 index bd75328..0000000 --- a/Help/release/dev/string-json-support.rst +++ /dev/null @@ -1,5 +0,0 @@ -string-json-support -------------------- - -* The :command:`string` command gained set of new ``JSON`` sub commands to provide JSON - parsing capabilities. diff --git a/Help/release/dev/visual-studio-android.rst b/Help/release/dev/visual-studio-android.rst deleted file mode 100644 index 4e1a110..0000000 --- a/Help/release/dev/visual-studio-android.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/vs-win-sdk-custom-max.rst b/Help/release/dev/vs-win-sdk-custom-max.rst deleted file mode 100644 index bd19fc8..0000000 --- a/Help/release/dev/vs-win-sdk-custom-max.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/win32-executable-genex.rst b/Help/release/dev/win32-executable-genex.rst deleted file mode 100644 index f03203d..0000000 --- a/Help/release/dev/win32-executable-genex.rst +++ /dev/null @@ -1,5 +0,0 @@ -win32-executable-genex ----------------------- - -* The :prop_tgt:`WIN32_EXECUTABLE` target property now supports - :manual:`generator expressions <cmake-generator-expressions(7)>`. diff --git a/Help/release/dev/xcode-12-new-build-system.rst b/Help/release/dev/xcode-12-new-build-system.rst deleted file mode 100644 index 7a497b0..0000000 --- a/Help/release/dev/xcode-12-new-build-system.rst +++ /dev/null @@ -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. diff --git a/Help/release/dev/xcode-link-phase-all.rst b/Help/release/dev/xcode-link-phase-all.rst deleted file mode 100644 index a38f70c..0000000 --- a/Help/release/dev/xcode-link-phase-all.rst +++ /dev/null @@ -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. diff --git a/Help/release/index.rst b/Help/release/index.rst index cdc3e8b..a8329a6 100644 --- a/Help/release/index.rst +++ b/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> |