diff --git a/Help/release/3.2.0.rst b/Help/release/3.2.0.rst new file mode 100644 index 000000000..142d40844 --- /dev/null +++ b/Help/release/3.2.0.rst @@ -0,0 +1,249 @@ +CMake 3.2.0 Release Notes +************************* + +.. only:: html + + .. contents:: + +Changes made since CMake 3.1.0 include the following. + +* A new :command:`continue` command was added that can be called inside loop + contexts to end the current iteration and start the next one at the top of + the loop block. + +* A :module:`FindGSL` module was introduced to find the + GNU Scientific Library. + +* The :module:`FindIntl` module was added to find the Gettext ``libintl`` + library. + +* A :module:`FindJsonCpp` module was introduced to find the + JsonCpp package. + +* The :command:`ctest_coverage` learned to support Javascript coverage. + +* The :manual:`cmake(1)` ``-E tar`` command now supports creating + ``.xz``-compressed archives with the ``J`` flag. + +* On OS X with Makefile and Ninja generators, when a compiler is found + in ``/usr/bin`` it is now mapped to the corresponding compiler inside + the Xcode application folder, if any. This allows such build + trees to continue to work with their original compiler even when + ``xcode-select`` switches to a different Xcode installation. + +* The :manual:`Compile Features ` functionality + is now aware of features supported by GNU compilers on OS X. + +* The :command:`break` command now rejects calls outside of a loop + context or that pass arguments to the command. + See policy :policy:`CMP0055`. + +* Add :variable:`CMAKE_MATCH_COUNT` for the number of matches made in the last + regular expression. + +* The :manual:`cmake(1)` ``-E tar`` command learned a new + ``--files-from=`` option to specify file names using + lines in a file to overcome command-line length limits. + +* The :manual:`cmake(1)` ``-E tar`` command learned a new + ``--mtime=`` option to specify the modification time + recorded in tarball entries. + +* The :command:`add_custom_command` and :command:`add_custom_target` + commands learned a new ``USES_TERMINAL`` option to request that + the command be given direct access to the terminal if possible. + The :generator:`Ninja` generator will places such commands in the + ``console`` pool. Build targets provided by CMake that are meant + for individual interactive use, such as ``install``, are now + placed in this pool. + +* The :module:`CPackRPM` module learned options to set per-component + descriptions and summaries. See the + :variable:`CPACK_RPM__PACKAGE_DESCRIPTION` and + :variable:`CPACK_RPM__PACKAGE_SUMMARY` variables. + +* The :module:`CPackRPM` module learned options to specify + requirements for pre- and post-install scripts. See the + :variable:`CPACK_RPM_PACKAGE_REQUIRES_PRE` and + :variable:`CPACK_RPM_PACKAGE_REQUIRES_POST` variables. + +* The :module:`CPackRPM` module learned options to specify + requirements for pre- and post-uninstall scripts. See the + :variable:`CPACK_RPM_PACKAGE_REQUIRES_PREUN` and + :variable:`CPACK_RPM_PACKAGE_REQUIRES_POSTUN` variables. + +* The :module:`CTestCoverageCollectGCOV` module was introduced as an + alternative to the :command:`ctest_coverage` command for collecting + ``gcov`` results for submission to CDash. + +* The :command:`ctest_coverage` learned to support Delphi coverage. + +* On OS X, commands supporting network communication, such as + :command:`file(DOWNLOAD)`, :command:`file(UPLOAD)`, and + :command:`ctest_submit`, now support SSL/TLS even when CMake + is not built against OpenSSL. The OS X native SSL/TLS + implementation is used by default. OS-configured certificate + authorities will be trusted automatically. + +* When CMake is built with OpenSSL on systems other than Windows + and OS X, commands supporting network communication via ``https``, + such as :command:`file(DOWNLOAD)`, :command:`file(UPLOAD)`, and + :command:`ctest_submit`, now search for OS-configured certificate + authorities in a few ``/etc`` paths to be trusted automatically. + +* On Windows, commands supporting network communication, such as + :command:`file(DOWNLOAD)`, :command:`file(UPLOAD)`, and + :command:`ctest_submit`, now support SSL/TLS even when CMake + is not built against OpenSSL. The Windows native SSL/TLS + implementation is used by default. OS-configured certificate + authorities will be trusted automatically. + +* The :command:`add_custom_command` and :command:`add_custom_target` + commands learned a new ``BYPRODUCTS`` option to specify files + produced as side effects of the custom commands. These are not + outputs because they do not always have to be newer than inputs. + +* The :module:`ExternalData` module learned to support + :ref:`Custom Fetch Scripts `. + This allows projects to specify custom ``.cmake`` scripts for + fetching data objects during the build. + +* The :module:`ExternalProject` module ``ExternalProject_Add`` function + learned a new ``CMAKE_CACHE_DEFAULT_ARGS`` option to initialize cache + values in the external project without setting them on future builds. + +* The :module:`ExternalProject` module learned options to create + independent external project step targets that do not depend + on the builtin steps. + +* The :module:`ExternalProject` module :command:`ExternalProject_Add` + command learned a ``TEST_EXCLUDE_FROM_MAIN`` option to exclude tests + from the main build. + +* The :module:`ExternalProject` module ``ExternalProject_Add`` command + learned an ``UPDATE_DISCONNECTED`` option to avoid automatically + updating the source tree checkout from version control. + +* The :manual:`Compile Features ` functionality + is now aware of features supported by Microsoft Visual Studio (``MSVC``). + +* The :command:`file(LOCK)` subcommand was created to allow CMake + processes to synchronize through file and directory locks. + +* The :command:`file(STRINGS)` now supports UTF-16LE, UTF-16BE, + UTF-32LE, UTF-32BE as ``ENCODING`` options. + +* The :module:`FindCUDA` module learned about the ``cusolver`` + library in CUDA 7.0. + +* The :module:`FindGit` module learned to find the ``git`` command-line tool + that comes with GitHub for Windows installed in user home directories. + +* The :module:`FindLATEX` module learned to support components. + +* The :module:`FindMPI` module learned to find MS-MPI on Windows. + +* The :module:`FindOpenGL` module no longer explicitly searches + for any dependency on X11 libraries with the :module:`FindX11` + module. Such dependencies should not need to be explicit. + Applications using X11 APIs themselves should find and link + to X11 libraries explicitly. + +* The :module:`FindOpenSSL` module now reports ``crypto`` and ``ssl`` + libraries separately in ``OPENSSL_CRYPTO_LIBRARY`` and + ``OPENSSL_SSL_LIBRARY``, respectively, to allow applications to + link to one without the other. + +* The :manual:`Compile Features ` functionality + is now aware of features supported by GNU 4.4 to 4.6 compilers. + +* The :command:`install(EXPORT)` command now works with an absolute + ``DESTINATION`` even if targets in the export set are installed + with a destination or usage requirements specified relative to the + install prefix. The value of the :variable:`CMAKE_INSTALL_PREFIX` + variable is hard-coded into the installed export file as the base + for relative references. + +* The :manual:`Compile Features ` functionality + is now aware of features supported by GNU compiler version 5.0. + +* The :module:`CPackRPM` module learned a new + :variable:`CPACK_RPM__PACKAGE_PREFIX` variable to + specify a component-specific value to use instead of + :variable:`CPACK_PACKAGING_INSTALL_PREFIX`. + +* The :module:`CPackRPM` module learned a new + :variable:`CPACK_RPM_RELOCATION_PATHS` variable to + specify multiple relocation prefixes for a single rpm package. + +* The :manual:`Compile Features ` functionality + is now aware of features supported by Oracle SolarisStudio (``SunPro``). + +* The :command:`try_compile` command source file signature now honors + link flags (e.g. :variable:`CMAKE_EXE_LINKER_FLAGS`) in the generated + test project. See policy :policy:`CMP0056`. + +* The :command:`try_run` command learned to honor the ``LINK_LIBRARIES`` + option just as :command:`try_compile` already does. + +* The implementation of CMake relies on some C++ compiler features which are + not supported by some older compilers. As a result, those old compilers + can no longer be used to build CMake itself. CMake continues to be able to + generate Makefiles and project files for users of those old compilers + however. The compilers known to no longer be capable of building CMake + are: + + * MSVC 6 and 7.0 - superceded by VisualStudio 7.1 and newer compilers. + * GCC 2.95 - superceded by GCC 3 and newer compilers. + * Borland compilers - superceded by other Windows compilers. + * Compaq compilers - superceded by other compilers. + * Comeau compilers - superceded by other compilers. + * SGI compilers - IRIX was dropped as a host platform. + + When building using SolarisStudio 12, the default ``libCStd`` standard + library is not sufficient to build CMake. The SolarisStudio distribution + supports compiler options to use ``STLPort4`` or ``libstdc++``. An + appropriate option to select the standard library is now added + automatically when building CMake with SolarisStudio compilers. + +* A :prop_tgt:`ANDROID_API_MIN` target property was introduced to + specify the minimum version to be targeted by the toolchain. + +* A :prop_sf:`VS_SHADER_FLAGS` source file property was added to specify + additional shader flags to ``.hlsl`` files, for the Visual Studio generators. + +* The :module:`WriteCompilerDetectionHeader` module learned to + create a define for portability of the cxx_thread_local feature. The define + expands to either the C++11 ``thread_local`` keyword, or a + pre-standardization compiler-specific equivalent, as appropriate. + +* On Windows, CMake learned to support international characters. + This allows use of characters from multiple (spoken) languages + in CMake code, paths to source files, configured files such as + ``.h.in`` files, and other files read and written by CMake. + Because CMake interoperates with many other tools, there may + still be some limitations when using certain international + characters. + + Files written in the :manual:`cmake-language(7)`, such as + ``CMakeLists.txt`` or ``*.cmake`` files, are expected to be + encoded as UTF-8. If files are already ASCII, they will be + compatible. If files were in a different encoding, including + Latin 1, they will need to be converted. + + The Visual Studio generators now write solution and project + files in UTF-8 instead of Windows-1252. Windows-1252 supported + Latin 1 languages such as those found in North and South America + and Western Europe. With UTF-8, additional languages are now + supported. + +* The :module:`WriteCompilerDetectionHeader` module learned to create + multiple output files per compiler and per language, instead of creating + one large file. + +* The :manual:`Compile Features ` functionality + is now aware of features supported by Apple Clang (``AppleClang``). + +* The :generator:`Xcode` generator no longer requires a value for + the :variable:`CMAKE_MAKE_PROGRAM` variable to be located up front. + It now locates ``xcodebuild`` when needed at build time. diff --git a/Help/release/dev/Apple-GNU-compiler-features.rst b/Help/release/dev/Apple-GNU-compiler-features.rst deleted file mode 100644 index 40c371287..000000000 --- a/Help/release/dev/Apple-GNU-compiler-features.rst +++ /dev/null @@ -1,5 +0,0 @@ -Apple-GNU-compiler-features ---------------------------- - -* The :manual:`Compile Features ` functionality - is now aware of features supported by GNU compilers on OS X. diff --git a/Help/release/dev/Apple-compiler-selection.rst b/Help/release/dev/Apple-compiler-selection.rst deleted file mode 100644 index 5ff565345..000000000 --- a/Help/release/dev/Apple-compiler-selection.rst +++ /dev/null @@ -1,8 +0,0 @@ -Apple-compiler-selection ------------------------- - -* On OS X with Makefile and Ninja generators, when a compiler is found - in ``/usr/bin`` it is now mapped to the corresponding compiler inside - the Xcode application folder, if any. This allows such build - trees to continue to work with their original compiler even when - ``xcode-select`` switches to a different Xcode installation. diff --git a/Help/release/dev/CTestCoverageCollectGCOV-refinements.rst b/Help/release/dev/CTestCoverageCollectGCOV-refinements.rst deleted file mode 100644 index afa0a52fd..000000000 --- a/Help/release/dev/CTestCoverageCollectGCOV-refinements.rst +++ /dev/null @@ -1,6 +0,0 @@ -CTestCoverageCollectGCOV-refinements ------------------------------------- - -* The :module:`CTestCoverageCollectGCOV` module was introduced as an - alternative to the :command:`ctest_coverage` command for collecting - ``gcov`` results for submission to CDash. diff --git a/Help/release/dev/ExternalData-custom-download.rst b/Help/release/dev/ExternalData-custom-download.rst deleted file mode 100644 index c40f4f7f3..000000000 --- a/Help/release/dev/ExternalData-custom-download.rst +++ /dev/null @@ -1,7 +0,0 @@ -ExternalData-custom-download ----------------------------- - -* The :module:`ExternalData` module learned to support - :ref:`Custom Fetch Scripts `. - This allows projects to specify custom ``.cmake`` scripts for - fetching data objects during the build. diff --git a/Help/release/dev/ExternalProject_CMAKE_CACHE_DEFAULT_ARGS.rst b/Help/release/dev/ExternalProject_CMAKE_CACHE_DEFAULT_ARGS.rst deleted file mode 100644 index 1838ab6c3..000000000 --- a/Help/release/dev/ExternalProject_CMAKE_CACHE_DEFAULT_ARGS.rst +++ /dev/null @@ -1,6 +0,0 @@ -ExternalProject_CMAKE_CACHE_DEFAULT_ARGS ----------------------------------------- - -* The :module:`ExternalProject` module ``ExternalProject_Add`` function - learned a new ``CMAKE_CACHE_DEFAULT_ARGS`` option to initialize cache - values in the external project without setting them on future builds. diff --git a/Help/release/dev/ExternalProject_TEST_EXCLUDE_FROM_MAIN.rst b/Help/release/dev/ExternalProject_TEST_EXCLUDE_FROM_MAIN.rst deleted file mode 100644 index dfbf1089c..000000000 --- a/Help/release/dev/ExternalProject_TEST_EXCLUDE_FROM_MAIN.rst +++ /dev/null @@ -1,6 +0,0 @@ -ExternalProject_TEST_EXCLUDE_FROM_MAIN --------------------------------------- - -* The :module:`ExternalProject` module :command:`ExternalProject_Add` - command learned a ``TEST_EXCLUDE_FROM_MAIN`` option to exclude tests - from the main build. diff --git a/Help/release/dev/ExternalProject_UPDATE_DISCONNECTED.rst b/Help/release/dev/ExternalProject_UPDATE_DISCONNECTED.rst deleted file mode 100644 index bed4a8944..000000000 --- a/Help/release/dev/ExternalProject_UPDATE_DISCONNECTED.rst +++ /dev/null @@ -1,6 +0,0 @@ -ExternalProject_UPDATE_DISCONNECTED ------------------------------------ - -* The :module:`ExternalProject` module ``ExternalProject_Add`` command - learned an ``UPDATE_DISCONNECTED`` option to avoid automatically - updating the source tree checkout from version control. diff --git a/Help/release/dev/ExternalProject_independent-step-targets.rst b/Help/release/dev/ExternalProject_independent-step-targets.rst deleted file mode 100644 index 02e8db838..000000000 --- a/Help/release/dev/ExternalProject_independent-step-targets.rst +++ /dev/null @@ -1,6 +0,0 @@ -ExternalProject_independent-step-targets ----------------------------------------- - -* The :module:`ExternalProject` module learned options to create - independent external project step targets that do not depend - on the builtin steps. diff --git a/Help/release/dev/FindCUDA-cusolver.rst b/Help/release/dev/FindCUDA-cusolver.rst deleted file mode 100644 index 7a61e784d..000000000 --- a/Help/release/dev/FindCUDA-cusolver.rst +++ /dev/null @@ -1,5 +0,0 @@ -FindCUDA-cusolver ------------------ - -* The :module:`FindCUDA` module learned about the ``cusolver`` - library in CUDA 7.0. diff --git a/Help/release/dev/FindGit-local-Github.rst b/Help/release/dev/FindGit-local-Github.rst deleted file mode 100644 index 3523e8679..000000000 --- a/Help/release/dev/FindGit-local-Github.rst +++ /dev/null @@ -1,5 +0,0 @@ -FindGit-local-Github --------------------- - -* The :module:`FindGit` module learned to find the ``git`` command-line tool - that comes with GitHub for Windows installed in user home directories. diff --git a/Help/release/dev/FindLATEX-components.rst b/Help/release/dev/FindLATEX-components.rst deleted file mode 100644 index d161c1f82..000000000 --- a/Help/release/dev/FindLATEX-components.rst +++ /dev/null @@ -1,4 +0,0 @@ -FindLATEX-components --------------------- - -* The :module:`FindLATEX` module learned to support components. diff --git a/Help/release/dev/FindOpenGL-no-X11.rst b/Help/release/dev/FindOpenGL-no-X11.rst deleted file mode 100644 index dacf1651b..000000000 --- a/Help/release/dev/FindOpenGL-no-X11.rst +++ /dev/null @@ -1,8 +0,0 @@ -FindOpenGL-no-X11 ------------------ - -* The :module:`FindOpenGL` module no longer explicitly searches - for any dependency on X11 libraries with the :module:`FindX11` - module. Such dependencies should not need to be explicit. - Applications using X11 APIs themselves should find and link - to X11 libraries explicitly. diff --git a/Help/release/dev/FindOpenSSL-separate-libs.rst b/Help/release/dev/FindOpenSSL-separate-libs.rst deleted file mode 100644 index 96e39614e..000000000 --- a/Help/release/dev/FindOpenSSL-separate-libs.rst +++ /dev/null @@ -1,7 +0,0 @@ -FindOpenSSL-separate-libs -------------------------- - -* The :module:`FindOpenSSL` module now reports ``crypto`` and ``ssl`` - libraries separately in ``OPENSSL_CRYPTO_LIBRARY`` and - ``OPENSSL_SSL_LIBRARY``, respectively, to allow applications to - link to one without the other. diff --git a/Help/release/dev/GNU-4.4-compile-features.rst b/Help/release/dev/GNU-4.4-compile-features.rst deleted file mode 100644 index d5c13568d..000000000 --- a/Help/release/dev/GNU-4.4-compile-features.rst +++ /dev/null @@ -1,5 +0,0 @@ -GNU-4.4-compile-features ------------------------- - -* The :manual:`Compile Features ` functionality - is now aware of features supported by GNU 4.4 to 4.6 compilers. diff --git a/Help/release/dev/SolarisStudio-compile-features.rst b/Help/release/dev/SolarisStudio-compile-features.rst deleted file mode 100644 index 83110cd68..000000000 --- a/Help/release/dev/SolarisStudio-compile-features.rst +++ /dev/null @@ -1,5 +0,0 @@ -SolarisStudio-compile-features ------------------------------- - -* The :manual:`Compile Features ` functionality - is now aware of features supported by Oracle SolarisStudio (``SunPro``). diff --git a/Help/release/dev/WCDH-thread_local.rst b/Help/release/dev/WCDH-thread_local.rst deleted file mode 100644 index 44516a78e..000000000 --- a/Help/release/dev/WCDH-thread_local.rst +++ /dev/null @@ -1,7 +0,0 @@ -WriteCompilerDetectionHeader thread_local portability ------------------------------------------------------ - -* The :module:`WriteCompilerDetectionHeader` module learned to - create a define for portability of the cxx_thread_local feature. The define - expands to either the C++11 ``thread_local`` keyword, or a - pre-standardization compiler-specific equivalent, as appropriate. diff --git a/Help/release/dev/WriteCompilerDetectionHeader-multi-file-lang.rst b/Help/release/dev/WriteCompilerDetectionHeader-multi-file-lang.rst deleted file mode 100644 index a8665da8f..000000000 --- a/Help/release/dev/WriteCompilerDetectionHeader-multi-file-lang.rst +++ /dev/null @@ -1,6 +0,0 @@ -WriteCompilerDetectionHeader-multi-file ---------------------------------------- - -* The :module:`WriteCompilerDetectionHeader` module learned to create - multiple output files per compiler and per language, instead of creating - one large file. diff --git a/Help/release/dev/Xcode-clang-compile-features.rst b/Help/release/dev/Xcode-clang-compile-features.rst deleted file mode 100644 index d93475fbe..000000000 --- a/Help/release/dev/Xcode-clang-compile-features.rst +++ /dev/null @@ -1,5 +0,0 @@ -Xcode-clang-compile-features ----------------------------- - -* The :manual:`Compile Features ` functionality - is now aware of features supported by Apple Clang (``AppleClang``). diff --git a/Help/release/dev/add-FindGSL.rst b/Help/release/dev/add-FindGSL.rst deleted file mode 100644 index 47a0a25ce..000000000 --- a/Help/release/dev/add-FindGSL.rst +++ /dev/null @@ -1,5 +0,0 @@ -add-FindGSL ------------ - -* A :module:`FindGSL` module was introduced to find the - GNU Scientific Library. diff --git a/Help/release/dev/add-FindIntl.rst b/Help/release/dev/add-FindIntl.rst deleted file mode 100644 index ac048c95d..000000000 --- a/Help/release/dev/add-FindIntl.rst +++ /dev/null @@ -1,5 +0,0 @@ -add-FindIntl ------------- - -* The :module:`FindIntl` module was added to find the Gettext ``libintl`` - library. diff --git a/Help/release/dev/add-FindJsonCpp.rst b/Help/release/dev/add-FindJsonCpp.rst deleted file mode 100644 index 5d1cb18dc..000000000 --- a/Help/release/dev/add-FindJsonCpp.rst +++ /dev/null @@ -1,5 +0,0 @@ -add-FindJsonCpp ---------------- - -* A :module:`FindJsonCpp` module was introduced to find the - JsonCpp package. diff --git a/Help/release/dev/add-continue-command.rst b/Help/release/dev/add-continue-command.rst deleted file mode 100644 index 4995a8ead..000000000 --- a/Help/release/dev/add-continue-command.rst +++ /dev/null @@ -1,6 +0,0 @@ -add-continue-command --------------------- - -* A new :command:`continue` command was added that can be called inside loop - contexts to end the current iteration and start the next one at the top of - the loop block. diff --git a/Help/release/dev/add-xz-support.rst b/Help/release/dev/add-xz-support.rst deleted file mode 100644 index 9bdf5287c..000000000 --- a/Help/release/dev/add-xz-support.rst +++ /dev/null @@ -1,5 +0,0 @@ -add-xz-support --------------- - -* The :manual:`cmake(1)` ``-E tar`` command now supports creating - ``.xz``-compressed archives with the ``J`` flag. diff --git a/Help/release/dev/add_javascript_coverage_parser.rst b/Help/release/dev/add_javascript_coverage_parser.rst deleted file mode 100644 index 0d068ee4a..000000000 --- a/Help/release/dev/add_javascript_coverage_parser.rst +++ /dev/null @@ -1,4 +0,0 @@ -add_javascript_coverage_parser ------------------------------- - -* The :command:`ctest_coverage` learned to support Javascript coverage. diff --git a/Help/release/dev/break-command-strictness.rst b/Help/release/dev/break-command-strictness.rst deleted file mode 100644 index 0723774ed..000000000 --- a/Help/release/dev/break-command-strictness.rst +++ /dev/null @@ -1,6 +0,0 @@ -break-command-strictness ------------------------- - -* The :command:`break` command now rejects calls outside of a loop - context or that pass arguments to the command. - See policy :policy:`CMP0055`. diff --git a/Help/release/dev/cached-regex-clear-fixed.rst b/Help/release/dev/cached-regex-clear-fixed.rst deleted file mode 100644 index fbf08cca7..000000000 --- a/Help/release/dev/cached-regex-clear-fixed.rst +++ /dev/null @@ -1,5 +0,0 @@ -cached-regex-clear-fixed ------------------------- - -* Add :variable:`CMAKE_MATCH_COUNT` for the number of matches made in the last - regular expression. diff --git a/Help/release/dev/cmake-E-tar-files-from.rst b/Help/release/dev/cmake-E-tar-files-from.rst deleted file mode 100644 index f6087ff87..000000000 --- a/Help/release/dev/cmake-E-tar-files-from.rst +++ /dev/null @@ -1,6 +0,0 @@ -cmake-E-tar-files-from ----------------------- - -* The :manual:`cmake(1)` ``-E tar`` command learned a new - ``--files-from=`` option to specify file names using - lines in a file to overcome command-line length limits. diff --git a/Help/release/dev/cmake-E-tar-mtime.rst b/Help/release/dev/cmake-E-tar-mtime.rst deleted file mode 100644 index 6496577e3..000000000 --- a/Help/release/dev/cmake-E-tar-mtime.rst +++ /dev/null @@ -1,6 +0,0 @@ -cmake-E-tar-mtime ------------------ - -* The :manual:`cmake(1)` ``-E tar`` command learned a new - ``--mtime=`` option to specify the modification time - recorded in tarball entries. diff --git a/Help/release/dev/console-pool.rst b/Help/release/dev/console-pool.rst deleted file mode 100644 index 1d9bdb8e4..000000000 --- a/Help/release/dev/console-pool.rst +++ /dev/null @@ -1,10 +0,0 @@ -console-pool ------------- - -* The :command:`add_custom_command` and :command:`add_custom_target` - commands learned a new ``USES_TERMINAL`` option to request that - the command be given direct access to the terminal if possible. - The :generator:`Ninja` generator will places such commands in the - ``console`` pool. Build targets provided by CMake that are meant - for individual interactive use, such as ``install``, are now - placed in this pool. diff --git a/Help/release/dev/cpack-rpm-component-descriptions.rst b/Help/release/dev/cpack-rpm-component-descriptions.rst deleted file mode 100644 index 769a91285..000000000 --- a/Help/release/dev/cpack-rpm-component-descriptions.rst +++ /dev/null @@ -1,7 +0,0 @@ -cpack-rpm-component-descriptions --------------------------------- - -* The :module:`CPackRPM` module learned options to set per-component - descriptions and summaries. See the - :variable:`CPACK_RPM__PACKAGE_DESCRIPTION` and - :variable:`CPACK_RPM__PACKAGE_SUMMARY` variables. diff --git a/Help/release/dev/cpack-rpm-pre-post-install.rst b/Help/release/dev/cpack-rpm-pre-post-install.rst deleted file mode 100644 index 0909d940e..000000000 --- a/Help/release/dev/cpack-rpm-pre-post-install.rst +++ /dev/null @@ -1,12 +0,0 @@ -cpack-rpm-pre-post-install --------------------------- - -* The :module:`CPackRPM` module learned options to specify - requirements for pre- and post-install scripts. See the - :variable:`CPACK_RPM_PACKAGE_REQUIRES_PRE` and - :variable:`CPACK_RPM_PACKAGE_REQUIRES_POST` variables. - -* The :module:`CPackRPM` module learned options to specify - requirements for pre- and post-uninstall scripts. See the - :variable:`CPACK_RPM_PACKAGE_REQUIRES_PREUN` and - :variable:`CPACK_RPM_PACKAGE_REQUIRES_POSTUN` variables. diff --git a/Help/release/dev/ctest-delphi-coverage.rst b/Help/release/dev/ctest-delphi-coverage.rst deleted file mode 100644 index efa97c924..000000000 --- a/Help/release/dev/ctest-delphi-coverage.rst +++ /dev/null @@ -1,4 +0,0 @@ -ctest-delphi-coverage ---------------------- - -* The :command:`ctest_coverage` learned to support Delphi coverage. diff --git a/Help/release/dev/curl-darwinssl.rst b/Help/release/dev/curl-darwinssl.rst deleted file mode 100644 index 3571bd1b3..000000000 --- a/Help/release/dev/curl-darwinssl.rst +++ /dev/null @@ -1,9 +0,0 @@ -curl-darwinssl --------------- - -* On OS X, commands supporting network communication, such as - :command:`file(DOWNLOAD)`, :command:`file(UPLOAD)`, and - :command:`ctest_submit`, now support SSL/TLS even when CMake - is not built against OpenSSL. The OS X native SSL/TLS - implementation is used by default. OS-configured certificate - authorities will be trusted automatically. diff --git a/Help/release/dev/curl-default-cainfo.rst b/Help/release/dev/curl-default-cainfo.rst deleted file mode 100644 index ed45d36e3..000000000 --- a/Help/release/dev/curl-default-cainfo.rst +++ /dev/null @@ -1,8 +0,0 @@ -curl-default-cainfo -------------------- - -* When CMake is built with OpenSSL on systems other than Windows - and OS X, commands supporting network communication via ``https``, - such as :command:`file(DOWNLOAD)`, :command:`file(UPLOAD)`, and - :command:`ctest_submit`, now search for OS-configured certificate - authorities in a few ``/etc`` paths to be trusted automatically. diff --git a/Help/release/dev/curl-winssl.rst b/Help/release/dev/curl-winssl.rst deleted file mode 100644 index 9a28f4fca..000000000 --- a/Help/release/dev/curl-winssl.rst +++ /dev/null @@ -1,9 +0,0 @@ -curl-winssl ------------ - -* On Windows, commands supporting network communication, such as - :command:`file(DOWNLOAD)`, :command:`file(UPLOAD)`, and - :command:`ctest_submit`, now support SSL/TLS even when CMake - is not built against OpenSSL. The Windows native SSL/TLS - implementation is used by default. OS-configured certificate - authorities will be trusted automatically. diff --git a/Help/release/dev/custom-command-byproducts.rst b/Help/release/dev/custom-command-byproducts.rst deleted file mode 100644 index dc85fdbbc..000000000 --- a/Help/release/dev/custom-command-byproducts.rst +++ /dev/null @@ -1,7 +0,0 @@ -custom-command-byproducts -------------------------- - -* The :command:`add_custom_command` and :command:`add_custom_target` - commands learned a new ``BYPRODUCTS`` option to specify files - produced as side effects of the custom commands. These are not - outputs because they do not always have to be newer than inputs. diff --git a/Help/release/dev/feature-record-msvc.rst b/Help/release/dev/feature-record-msvc.rst deleted file mode 100644 index a8c9fd164..000000000 --- a/Help/release/dev/feature-record-msvc.rst +++ /dev/null @@ -1,5 +0,0 @@ -feature-record-msvc -------------------- - -* The :manual:`Compile Features ` functionality - is now aware of features supported by Microsoft Visual Studio (``MSVC``). diff --git a/Help/release/dev/file-LOCK-command.rst b/Help/release/dev/file-LOCK-command.rst deleted file mode 100644 index 4b11e9e6e..000000000 --- a/Help/release/dev/file-LOCK-command.rst +++ /dev/null @@ -1,5 +0,0 @@ -file-LOCK-command ------------------ - -* The :command:`file(LOCK)` subcommand was created to allow CMake - processes to synchronize through file and directory locks. diff --git a/Help/release/dev/file-strings-utf-16.rst b/Help/release/dev/file-strings-utf-16.rst deleted file mode 100644 index f40b63eb9..000000000 --- a/Help/release/dev/file-strings-utf-16.rst +++ /dev/null @@ -1,5 +0,0 @@ -file-strings-utf-16 -------------------- - -* The :command:`file(STRINGS)` now supports UTF-16LE, UTF-16BE, - UTF-32LE, UTF-32BE as ``ENCODING`` options. diff --git a/Help/release/dev/find-msmpi.rst b/Help/release/dev/find-msmpi.rst deleted file mode 100644 index 6ece5c8de..000000000 --- a/Help/release/dev/find-msmpi.rst +++ /dev/null @@ -1,4 +0,0 @@ -find-msmpi ----------- - -* The :module:`FindMPI` module learned to find MS-MPI on Windows. diff --git a/Help/release/dev/install-EXPORT-absolute-prefix.rst b/Help/release/dev/install-EXPORT-absolute-prefix.rst deleted file mode 100644 index 1b2a01c18..000000000 --- a/Help/release/dev/install-EXPORT-absolute-prefix.rst +++ /dev/null @@ -1,9 +0,0 @@ -install-EXPORT-absolute-prefix ------------------------------- - -* The :command:`install(EXPORT)` command now works with an absolute - ``DESTINATION`` even if targets in the export set are installed - with a destination or usage requirements specified relative to the - install prefix. The value of the :variable:`CMAKE_INSTALL_PREFIX` - variable is hard-coded into the installed export file as the base - for relative references. diff --git a/Help/release/dev/record-GNU-5-features.rst b/Help/release/dev/record-GNU-5-features.rst deleted file mode 100644 index 0da9e759d..000000000 --- a/Help/release/dev/record-GNU-5-features.rst +++ /dev/null @@ -1,5 +0,0 @@ -record-GNU-5-features ---------------------- - -* The :manual:`Compile Features ` functionality - is now aware of features supported by GNU compiler version 5.0. diff --git a/Help/release/dev/rpm_multi_prefix.rst b/Help/release/dev/rpm_multi_prefix.rst deleted file mode 100644 index 032959273..000000000 --- a/Help/release/dev/rpm_multi_prefix.rst +++ /dev/null @@ -1,11 +0,0 @@ -rpm_multi_prefix ----------------- - -* The :module:`CPackRPM` module learned a new - :variable:`CPACK_RPM__PACKAGE_PREFIX` variable to - specify a component-specific value to use instead of - :variable:`CPACK_PACKAGING_INSTALL_PREFIX`. - -* The :module:`CPackRPM` module learned a new - :variable:`CPACK_RPM_RELOCATION_PATHS` variable to - specify multiple relocation prefixes for a single rpm package. diff --git a/Help/release/dev/try-run-link-libraries.rst b/Help/release/dev/try-run-link-libraries.rst deleted file mode 100644 index 4f20cbd87..000000000 --- a/Help/release/dev/try-run-link-libraries.rst +++ /dev/null @@ -1,5 +0,0 @@ -try-run-link-libraries ----------------------- - -* The :command:`try_run` command learned to honor the ``LINK_LIBRARIES`` - option just as :command:`try_compile` already does. diff --git a/Help/release/dev/try_compile-link-flags.rst b/Help/release/dev/try_compile-link-flags.rst deleted file mode 100644 index d995e0b92..000000000 --- a/Help/release/dev/try_compile-link-flags.rst +++ /dev/null @@ -1,6 +0,0 @@ -try_compile-link-flags ----------------------- - -* The :command:`try_compile` command source file signature now honors - link flags (e.g. :variable:`CMAKE_EXE_LINKER_FLAGS`) in the generated - test project. See policy :policy:`CMP0056`. diff --git a/Help/release/dev/unsupported-compilers.rst b/Help/release/dev/unsupported-compilers.rst deleted file mode 100644 index 1f3e8c16a..000000000 --- a/Help/release/dev/unsupported-compilers.rst +++ /dev/null @@ -1,22 +0,0 @@ -unsupported-compilers ---------------------- - -* The implementation of CMake relies on some C++ compiler features which are - not supported by some older compilers. As a result, those old compilers - can no longer be used to build CMake itself. CMake continues to be able to - generate Makefiles and project files for users of those old compilers - however. The compilers known to no longer be capable of building CMake - are: - - * MSVC 6 and 7.0 - superceded by VisualStudio 7.1 and newer compilers. - * GCC 2.95 - superceded by GCC 3 and newer compilers. - * Borland compilers - superceded by other Windows compilers. - * Compaq compilers - superceded by other compilers. - * Comeau compilers - superceded by other compilers. - * SGI compilers - IRIX was dropped as a host platform. - - When building using SolarisStudio 12, the default ``libCStd`` standard - library is not sufficient to build CMake. The SolarisStudio distribution - supports compiler options to use ``STLPort4`` or ``libstdc++``. An - appropriate option to select the standard library is now added - automatically when building CMake with SolarisStudio compilers. diff --git a/Help/release/dev/vs-nsight-tegra-min-api.rst b/Help/release/dev/vs-nsight-tegra-min-api.rst deleted file mode 100644 index f8fa056d8..000000000 --- a/Help/release/dev/vs-nsight-tegra-min-api.rst +++ /dev/null @@ -1,5 +0,0 @@ -vs-nsight-tegra-min-api ------------------------ - -* A :prop_tgt:`ANDROID_API_MIN` target property was introduced to - specify the minimum version to be targeted by the toolchain. diff --git a/Help/release/dev/vs-shader-flags.rst b/Help/release/dev/vs-shader-flags.rst deleted file mode 100644 index 0d3f6cc3f..000000000 --- a/Help/release/dev/vs-shader-flags.rst +++ /dev/null @@ -1,5 +0,0 @@ -vs-shader-flags ---------------- - -* A :prop_sf:`VS_SHADER_FLAGS` source file property was added to specify - additional shader flags to ``.hlsl`` files, for the Visual Studio generators. diff --git a/Help/release/dev/windows-utf-8.rst b/Help/release/dev/windows-utf-8.rst deleted file mode 100644 index 64cd61638..000000000 --- a/Help/release/dev/windows-utf-8.rst +++ /dev/null @@ -1,22 +0,0 @@ -windows-utf-8 -------------- - -* On Windows, CMake learned to support international characters. - This allows use of characters from multiple (spoken) languages - in CMake code, paths to source files, configured files such as - ``.h.in`` files, and other files read and written by CMake. - Because CMake interoperates with many other tools, there may - still be some limitations when using certain international - characters. - - Files written in the :manual:`cmake-language(7)`, such as - ``CMakeLists.txt`` or ``*.cmake`` files, are expected to be - encoded as UTF-8. If files are already ASCII, they will be - compatible. If files were in a different encoding, including - Latin 1, they will need to be converted. - - The Visual Studio generators now write solution and project - files in UTF-8 instead of Windows-1252. Windows-1252 supported - Latin 1 languages such as those found in North and South America - and Western Europe. With UTF-8, additional languages are now - supported. diff --git a/Help/release/dev/xcode-revise-make-program.rst b/Help/release/dev/xcode-revise-make-program.rst deleted file mode 100644 index f50cf44a7..000000000 --- a/Help/release/dev/xcode-revise-make-program.rst +++ /dev/null @@ -1,6 +0,0 @@ -xcode-revise-make-program -------------------------- - -* The :generator:`Xcode` generator no longer requires a value for - the :variable:`CMAKE_MAKE_PROGRAM` variable to be located up front. - It now locates ``xcodebuild`` when needed at build time. diff --git a/Help/release/index.rst b/Help/release/index.rst index abc19b8e8..990accfe8 100644 --- a/Help/release/index.rst +++ b/Help/release/index.rst @@ -13,5 +13,6 @@ Releases .. toctree:: :maxdepth: 1 + 3.2.0 <3.2.0> 3.1.0 <3.1.0> 3.0.0 <3.0.0>