From 3a4381b6605f593abc9d9364f5ffa3fc9a209854 Mon Sep 17 00:00:00 2001 From: Brad King Date: Wed, 4 Feb 2015 18:58:05 -0500 Subject: [PATCH 1/5] Help: Add link target to cmake-language.7 encoding section --- Help/manual/cmake-language.7.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Help/manual/cmake-language.7.rst b/Help/manual/cmake-language.7.rst index 5ec5858ff..3e0297cf6 100644 --- a/Help/manual/cmake-language.7.rst +++ b/Help/manual/cmake-language.7.rst @@ -57,6 +57,8 @@ variable. Syntax ====== +.. _`CMake Language Encoding`: + Encoding -------- From e08a78dc2cf04682010a3d4496b4c454271f194a Mon Sep 17 00:00:00 2001 From: Brad King Date: Wed, 4 Feb 2015 13:12:12 -0500 Subject: [PATCH 2/5] Help: Consolidate 3.2 release notes Move all development release notes into a new version-specific document: tail -q -n +3 Help/release/dev/* > Help/release/3.2.0.rst git rm -- Help/release/dev/* except the sample topic: git checkout HEAD -- Help/release/dev/0-sample-topic.rst Reference the new document from the release notes index document. Add a title and intro sentence to the new document by hand. --- Help/release/3.2.0.rst | 249 ++++++++++++++++++ .../dev/Apple-GNU-compiler-features.rst | 5 - Help/release/dev/Apple-compiler-selection.rst | 8 - .../CTestCoverageCollectGCOV-refinements.rst | 6 - .../dev/ExternalData-custom-download.rst | 7 - ...ternalProject_CMAKE_CACHE_DEFAULT_ARGS.rst | 6 - ...ExternalProject_TEST_EXCLUDE_FROM_MAIN.rst | 6 - .../ExternalProject_UPDATE_DISCONNECTED.rst | 6 - ...ternalProject_independent-step-targets.rst | 6 - Help/release/dev/FindCUDA-cusolver.rst | 5 - Help/release/dev/FindGit-local-Github.rst | 5 - Help/release/dev/FindLATEX-components.rst | 4 - Help/release/dev/FindOpenGL-no-X11.rst | 8 - .../release/dev/FindOpenSSL-separate-libs.rst | 7 - Help/release/dev/GNU-4.4-compile-features.rst | 5 - .../dev/SolarisStudio-compile-features.rst | 5 - Help/release/dev/WCDH-thread_local.rst | 7 - ...ompilerDetectionHeader-multi-file-lang.rst | 6 - .../dev/Xcode-clang-compile-features.rst | 5 - Help/release/dev/add-FindGSL.rst | 5 - Help/release/dev/add-FindIntl.rst | 5 - Help/release/dev/add-FindJsonCpp.rst | 5 - Help/release/dev/add-continue-command.rst | 6 - Help/release/dev/add-xz-support.rst | 5 - .../dev/add_javascript_coverage_parser.rst | 4 - Help/release/dev/break-command-strictness.rst | 6 - Help/release/dev/cached-regex-clear-fixed.rst | 5 - Help/release/dev/cmake-E-tar-files-from.rst | 6 - Help/release/dev/cmake-E-tar-mtime.rst | 6 - Help/release/dev/console-pool.rst | 10 - .../dev/cpack-rpm-component-descriptions.rst | 7 - .../dev/cpack-rpm-pre-post-install.rst | 12 - Help/release/dev/ctest-delphi-coverage.rst | 4 - Help/release/dev/curl-darwinssl.rst | 9 - Help/release/dev/curl-default-cainfo.rst | 8 - Help/release/dev/curl-winssl.rst | 9 - .../release/dev/custom-command-byproducts.rst | 7 - Help/release/dev/feature-record-msvc.rst | 5 - Help/release/dev/file-LOCK-command.rst | 5 - Help/release/dev/file-strings-utf-16.rst | 5 - Help/release/dev/find-msmpi.rst | 4 - .../dev/install-EXPORT-absolute-prefix.rst | 9 - Help/release/dev/record-GNU-5-features.rst | 5 - Help/release/dev/rpm_multi_prefix.rst | 11 - Help/release/dev/try-run-link-libraries.rst | 5 - Help/release/dev/try_compile-link-flags.rst | 6 - Help/release/dev/unsupported-compilers.rst | 22 -- Help/release/dev/vs-nsight-tegra-min-api.rst | 5 - Help/release/dev/vs-shader-flags.rst | 5 - Help/release/dev/windows-utf-8.rst | 22 -- .../release/dev/xcode-revise-make-program.rst | 6 - Help/release/index.rst | 1 + 52 files changed, 250 insertions(+), 341 deletions(-) create mode 100644 Help/release/3.2.0.rst delete mode 100644 Help/release/dev/Apple-GNU-compiler-features.rst delete mode 100644 Help/release/dev/Apple-compiler-selection.rst delete mode 100644 Help/release/dev/CTestCoverageCollectGCOV-refinements.rst delete mode 100644 Help/release/dev/ExternalData-custom-download.rst delete mode 100644 Help/release/dev/ExternalProject_CMAKE_CACHE_DEFAULT_ARGS.rst delete mode 100644 Help/release/dev/ExternalProject_TEST_EXCLUDE_FROM_MAIN.rst delete mode 100644 Help/release/dev/ExternalProject_UPDATE_DISCONNECTED.rst delete mode 100644 Help/release/dev/ExternalProject_independent-step-targets.rst delete mode 100644 Help/release/dev/FindCUDA-cusolver.rst delete mode 100644 Help/release/dev/FindGit-local-Github.rst delete mode 100644 Help/release/dev/FindLATEX-components.rst delete mode 100644 Help/release/dev/FindOpenGL-no-X11.rst delete mode 100644 Help/release/dev/FindOpenSSL-separate-libs.rst delete mode 100644 Help/release/dev/GNU-4.4-compile-features.rst delete mode 100644 Help/release/dev/SolarisStudio-compile-features.rst delete mode 100644 Help/release/dev/WCDH-thread_local.rst delete mode 100644 Help/release/dev/WriteCompilerDetectionHeader-multi-file-lang.rst delete mode 100644 Help/release/dev/Xcode-clang-compile-features.rst delete mode 100644 Help/release/dev/add-FindGSL.rst delete mode 100644 Help/release/dev/add-FindIntl.rst delete mode 100644 Help/release/dev/add-FindJsonCpp.rst delete mode 100644 Help/release/dev/add-continue-command.rst delete mode 100644 Help/release/dev/add-xz-support.rst delete mode 100644 Help/release/dev/add_javascript_coverage_parser.rst delete mode 100644 Help/release/dev/break-command-strictness.rst delete mode 100644 Help/release/dev/cached-regex-clear-fixed.rst delete mode 100644 Help/release/dev/cmake-E-tar-files-from.rst delete mode 100644 Help/release/dev/cmake-E-tar-mtime.rst delete mode 100644 Help/release/dev/console-pool.rst delete mode 100644 Help/release/dev/cpack-rpm-component-descriptions.rst delete mode 100644 Help/release/dev/cpack-rpm-pre-post-install.rst delete mode 100644 Help/release/dev/ctest-delphi-coverage.rst delete mode 100644 Help/release/dev/curl-darwinssl.rst delete mode 100644 Help/release/dev/curl-default-cainfo.rst delete mode 100644 Help/release/dev/curl-winssl.rst delete mode 100644 Help/release/dev/custom-command-byproducts.rst delete mode 100644 Help/release/dev/feature-record-msvc.rst delete mode 100644 Help/release/dev/file-LOCK-command.rst delete mode 100644 Help/release/dev/file-strings-utf-16.rst delete mode 100644 Help/release/dev/find-msmpi.rst delete mode 100644 Help/release/dev/install-EXPORT-absolute-prefix.rst delete mode 100644 Help/release/dev/record-GNU-5-features.rst delete mode 100644 Help/release/dev/rpm_multi_prefix.rst delete mode 100644 Help/release/dev/try-run-link-libraries.rst delete mode 100644 Help/release/dev/try_compile-link-flags.rst delete mode 100644 Help/release/dev/unsupported-compilers.rst delete mode 100644 Help/release/dev/vs-nsight-tegra-min-api.rst delete mode 100644 Help/release/dev/vs-shader-flags.rst delete mode 100644 Help/release/dev/windows-utf-8.rst delete mode 100644 Help/release/dev/xcode-revise-make-program.rst 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> From 0f580e8e67fd307c21924dd732570937a0db25e2 Mon Sep 17 00:00:00 2001 From: Brad King Date: Wed, 4 Feb 2015 13:33:49 -0500 Subject: [PATCH 3/5] Help: Organize and revise 3.2 release notes Add section headers similar to the 3.1 release notes and move each individual bullet into an appropriate section. Revise and consolidate some bullets covering related areas. Co-Author: Stephen Kelly --- Help/release/3.2.0.rst | 364 ++++++++++++++++++++++------------------- 1 file changed, 192 insertions(+), 172 deletions(-) diff --git a/Help/release/3.2.0.rst b/Help/release/3.2.0.rst index 142d40844..c6a8adde1 100644 --- a/Help/release/3.2.0.rst +++ b/Help/release/3.2.0.rst @@ -7,125 +7,41 @@ CMake 3.2.0 Release Notes 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. +New Features +============ -* A :module:`FindGSL` module was introduced to find the - GNU Scientific Library. +Syntax +------ -* The :module:`FindIntl` module was added to find the Gettext ``libintl`` - library. +* CMake learned to support unicode characters + :ref:`encoded as UTF-8 ` + on Windows. This was already supported on platforms whose + system APIs accept UTF-8 encoded strings. + Unicode characters may now be used in CMake code, paths to + source files, configured files such as ``.h.in`` files, and + other files read and written by CMake. Note that because CMake + interoperates with many other tools, there may still be some + limitations when using certain unicode characters. -* 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. +Commands +-------- * 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 :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`` :prop_gbl:`pool `. Build targets provided by CMake + that are meant for individual interactive use, such as ``install``, are now + placed in this pool. -* 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``). +* 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. * The :command:`file(LOCK)` subcommand was created to allow CMake processes to synchronize through file and directory locks. @@ -133,12 +49,77 @@ Changes made since CMake 3.1.0 include the following. * The :command:`file(STRINGS)` now supports UTF-16LE, UTF-16BE, UTF-32LE, UTF-32BE as ``ENCODING`` options. +* The :command:`install(EXPORT)` command now works with an absolute + ``DESTINATION`` even if targets in the export set are installed + with a destination or :ref:`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 :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. + +Variables +--------- + +* The :variable:`CMAKE_MATCH_COUNT` variable was introduced to record the + number of matches made in the last regular expression matched in an + :command:`if` command or a :command:`string` command. + +Properties +---------- + +* An :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. + +Modules +------- + +* 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 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 new ``CMAKE_CACHE_DEFAULT_ARGS`` option to + initialize cache values in the external project without setting + them on future builds. + +* The :module:`ExternalProject` module :command:`ExternalProject_Add` + command learned a new ``TEST_EXCLUDE_FROM_MAIN`` option to exclude + tests from the main build. + +* The :module:`ExternalProject` module :command:`ExternalProject_Add` + command learned a new ``UPDATE_DISCONNECTED`` option to avoid + automatically updating the source tree checkout from version control. + * 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. +* A :module:`FindGSL` module was introduced to find the + GNU Scientific Library. + +* A :module:`FindIntl` module was introduced to find the + Gettext ``libintl`` library. + +* A :module:`FindJsonCpp` module was introduced to find the + JsonCpp package. + * The :module:`FindLATEX` module learned to support components. * The :module:`FindMPI` module learned to find MS-MPI on Windows. @@ -154,18 +135,43 @@ Changes made since CMake 3.1.0 include the following. ``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 :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. -* 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 :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 GNU compiler version 5.0. +CTest +----- + +* The :command:`ctest_coverage` command learned to support Delphi coverage. + +* The :command:`ctest_coverage` command learned to support Javascript coverage. + +* The :module:`CTestCoverageCollectGCOV` module was introduced as an + alternative to the :command:`ctest_coverage` command for collecting + ``gcov`` results for submission to CDash. + +CPack +----- + +* 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:`CPackRPM` module learned a new :variable:`CPACK_RPM__PACKAGE_PREFIX` variable to @@ -176,74 +182,88 @@ Changes made since CMake 3.1.0 include the following. :variable:`CPACK_RPM_RELOCATION_PATHS` variable to specify multiple relocation prefixes for a single rpm package. +Other +----- + +* The :manual:`cmake(1)` ``-E tar`` command now supports creating + ``.xz``-compressed archives with the ``J`` flag. + +* 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 :manual:`Compile Features ` functionality - is now aware of features supported by Oracle SolarisStudio (``SunPro``). + is now aware of features supported by more compilers, including: -* 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`. + * Apple Clang (``AppleClang``) for Xcode versions 4.4 though 6.1. + * GNU compiler versions 4.4 through 5.0 on UNIX and Apple (``GNU``). + * Microsoft Visual Studio (``MSVC``) for versions 2010 through 2015. + * Oracle SolarisStudio (``SunPro``) version 12.4. -* The :command:`try_run` command learned to honor the ``LINK_LIBRARIES`` - option just as :command:`try_compile` already does. +New Diagnostics +=============== -* 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: +* The :command:`break` command now rejects calls outside of a loop + context or that pass arguments to the command. + See policy :policy:`CMP0055`. - * 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. +Deprecated and Removed Features +=============================== - 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 +* Files written in the :manual:`cmake-language(7)`, such as + ``CMakeLists.txt`` or ``*.cmake`` files, are now 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 +* The implementation of CMake now 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. Compilers known to no longer be capable of building CMake are: + + * Visual Studio 6 and 7.0 -- superseded by VisualStudio 7.1 and newer. + * GCC 2.95 -- superseded by GCC 3 and newer compilers. + * Borland compilers -- superseded by other Windows compilers. + * Compaq compilers -- superseded by other compilers. + * SGI compilers -- IRIX was dropped as a host platform. + +Other Changes +============= + +* On Windows and OS X, commands supporting network communication + via ``https``, 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 or OS X native SSL/TLS implementation is used by default. + OS-configured certificate authorities will be trusted automatically. + + On other platforms, when CMake is built with OpenSSL, these + commands now search for OS-configured certificate authorities + in a few ``/etc`` paths to be trusted automatically. + +* 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 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. + +* When building CMake itself 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. From 0f38d9c2ad53631185da9aa7d0f50b5816272a55 Mon Sep 17 00:00:00 2001 From: Stephen Kelly Date: Wed, 4 Feb 2015 21:44:11 +0100 Subject: [PATCH 4/5] Help: Add 3.2 release notes for file(GENERATE) features --- Help/release/3.2.0.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/Help/release/3.2.0.rst b/Help/release/3.2.0.rst index c6a8adde1..d1be27eab 100644 --- a/Help/release/3.2.0.rst +++ b/Help/release/3.2.0.rst @@ -63,6 +63,13 @@ Commands * The :command:`try_run` command learned to honor the ``LINK_LIBRARIES`` option just as :command:`try_compile` already does. +* The :command:`file(GENERATE)` command now generates the output file with + the same permissions as the input file if set. + +* The :command:`file(GENERATE)` command can now generate files which are + used as source files for buildsystem targets. Generated files + automatically get their :prop_sf:`GENERATED` property set to ``TRUE``. + Variables --------- From d81bbc3fcee81bf0538c139637e0344c9fcad40a Mon Sep 17 00:00:00 2001 From: Stephen Kelly Date: Wed, 4 Feb 2015 21:45:25 +0100 Subject: [PATCH 5/5] Help: Add 3.2 release note for AUTORCC dependency tracking --- Help/release/3.2.0.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Help/release/3.2.0.rst b/Help/release/3.2.0.rst index d1be27eab..5b1216352 100644 --- a/Help/release/3.2.0.rst +++ b/Help/release/3.2.0.rst @@ -211,6 +211,10 @@ Other * Microsoft Visual Studio (``MSVC``) for versions 2010 through 2015. * Oracle SolarisStudio (``SunPro``) version 12.4. +* The :ref:`Qt AUTORCC` feature now tracks files listed in ``.qrc`` files + as dependencies. If an input file to the ``rcc`` tool is changed, the tool + is automatically re-run. + New Diagnostics ===============