From 1191647a0e44476084622db493f341a64692c41d Mon Sep 17 00:00:00 2001 From: Brad King Date: Tue, 4 Feb 2025 09:47:38 -0500 Subject: Help: Consolidate 4.0 release notes Run the `Utilities/Release/consolidate-relnotes.bash` script to move notes from `Help/release/dev/*` into `Help/release/4.0.rst`. --- Help/release/4.0.rst | 199 +++++++++++++++++++++ Help/release/dev/CMAKE_LANG_LINK_MODE.rst | 6 - ...AKE_TYPE_LINKER_FLAGS-LINKER-prefix-support.rst | 13 -- Help/release/dev/ExternalData-add-httpheader.rst | 5 - .../dev/ExternalProject-install-jobserver.rst | 7 - Help/release/dev/FindBISON.rst | 6 - Help/release/dev/FindCURL-version-var.rst | 5 - Help/release/dev/FindFLEX.rst | 6 - Help/release/dev/FindGDAL-deprecate.rst | 8 - Help/release/dev/FindPatch.rst | 5 - .../release/dev/FindProtobuf-protoc-exe-option.rst | 5 - Help/release/dev/FindPython-ARTIFACTS-PREFIX.rst | 7 - Help/release/dev/FindRuby-compat-vars.rst | 5 - Help/release/dev/GenEx-PATH-NATIVE_PATH.rst | 5 - .../dev/STATIC_LIBRARY_OPTIONS-ARCHIVER-prefix.rst | 6 - Help/release/dev/add_feature_info.rst | 6 - Help/release/dev/aix-archive-shared-libraries.rst | 5 - Help/release/dev/apple-compiler-selection.rst | 19 -- Help/release/dev/cpack-archive-name.rst | 6 - Help/release/dev/cpack-tar.rst | 5 - Help/release/dev/ctest-crash-handling.rst | 7 - .../dev/ctest-remove-declarative-script-mode.rst | 14 -- Help/release/dev/debugger-working-directory.rst | 15 -- Help/release/dev/execute-process-error.rst | 6 - Help/release/dev/link-warning-as-error.rst | 11 -- Help/release/dev/linker-configuration.rst | 7 - Help/release/dev/msvc-runtime-checks.rst | 7 - Help/release/dev/remove-old-compatibility.rst | 14 -- Help/release/dev/rename-cmakelists.rst | 12 -- Help/release/dev/swift-module-dir-genex.rst | 5 - .../dev/target_link_libraries-LINKER-prefix.rst | 5 - .../vs-custom-command-disable-parallel-build.rst | 6 - Help/release/dev/vs-solution-items.rst | 6 - Help/release/dev/xcode-scheme-lldb-init-file.rst | 7 - Help/release/dev/xcode-scheme-test-config.rst | 7 - Help/release/index.rst | 1 + 36 files changed, 200 insertions(+), 259 deletions(-) create mode 100644 Help/release/4.0.rst delete mode 100644 Help/release/dev/CMAKE_LANG_LINK_MODE.rst delete mode 100644 Help/release/dev/CMAKE_TYPE_LINKER_FLAGS-LINKER-prefix-support.rst delete mode 100644 Help/release/dev/ExternalData-add-httpheader.rst delete mode 100644 Help/release/dev/ExternalProject-install-jobserver.rst delete mode 100644 Help/release/dev/FindBISON.rst delete mode 100644 Help/release/dev/FindCURL-version-var.rst delete mode 100644 Help/release/dev/FindFLEX.rst delete mode 100644 Help/release/dev/FindGDAL-deprecate.rst delete mode 100644 Help/release/dev/FindPatch.rst delete mode 100644 Help/release/dev/FindProtobuf-protoc-exe-option.rst delete mode 100644 Help/release/dev/FindPython-ARTIFACTS-PREFIX.rst delete mode 100644 Help/release/dev/FindRuby-compat-vars.rst delete mode 100644 Help/release/dev/GenEx-PATH-NATIVE_PATH.rst delete mode 100644 Help/release/dev/STATIC_LIBRARY_OPTIONS-ARCHIVER-prefix.rst delete mode 100644 Help/release/dev/add_feature_info.rst delete mode 100644 Help/release/dev/aix-archive-shared-libraries.rst delete mode 100644 Help/release/dev/apple-compiler-selection.rst delete mode 100644 Help/release/dev/cpack-archive-name.rst delete mode 100644 Help/release/dev/cpack-tar.rst delete mode 100644 Help/release/dev/ctest-crash-handling.rst delete mode 100644 Help/release/dev/ctest-remove-declarative-script-mode.rst delete mode 100644 Help/release/dev/debugger-working-directory.rst delete mode 100644 Help/release/dev/execute-process-error.rst delete mode 100644 Help/release/dev/link-warning-as-error.rst delete mode 100644 Help/release/dev/linker-configuration.rst delete mode 100644 Help/release/dev/msvc-runtime-checks.rst delete mode 100644 Help/release/dev/remove-old-compatibility.rst delete mode 100644 Help/release/dev/rename-cmakelists.rst delete mode 100644 Help/release/dev/swift-module-dir-genex.rst delete mode 100644 Help/release/dev/target_link_libraries-LINKER-prefix.rst delete mode 100644 Help/release/dev/vs-custom-command-disable-parallel-build.rst delete mode 100644 Help/release/dev/vs-solution-items.rst delete mode 100644 Help/release/dev/xcode-scheme-lldb-init-file.rst delete mode 100644 Help/release/dev/xcode-scheme-test-config.rst diff --git a/Help/release/4.0.rst b/Help/release/4.0.rst new file mode 100644 index 0000000..35a8e10 --- /dev/null +++ b/Help/release/4.0.rst @@ -0,0 +1,199 @@ +CMake 4.0 Release Notes +*********************** + +.. only:: html + + .. contents:: + +Changes made since CMake 3.31 include the following. + +* The :module:`FeatureSummary` module :command:`add_feature_info` + command now supports full :ref:`Condition Syntax`. + See policy :policy:`CMP0183`. + +* On AIX, ``SHARED`` library targets now produce a shared library archive + by default. See policy :policy:`CMP0182`. + +* Builds targeting macOS no longer choose any SDK or pass an ``-isysroot`` + flag to the compiler by default. Instead, compilers are expected to + choose a default macOS SDK on their own. In order to use a compiler that + does not do this, users must now specify ``-DCMAKE_OSX_SYSROOT=macosx`` + when configuring their build. + +* On macOS with :ref:`Ninja Generators` and :ref:`Makefile Generators`, when + a compiler is found in ``/usr/bin``, it is now used as-is and is no longer + mapped to the corresponding compiler inside Xcode. The mapping was + introduced by CMake 3.2 to allow build trees to continue to work with their + original compiler even when ``xcode-select`` switches to a different + Xcode installation. However, the compilers inside Xcode cannot be used + without explicit ``-isysroot`` flags and are therefore not suitable for + passing to arbitrary third-party build systems. Furthermore, the mapping + behavior can override user-specified compiler paths. Therefore, this + behavior has been reverted. + +* The :variable:`CMAKE__LINK_MODE` and + :variable:`CMAKE__DEVICE_LINK_MODE` variables were added to provide + information on how the link step is done. + +* The :variable:`CMAKE_EXE_LINKER_FLAGS`, + :variable:`CMAKE_EXE_LINKER_FLAGS_`, + :variable:`CMAKE_SHARED_LINKER_FLAGS`, + :variable:`CMAKE_SHARED_LINKER_FLAGS_`, + :variable:`CMAKE_MODULE_LINKER_FLAGS`, + and :variable:`CMAKE_MODULE_LINKER_FLAGS_` variables learned to + support the ``LINKER:`` prefix. + + This support implies to parse and re-quote the content of these variables. + This parsing is controlled by :policy:`CMP0181` policy. + +* When using the :cpack_gen:`CPack Archive Generator`, the output archive + name can be overridden with the :variable:`CPACK_ARCHIVE_FILE_NAME` variable. + Previously, this variable worked only for component-based packages. + +* The :cpack_gen:`CPack Archive Generator` learned to generated ``.tar`` + packages without compression. + +* The :option:`ctest --interactive-debug-mode` option on Windows + now enables Windows Error Reporting by default in test processes, + allowing them to creating debug popup windows and core dumps. + This restores behavior previously removed by CMake 3.11. + +* CTest's declarative scripting mode has been removed. This mode used to be + triggered by a :option:`ctest -S` script which did not call any + :ref:`CTest Commands` unless :variable:`CTEST_RUN_CURRENT_SCRIPT` was + explicitly set to ``OFF``. This feature was undocumented and was not covered + by any unit tests. + +* The :variable:`CTEST_RUN_CURRENT_SCRIPT` variable no longer has any special + meaning. + +* The :command:`ctest_run_script` command may no longer be called without any + arguments. + +* The :variable:`CMAKE_DEBUGGER_WORKING_DIRECTORY` was added to + initialize the corresponding target property. + +* The :prop_tgt:`DEBUGGER_WORKING_DIRECTORY` target property was added + to tell generators what debugger working directory should be set for + the target. + +* The :manual:`cmake-file-api(7)` "codemodel" version 2 ``version`` field has + been updated to 2.8. + +* The :manual:`cmake-file-api(7)` "codemodel" version 2 "target" object gained + a new "debugger" field. + +* The :variable:`CMAKE_EXECUTE_PROCESS_COMMAND_ERROR_IS_FATAL` variable + was added to specify the :command:`execute_process` command's + default ``COMMAND_ERROR_IS_FATAL`` behavior. + +* The :module:`ExternalData` module gained a + :variable:`ExternalData_HTTPHEADERS` variable to specify HTTP headers. + +* The :module:`ExternalProject` module's :command:`ExternalProject_Add` + command gained an ``INSTALL_JOB_SERVER_AWARE`` option to enable + integration of the GNU Make job server when using an explicit + ``INSTALL_COMMAND`` with :ref:`Makefile Generators`. + +* The :module:`FindBISON` module :command:`bison_target` command has a new + ``OPTIONS`` option to add Bison command-line options as a + :ref:`semicolon-separated list `. + +* The :module:`FindCURL` module now provides a ``CURL_VERSION`` result + variable to match upstream cURL's CMake package. + +* The :module:`FindFLEX` module :command:`flex_target` command has a new + ``OPTIONS`` option to add Flex command-line options as a + :ref:`semicolon-separated list `. + +* The :module:`FindGDAL` module is now deprecated in favor of upstream + GDAL's official CMake package configuration file. Port projects to + the latter by calling ``find_package(GDAL CONFIG)``. For further + details, see `GDAL's documentation on CMake integration + `_. + +* The :module:`FindPatch` module now supports running in script mode by skipping + the creation of the imported target. + +* The :module:`FindProtobuf` module :command:`protobuf_generate` command + gained a ``PROTOC_EXE`` option to specify a custom ``protoc`` executable. + +* The :module:`FindPython`, :module:`FindPython2`, and :module:`FindPython3` + modules gained the possibility to do multiple calls in the same directory by + using, respectively, the variables ``Python_ARTIFACTS_PREFIX``, + ``Python2_ARTIFACTS_PREFIX``, and ``Python3_ARTIFACTS_PREFIX``. + +* The :module:`FindRuby` module no longer provides variables with the + upper-case ``RUBY_`` prefix. See policy :policy:`CMP0185`. + +* The :genex:`$` generator expression gains the sub-command + ``NATIVE_PATH`` to convert a CMake path into a native one. + +* The :variable:`CMAKE__USING_LINKER_MODE` variable is no longer used to + determine the type of the contents of the + :variable:`CMAKE__USING_LINKER_` variable. The + :variable:`CMAKE__LINK_MODE` variable, set by CMake, is used instead. + +* The :variable:`CMAKE_LINK_WARNING_AS_ERROR` variable and corresponding + :prop_tgt:`LINK_WARNING_AS_ERROR` target property were added to enable + link with a linker-specific flag to treat warnings as errors. +* The :manual:`cmake(1)` command line gained the + :option:`--link-no-warning-as-error ` + option which causes the effects of the :prop_tgt:`LINK_WARNING_AS_ERROR` + target property and :variable:`CMAKE_LINK_WARNING_AS_ERROR` variable to be + ignored. + +* The :variable:`CMAKE_MSVC_RUNTIME_CHECKS` variable and + :prop_tgt:`MSVC_RUNTIME_CHECKS` target property were introduced + to select runtime checks for compilers targeting the MSVC ABI. + See policy :policy:`CMP0184`. + +* Compatibility with versions of CMake older than 3.5 has been removed. + Calls to :command:`cmake_minimum_required` or :command:`cmake_policy` + that set the policy version to an older value now issue an error. + Note that calls to those commands can still support older versions of + CMake by using their ``VERSION`` arguments' ``...`` syntax. + This requires only the ```` version of CMake, but when running a + newer version, sets policies up to the ```` version. + +* The :generator:`Visual Studio 14 2015` and :generator:`Visual Studio 15 2017` + generators no longer support specifying a platform as part of the generator + name. See :ref:`Visual Studio Platform Selection`. + +* Adds :option:`cmake --project-file` option to specify an alternate filename + for CMakeLists files. This determines the top-level file processed when CMake + is configured, and the file processed by :command:`add_subdirectory`. By + default, this is ``CMakeLists.txt``. If set to anything else, + ``CMakeLists.txt`` will be used as a fallback if the given file cannot be + found within a project subdirectory. The use of alternate project file names + is intended for temporary use by developers during an incremental transition + and not for publication of a final product. CMake will always emit a warning + when the project file is anything other than ``CMakeLists.txt``. + +* The :prop_tgt:`STATIC_LIBRARY_OPTIONS` target property gains the support of + the ``ARCHIVER:`` prefix to pass options to the archiver through the compiler + driver in a portable way. + +* The :prop_tgt:`Swift_MODULE_DIRECTORY` target property now supports + :manual:`generator expressions `. + +* The :command:`target_link_libraries` command gains the support of the + ``LINKER:`` prefix. + +* The :prop_sf:`VS_CUSTOM_COMMAND_DISABLE_PARALLEL_BUILD` source file property + was added to tell :ref:`Visual Studio Generators` not to run a custom command + in parallel. + +* The :prop_dir:`VS_SOLUTION_ITEMS` directory property was added + to tell :ref:`Visual Studio Generators` to attach files directly + to the Solution (``.sln``). + +* The :variable:`CMAKE_XCODE_SCHEME_LLDB_INIT_FILE` variable and corresponding + :prop_tgt:`XCODE_SCHEME_LLDB_INIT_FILE` target property were added to tell + the :generator:`Xcode` generator what to put in the scheme's "LLDB Init File" + setting. + +* The :variable:`CMAKE_XCODE_SCHEME_TEST_CONFIGURATION` variable and corresponding + :prop_tgt:`XCODE_SCHEME_TEST_CONFIGURATION` target property were added to tell + the :generator:`Xcode` generator what to put in the scheme's "Build Configuration" + setting for the test action. diff --git a/Help/release/dev/CMAKE_LANG_LINK_MODE.rst b/Help/release/dev/CMAKE_LANG_LINK_MODE.rst deleted file mode 100644 index 859cd7c..0000000 --- a/Help/release/dev/CMAKE_LANG_LINK_MODE.rst +++ /dev/null @@ -1,6 +0,0 @@ -CMAKE_LANG_LINK_MODE --------------------- - -* The :variable:`CMAKE__LINK_MODE` and - :variable:`CMAKE__DEVICE_LINK_MODE` variables were added to provide - information on how the link step is done. diff --git a/Help/release/dev/CMAKE_TYPE_LINKER_FLAGS-LINKER-prefix-support.rst b/Help/release/dev/CMAKE_TYPE_LINKER_FLAGS-LINKER-prefix-support.rst deleted file mode 100644 index 3598dc5..0000000 --- a/Help/release/dev/CMAKE_TYPE_LINKER_FLAGS-LINKER-prefix-support.rst +++ /dev/null @@ -1,13 +0,0 @@ -CMAKE_TYPE_LINKER_FLAGS-LINKER-prefix-support ---------------------------------------------- - -* The :variable:`CMAKE_EXE_LINKER_FLAGS`, - :variable:`CMAKE_EXE_LINKER_FLAGS_`, - :variable:`CMAKE_SHARED_LINKER_FLAGS`, - :variable:`CMAKE_SHARED_LINKER_FLAGS_`, - :variable:`CMAKE_MODULE_LINKER_FLAGS`, - and :variable:`CMAKE_MODULE_LINKER_FLAGS_` variables learned to - support the ``LINKER:`` prefix. - - This support implies to parse and re-quote the content of these variables. - This parsing is controlled by :policy:`CMP0181` policy. diff --git a/Help/release/dev/ExternalData-add-httpheader.rst b/Help/release/dev/ExternalData-add-httpheader.rst deleted file mode 100644 index bd950d8..0000000 --- a/Help/release/dev/ExternalData-add-httpheader.rst +++ /dev/null @@ -1,5 +0,0 @@ -ExternalData-add-httpheader ---------------------------- - -* The :module:`ExternalData` module gained a - :variable:`ExternalData_HTTPHEADERS` variable to specify HTTP headers. diff --git a/Help/release/dev/ExternalProject-install-jobserver.rst b/Help/release/dev/ExternalProject-install-jobserver.rst deleted file mode 100644 index 7d8116c..0000000 --- a/Help/release/dev/ExternalProject-install-jobserver.rst +++ /dev/null @@ -1,7 +0,0 @@ -ExternalProject-install-jobserver ---------------------------------- - -* The :module:`ExternalProject` module's :command:`ExternalProject_Add` - command gained an ``INSTALL_JOB_SERVER_AWARE`` option to enable - integration of the GNU Make job server when using an explicit - ``INSTALL_COMMAND`` with :ref:`Makefile Generators`. diff --git a/Help/release/dev/FindBISON.rst b/Help/release/dev/FindBISON.rst deleted file mode 100644 index 1005869..0000000 --- a/Help/release/dev/FindBISON.rst +++ /dev/null @@ -1,6 +0,0 @@ -FindBISON ---------- - -* The :module:`FindBISON` module :command:`bison_target` command has a new - ``OPTIONS`` option to add Bison command-line options as a - :ref:`semicolon-separated list `. diff --git a/Help/release/dev/FindCURL-version-var.rst b/Help/release/dev/FindCURL-version-var.rst deleted file mode 100644 index 8b1fb18..0000000 --- a/Help/release/dev/FindCURL-version-var.rst +++ /dev/null @@ -1,5 +0,0 @@ -FindCURL-version-var --------------------- - -* The :module:`FindCURL` module now provides a ``CURL_VERSION`` result - variable to match upstream cURL's CMake package. diff --git a/Help/release/dev/FindFLEX.rst b/Help/release/dev/FindFLEX.rst deleted file mode 100644 index 6faec23..0000000 --- a/Help/release/dev/FindFLEX.rst +++ /dev/null @@ -1,6 +0,0 @@ -FindFLEX --------- - -* The :module:`FindFLEX` module :command:`flex_target` command has a new - ``OPTIONS`` option to add Flex command-line options as a - :ref:`semicolon-separated list `. diff --git a/Help/release/dev/FindGDAL-deprecate.rst b/Help/release/dev/FindGDAL-deprecate.rst deleted file mode 100644 index d6151dc..0000000 --- a/Help/release/dev/FindGDAL-deprecate.rst +++ /dev/null @@ -1,8 +0,0 @@ -FindGDAL-deprecate ------------------- - -* The :module:`FindGDAL` module is now deprecated in favor of upstream - GDAL's official CMake package configuration file. Port projects to - the latter by calling ``find_package(GDAL CONFIG)``. For further - details, see `GDAL's documentation on CMake integration - `_. diff --git a/Help/release/dev/FindPatch.rst b/Help/release/dev/FindPatch.rst deleted file mode 100644 index 31efa66..0000000 --- a/Help/release/dev/FindPatch.rst +++ /dev/null @@ -1,5 +0,0 @@ -FindPatch ---------- - -* The :module:`FindPatch` module now supports running in script mode by skipping - the creation of the imported target. diff --git a/Help/release/dev/FindProtobuf-protoc-exe-option.rst b/Help/release/dev/FindProtobuf-protoc-exe-option.rst deleted file mode 100644 index 93d60cb..0000000 --- a/Help/release/dev/FindProtobuf-protoc-exe-option.rst +++ /dev/null @@ -1,5 +0,0 @@ -FindProtobuf-protoc-exe-option ------------------------------- - -* The :module:`FindProtobuf` module :command:`protobuf_generate` command - gained a ``PROTOC_EXE`` option to specify a custom ``protoc`` executable. diff --git a/Help/release/dev/FindPython-ARTIFACTS-PREFIX.rst b/Help/release/dev/FindPython-ARTIFACTS-PREFIX.rst deleted file mode 100644 index 4b3e6e5..0000000 --- a/Help/release/dev/FindPython-ARTIFACTS-PREFIX.rst +++ /dev/null @@ -1,7 +0,0 @@ -FindPython-ARTIFACTS-PREFIX ---------------------------- - -* The :module:`FindPython`, :module:`FindPython2`, and :module:`FindPython3` - modules gained the possibility to do multiple calls in the same directory by - using, respectively, the variables ``Python_ARTIFACTS_PREFIX``, - ``Python2_ARTIFACTS_PREFIX``, and ``Python3_ARTIFACTS_PREFIX``. diff --git a/Help/release/dev/FindRuby-compat-vars.rst b/Help/release/dev/FindRuby-compat-vars.rst deleted file mode 100644 index 1a08695..0000000 --- a/Help/release/dev/FindRuby-compat-vars.rst +++ /dev/null @@ -1,5 +0,0 @@ -FindRuby-compat-vars --------------------- - -* The :module:`FindRuby` module no longer provides variables with the - upper-case ``RUBY_`` prefix. See policy :policy:`CMP0185`. diff --git a/Help/release/dev/GenEx-PATH-NATIVE_PATH.rst b/Help/release/dev/GenEx-PATH-NATIVE_PATH.rst deleted file mode 100644 index 0a1a424..0000000 --- a/Help/release/dev/GenEx-PATH-NATIVE_PATH.rst +++ /dev/null @@ -1,5 +0,0 @@ -GenEx-PATH-NATIVE_PATH ----------------------- - -* The :genex:`$` generator expression gains the sub-command - ``NATIVE_PATH`` to convert a CMake path into a native one. diff --git a/Help/release/dev/STATIC_LIBRARY_OPTIONS-ARCHIVER-prefix.rst b/Help/release/dev/STATIC_LIBRARY_OPTIONS-ARCHIVER-prefix.rst deleted file mode 100644 index 121e688..0000000 --- a/Help/release/dev/STATIC_LIBRARY_OPTIONS-ARCHIVER-prefix.rst +++ /dev/null @@ -1,6 +0,0 @@ -STATIC_LIBRARY_OPTIONS-ARCHIVER-prefix --------------------------------------- - -* The :prop_tgt:`STATIC_LIBRARY_OPTIONS` target property gains the support of - the ``ARCHIVER:`` prefix to pass options to the archiver through the compiler - driver in a portable way. diff --git a/Help/release/dev/add_feature_info.rst b/Help/release/dev/add_feature_info.rst deleted file mode 100644 index 776d804..0000000 --- a/Help/release/dev/add_feature_info.rst +++ /dev/null @@ -1,6 +0,0 @@ -add_feature_info ----------------- - -* The :module:`FeatureSummary` module :command:`add_feature_info` - command now supports full :ref:`Condition Syntax`. - See policy :policy:`CMP0183`. diff --git a/Help/release/dev/aix-archive-shared-libraries.rst b/Help/release/dev/aix-archive-shared-libraries.rst deleted file mode 100644 index 1a6cf65..0000000 --- a/Help/release/dev/aix-archive-shared-libraries.rst +++ /dev/null @@ -1,5 +0,0 @@ -aix-archive-shared-libraries ----------------------------- - -* On AIX, ``SHARED`` library targets now produce a shared library archive - by default. See policy :policy:`CMP0182`. diff --git a/Help/release/dev/apple-compiler-selection.rst b/Help/release/dev/apple-compiler-selection.rst deleted file mode 100644 index 79727df..0000000 --- a/Help/release/dev/apple-compiler-selection.rst +++ /dev/null @@ -1,19 +0,0 @@ -apple-compiler-selection ------------------------- - -* Builds targeting macOS no longer choose any SDK or pass an ``-isysroot`` - flag to the compiler by default. Instead, compilers are expected to - choose a default macOS SDK on their own. In order to use a compiler that - does not do this, users must now specify ``-DCMAKE_OSX_SYSROOT=macosx`` - when configuring their build. - -* On macOS with :ref:`Ninja Generators` and :ref:`Makefile Generators`, when - a compiler is found in ``/usr/bin``, it is now used as-is and is no longer - mapped to the corresponding compiler inside Xcode. The mapping was - introduced by CMake 3.2 to allow build trees to continue to work with their - original compiler even when ``xcode-select`` switches to a different - Xcode installation. However, the compilers inside Xcode cannot be used - without explicit ``-isysroot`` flags and are therefore not suitable for - passing to arbitrary third-party build systems. Furthermore, the mapping - behavior can override user-specified compiler paths. Therefore, this - behavior has been reverted. diff --git a/Help/release/dev/cpack-archive-name.rst b/Help/release/dev/cpack-archive-name.rst deleted file mode 100644 index 8e9c00b..0000000 --- a/Help/release/dev/cpack-archive-name.rst +++ /dev/null @@ -1,6 +0,0 @@ -cpack-archive-name ------------------- - -* When using the :cpack_gen:`CPack Archive Generator`, the output archive - name can be overridden with the :variable:`CPACK_ARCHIVE_FILE_NAME` variable. - Previously, this variable worked only for component-based packages. diff --git a/Help/release/dev/cpack-tar.rst b/Help/release/dev/cpack-tar.rst deleted file mode 100644 index 7613830..0000000 --- a/Help/release/dev/cpack-tar.rst +++ /dev/null @@ -1,5 +0,0 @@ -cpack-tar ---------- - -* The :cpack_gen:`CPack Archive Generator` learned to generated ``.tar`` - packages without compression. diff --git a/Help/release/dev/ctest-crash-handling.rst b/Help/release/dev/ctest-crash-handling.rst deleted file mode 100644 index 266706f..0000000 --- a/Help/release/dev/ctest-crash-handling.rst +++ /dev/null @@ -1,7 +0,0 @@ -ctest-crash-handling --------------------- - -* The :option:`ctest --interactive-debug-mode` option on Windows - now enables Windows Error Reporting by default in test processes, - allowing them to creating debug popup windows and core dumps. - This restores behavior previously removed by CMake 3.11. diff --git a/Help/release/dev/ctest-remove-declarative-script-mode.rst b/Help/release/dev/ctest-remove-declarative-script-mode.rst deleted file mode 100644 index c346abe..0000000 --- a/Help/release/dev/ctest-remove-declarative-script-mode.rst +++ /dev/null @@ -1,14 +0,0 @@ -ctest-remove-declarative-script-mode ------------------------------------- - -* CTest's declarative scripting mode has been removed. This mode used to be - triggered by a :option:`ctest -S` script which did not call any - :ref:`CTest Commands` unless :variable:`CTEST_RUN_CURRENT_SCRIPT` was - explicitly set to ``OFF``. This feature was undocumented and was not covered - by any unit tests. - -* The :variable:`CTEST_RUN_CURRENT_SCRIPT` variable no longer has any special - meaning. - -* The :command:`ctest_run_script` command may no longer be called without any - arguments. diff --git a/Help/release/dev/debugger-working-directory.rst b/Help/release/dev/debugger-working-directory.rst deleted file mode 100644 index 5fee86a..0000000 --- a/Help/release/dev/debugger-working-directory.rst +++ /dev/null @@ -1,15 +0,0 @@ -debugger-working-directory --------------------------- - -* The :variable:`CMAKE_DEBUGGER_WORKING_DIRECTORY` was added to - initialize the corresponding target property. - -* The :prop_tgt:`DEBUGGER_WORKING_DIRECTORY` target property was added - to tell generators what debugger working directory should be set for - the target. - -* The :manual:`cmake-file-api(7)` "codemodel" version 2 ``version`` field has - been updated to 2.8. - -* The :manual:`cmake-file-api(7)` "codemodel" version 2 "target" object gained - a new "debugger" field. diff --git a/Help/release/dev/execute-process-error.rst b/Help/release/dev/execute-process-error.rst deleted file mode 100644 index 73136b2..0000000 --- a/Help/release/dev/execute-process-error.rst +++ /dev/null @@ -1,6 +0,0 @@ -execute-process-error ---------------------- - -* The :variable:`CMAKE_EXECUTE_PROCESS_COMMAND_ERROR_IS_FATAL` variable - was added to specify the :command:`execute_process` command's - default ``COMMAND_ERROR_IS_FATAL`` behavior. diff --git a/Help/release/dev/link-warning-as-error.rst b/Help/release/dev/link-warning-as-error.rst deleted file mode 100644 index 2e90630..0000000 --- a/Help/release/dev/link-warning-as-error.rst +++ /dev/null @@ -1,11 +0,0 @@ -link-warning-as-error ---------------------- - -* The :variable:`CMAKE_LINK_WARNING_AS_ERROR` variable and corresponding - :prop_tgt:`LINK_WARNING_AS_ERROR` target property were added to enable - link with a linker-specific flag to treat warnings as errors. -* The :manual:`cmake(1)` command line gained the - :option:`--link-no-warning-as-error ` - option which causes the effects of the :prop_tgt:`LINK_WARNING_AS_ERROR` - target property and :variable:`CMAKE_LINK_WARNING_AS_ERROR` variable to be - ignored. diff --git a/Help/release/dev/linker-configuration.rst b/Help/release/dev/linker-configuration.rst deleted file mode 100644 index 91fbd4c..0000000 --- a/Help/release/dev/linker-configuration.rst +++ /dev/null @@ -1,7 +0,0 @@ -linker-configuration --------------------- - -* The :variable:`CMAKE__USING_LINKER_MODE` variable is no longer used to - determine the type of the contents of the - :variable:`CMAKE__USING_LINKER_` variable. The - :variable:`CMAKE__LINK_MODE` variable, set by CMake, is used instead. diff --git a/Help/release/dev/msvc-runtime-checks.rst b/Help/release/dev/msvc-runtime-checks.rst deleted file mode 100644 index 1956105..0000000 --- a/Help/release/dev/msvc-runtime-checks.rst +++ /dev/null @@ -1,7 +0,0 @@ -msvc-runtime-checks -------------------- - -* The :variable:`CMAKE_MSVC_RUNTIME_CHECKS` variable and - :prop_tgt:`MSVC_RUNTIME_CHECKS` target property were introduced - to select runtime checks for compilers targeting the MSVC ABI. - See policy :policy:`CMP0184`. diff --git a/Help/release/dev/remove-old-compatibility.rst b/Help/release/dev/remove-old-compatibility.rst deleted file mode 100644 index 7c8c39a..0000000 --- a/Help/release/dev/remove-old-compatibility.rst +++ /dev/null @@ -1,14 +0,0 @@ -remove-old-compatibility ------------------------- - -* Compatibility with versions of CMake older than 3.5 has been removed. - Calls to :command:`cmake_minimum_required` or :command:`cmake_policy` - that set the policy version to an older value now issue an error. - Note that calls to those commands can still support older versions of - CMake by using their ``VERSION`` arguments' ``...`` syntax. - This requires only the ```` version of CMake, but when running a - newer version, sets policies up to the ```` version. - -* The :generator:`Visual Studio 14 2015` and :generator:`Visual Studio 15 2017` - generators no longer support specifying a platform as part of the generator - name. See :ref:`Visual Studio Platform Selection`. diff --git a/Help/release/dev/rename-cmakelists.rst b/Help/release/dev/rename-cmakelists.rst deleted file mode 100644 index f6e4a86..0000000 --- a/Help/release/dev/rename-cmakelists.rst +++ /dev/null @@ -1,12 +0,0 @@ -Option to specify alternate CMakeLists filename ------------------------------------------------ - -* Adds :option:`cmake --project-file` option to specify an alternate filename - for CMakeLists files. This determines the top-level file processed when CMake - is configured, and the file processed by :command:`add_subdirectory`. By - default, this is ``CMakeLists.txt``. If set to anything else, - ``CMakeLists.txt`` will be used as a fallback if the given file cannot be - found within a project subdirectory. The use of alternate project file names - is intended for temporary use by developers during an incremental transition - and not for publication of a final product. CMake will always emit a warning - when the project file is anything other than ``CMakeLists.txt``. diff --git a/Help/release/dev/swift-module-dir-genex.rst b/Help/release/dev/swift-module-dir-genex.rst deleted file mode 100644 index 413301f..0000000 --- a/Help/release/dev/swift-module-dir-genex.rst +++ /dev/null @@ -1,5 +0,0 @@ -swift-module-dir-genex ----------------------- - -* The :prop_tgt:`Swift_MODULE_DIRECTORY` target property now supports - :manual:`generator expressions `. diff --git a/Help/release/dev/target_link_libraries-LINKER-prefix.rst b/Help/release/dev/target_link_libraries-LINKER-prefix.rst deleted file mode 100644 index 08f36af..0000000 --- a/Help/release/dev/target_link_libraries-LINKER-prefix.rst +++ /dev/null @@ -1,5 +0,0 @@ -target_link_libraries-LINKER-prefix ------------------------------------ - -* The :command:`target_link_libraries` command gains the support of the - ``LINKER:`` prefix. diff --git a/Help/release/dev/vs-custom-command-disable-parallel-build.rst b/Help/release/dev/vs-custom-command-disable-parallel-build.rst deleted file mode 100644 index 1867a4a..0000000 --- a/Help/release/dev/vs-custom-command-disable-parallel-build.rst +++ /dev/null @@ -1,6 +0,0 @@ -vs-custom-command-disable-parallel-build ----------------------------------------- - -* The :prop_sf:`VS_CUSTOM_COMMAND_DISABLE_PARALLEL_BUILD` source file property - was added to tell :ref:`Visual Studio Generators` not to run a custom command - in parallel. diff --git a/Help/release/dev/vs-solution-items.rst b/Help/release/dev/vs-solution-items.rst deleted file mode 100644 index 35489bc..0000000 --- a/Help/release/dev/vs-solution-items.rst +++ /dev/null @@ -1,6 +0,0 @@ -vs-solution-items ------------------ - -* The :prop_dir:`VS_SOLUTION_ITEMS` directory property was added - to tell :ref:`Visual Studio Generators` to attach files directly - to the Solution (``.sln``). diff --git a/Help/release/dev/xcode-scheme-lldb-init-file.rst b/Help/release/dev/xcode-scheme-lldb-init-file.rst deleted file mode 100644 index 8a7921c..0000000 --- a/Help/release/dev/xcode-scheme-lldb-init-file.rst +++ /dev/null @@ -1,7 +0,0 @@ -xcode-scheme-lldb-init-file ---------------------------- - -* The :variable:`CMAKE_XCODE_SCHEME_LLDB_INIT_FILE` variable and corresponding - :prop_tgt:`XCODE_SCHEME_LLDB_INIT_FILE` target property were added to tell - the :generator:`Xcode` generator what to put in the scheme's "LLDB Init File" - setting. diff --git a/Help/release/dev/xcode-scheme-test-config.rst b/Help/release/dev/xcode-scheme-test-config.rst deleted file mode 100644 index ed8d11c..0000000 --- a/Help/release/dev/xcode-scheme-test-config.rst +++ /dev/null @@ -1,7 +0,0 @@ -xcode-scheme-test-config ------------------------- - -* The :variable:`CMAKE_XCODE_SCHEME_TEST_CONFIGURATION` variable and corresponding - :prop_tgt:`XCODE_SCHEME_TEST_CONFIGURATION` target property were added to tell - the :generator:`Xcode` generator what to put in the scheme's "Build Configuration" - setting for the test action. diff --git a/Help/release/index.rst b/Help/release/index.rst index 101dd68..7c44090 100644 --- a/Help/release/index.rst +++ b/Help/release/index.rst @@ -15,6 +15,7 @@ Releases .. toctree:: :maxdepth: 1 + 4.0 <4.0> 3.31 <3.31> 3.30 <3.30> 3.29 <3.29> -- cgit v0.12