From c5df7483f50876de5f5e50280ff6557e4ba39d15 Mon Sep 17 00:00:00 2001 From: Brad King Date: Wed, 1 Jun 2016 09:10:37 -0400 Subject: Help: Consolidate 3.6 release notes Move all development release notes into a new version-specific document: tail -q -n +3 Help/release/dev/* > Help/release/3.6.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.6.rst | 276 +++++++++++++++++++++ ...akePushCheckState-CMAKE_EXTRA_INCLUDE_FILES.rst | 5 - .../dev/ExternalProject-git-clone-shallow.rst | 5 - .../dev/ExternalProject-git-recursive-init.rst | 7 - Help/release/dev/FindCUDA-cublas_device.rst | 4 - Help/release/dev/FindGTest-depends.rst | 6 - Help/release/dev/FindPkgConfig-targets.rst | 5 - Help/release/dev/FindProtobuf-variable-case.rst | 7 - Help/release/dev/FindProtobuf-version.rst | 6 - ...InstallRequiredSystemLibraries-Windows-UCRT.rst | 6 - Help/release/dev/add-FindLTTngUST.rst | 5 - Help/release/dev/add-bruce-c.rst | 4 - Help/release/dev/automoc-diagnostics.rst | 6 - Help/release/dev/clang-tidy.rst | 7 - Help/release/dev/cmake-depend-in-project-only.rst | 6 - Help/release/dev/cmake-host-solaris.rst | 5 - .../release/dev/cpack-deb-autodep-ORIGIN-RPATH.rst | 6 - Help/release/dev/cpack-deb-imporvements.rst | 32 --- Help/release/dev/cpack-dmg-no-app-link.rst | 6 - Help/release/dev/cpack-ifw-updates.rst | 6 - .../dev/cpack-rpm-adding-dist-to-release-tag.rst | 7 - .../dev/cpack-rpm-default-user-and-group.rst | 9 - .../dev/cpack-rpm-different-package-names.rst | 9 - .../dev/cpack-rpm-external-symlink-handling.rst | 5 - .../dev/cpack-rpm-upper-cased-components.rst | 15 -- Help/release/dev/ctest-run-submodule-sync.rst | 9 - .../dev/custom-command-CROSSCOMPILING_EMULATOR.rst | 6 - Help/release/dev/cygwin-clang.rst | 4 - Help/release/dev/deprecate-CMakeForceCompiler.rst | 5 - Help/release/dev/doc-standard-libs.rst | 6 - Help/release/dev/enable-ssl-automatically.rst | 8 - Help/release/dev/ep-tls-verify-git.rst | 5 - Help/release/dev/error-multiple-targets.rst | 6 - Help/release/dev/external-project-no-extract.rst | 6 - Help/release/dev/find-blas-lapack-OpenBLAS.rst | 5 - .../find-command-prefix-from-PATH-windows-only.rst | 12 - .../dev/fix-bison-flex-command-escaping.rst | 12 - Help/release/dev/install-EXCLUDE_FROM_ALL.rst | 5 - Help/release/dev/intel-compiler-features.rst | 6 - Help/release/dev/list-FILTER-command.rst | 5 - Help/release/dev/ninja-depfile-system-headers.rst | 5 - Help/release/dev/ninja-directory-targets.rst | 7 - Help/release/dev/ninja-output-path-prefix.rst | 6 - Help/release/dev/remove-vs6-generator.rst | 4 - Help/release/dev/remove-vs7.0-generator.rst | 5 - Help/release/dev/standard-include-directories.rst | 6 - Help/release/dev/timeout_after_match.rst | 6 - Help/release/dev/try_compile-config-flags.rst | 7 - Help/release/dev/try_compile-custom-variables.rst | 7 - Help/release/dev/try_compile-target-type.rst | 8 - Help/release/dev/unix-timestamps.rst | 6 - Help/release/dev/update-osx-release.rst | 5 - Help/release/dev/vs-clang-cl.rst | 5 - Help/release/dev/vs-remote-directory.rst | 7 - Help/release/dev/vs-startup-project.rst | 6 - Help/release/dev/vs-vcxproj-ConfigurationType.rst | 6 - Help/release/dev/vs71-deprecate.rst | 5 - Help/release/index.rst | 1 + 58 files changed, 277 insertions(+), 380 deletions(-) create mode 100644 Help/release/3.6.rst delete mode 100644 Help/release/dev/CMakePushCheckState-CMAKE_EXTRA_INCLUDE_FILES.rst delete mode 100644 Help/release/dev/ExternalProject-git-clone-shallow.rst delete mode 100644 Help/release/dev/ExternalProject-git-recursive-init.rst delete mode 100644 Help/release/dev/FindCUDA-cublas_device.rst delete mode 100644 Help/release/dev/FindGTest-depends.rst delete mode 100644 Help/release/dev/FindPkgConfig-targets.rst delete mode 100644 Help/release/dev/FindProtobuf-variable-case.rst delete mode 100644 Help/release/dev/FindProtobuf-version.rst delete mode 100644 Help/release/dev/InstallRequiredSystemLibraries-Windows-UCRT.rst delete mode 100644 Help/release/dev/add-FindLTTngUST.rst delete mode 100644 Help/release/dev/add-bruce-c.rst delete mode 100644 Help/release/dev/automoc-diagnostics.rst delete mode 100644 Help/release/dev/clang-tidy.rst delete mode 100644 Help/release/dev/cmake-depend-in-project-only.rst delete mode 100644 Help/release/dev/cmake-host-solaris.rst delete mode 100644 Help/release/dev/cpack-deb-autodep-ORIGIN-RPATH.rst delete mode 100644 Help/release/dev/cpack-deb-imporvements.rst delete mode 100644 Help/release/dev/cpack-dmg-no-app-link.rst delete mode 100644 Help/release/dev/cpack-ifw-updates.rst delete mode 100644 Help/release/dev/cpack-rpm-adding-dist-to-release-tag.rst delete mode 100644 Help/release/dev/cpack-rpm-default-user-and-group.rst delete mode 100644 Help/release/dev/cpack-rpm-different-package-names.rst delete mode 100644 Help/release/dev/cpack-rpm-external-symlink-handling.rst delete mode 100644 Help/release/dev/cpack-rpm-upper-cased-components.rst delete mode 100644 Help/release/dev/ctest-run-submodule-sync.rst delete mode 100644 Help/release/dev/custom-command-CROSSCOMPILING_EMULATOR.rst delete mode 100644 Help/release/dev/cygwin-clang.rst delete mode 100644 Help/release/dev/deprecate-CMakeForceCompiler.rst delete mode 100644 Help/release/dev/doc-standard-libs.rst delete mode 100644 Help/release/dev/enable-ssl-automatically.rst delete mode 100644 Help/release/dev/ep-tls-verify-git.rst delete mode 100644 Help/release/dev/error-multiple-targets.rst delete mode 100644 Help/release/dev/external-project-no-extract.rst delete mode 100644 Help/release/dev/find-blas-lapack-OpenBLAS.rst delete mode 100644 Help/release/dev/find-command-prefix-from-PATH-windows-only.rst delete mode 100644 Help/release/dev/fix-bison-flex-command-escaping.rst delete mode 100644 Help/release/dev/install-EXCLUDE_FROM_ALL.rst delete mode 100644 Help/release/dev/intel-compiler-features.rst delete mode 100644 Help/release/dev/list-FILTER-command.rst delete mode 100644 Help/release/dev/ninja-depfile-system-headers.rst delete mode 100644 Help/release/dev/ninja-directory-targets.rst delete mode 100644 Help/release/dev/ninja-output-path-prefix.rst delete mode 100644 Help/release/dev/remove-vs6-generator.rst delete mode 100644 Help/release/dev/remove-vs7.0-generator.rst delete mode 100644 Help/release/dev/standard-include-directories.rst delete mode 100644 Help/release/dev/timeout_after_match.rst delete mode 100644 Help/release/dev/try_compile-config-flags.rst delete mode 100644 Help/release/dev/try_compile-custom-variables.rst delete mode 100644 Help/release/dev/try_compile-target-type.rst delete mode 100644 Help/release/dev/unix-timestamps.rst delete mode 100644 Help/release/dev/update-osx-release.rst delete mode 100644 Help/release/dev/vs-clang-cl.rst delete mode 100644 Help/release/dev/vs-remote-directory.rst delete mode 100644 Help/release/dev/vs-startup-project.rst delete mode 100644 Help/release/dev/vs-vcxproj-ConfigurationType.rst delete mode 100644 Help/release/dev/vs71-deprecate.rst diff --git a/Help/release/3.6.rst b/Help/release/3.6.rst new file mode 100644 index 0000000..7c3764a --- /dev/null +++ b/Help/release/3.6.rst @@ -0,0 +1,276 @@ +CMake 3.6 Release Notes +*********************** + +.. only:: html + + .. contents:: + +Changes made since CMake 3.5 include the following. + +* Support was added for the Bruce C Compiler with compiler id ``Bruce``. + +* The :module:`FindLTTngUST` module was introduced to find the LTTng-UST + library. + +* :prop_tgt:`AUTOMOC` now diagnoses name collisions when multiple source + files in different directories use ``#include `` with the + same name (because the generated ``moc_foo.cpp`` files would collide). + +* A :prop_tgt:`_CLANG_TIDY` target property and supporting + :variable:`CMAKE__CLANG_TIDY` variable were introduced to tell the + :ref:`Makefile Generators` and the :generator:`Ninja` generator to run + ``clang-tidy`` along with the compiler for ``C`` and ``CXX`` languages. + +* The :ref:`Makefile Generators` learned to optionally limit dependency + scanning only to files in the project source and build trees. + See the :variable:`CMAKE_DEPENDS_IN_PROJECT_ONLY` variable. + +* A new :variable:`CMAKE_HOST_SOLARIS` variable was introduced to + indicate when CMake is running on an Oracle Solaris host. + +* The :module:`CMakePushCheckState` module now pushes/pops/resets the variable + ``CMAKE_EXTRA_INCLUDE_FILE`` used in :module:`CheckTypeSize`. + +* The "CPackDeb" module learned how to handle ``$ORIGIN`` + in ``CMAKE_INSTALL_RPATH`` when :variable:`CPACK_DEBIAN_PACKAGE_SHLIBDEPS` + is used for dependency auto detection. + +* The :module:`CPackDeb` module learned how to generate ``DEBIAN/shlibs`` + contorl file when package contains shared libraries. + +* The :module:`CPackDeb` module learned how to generate ``DEBIAN/postinst`` and + ``DEBIAN/postrm`` files if the package installs libraries in + ldconfig-controlled locations (e.g. ``/lib/``, ``/usr/lib/``). + +* The :module:`CPackDeb` module learned how to generate dependencies between + Debian packages if multi-component setup is used and + :variable:`CPACK_COMPONENT__DEPENDS` variables are set. + For backward compatibility this feature is disabled by default. See + :variable:`CPACK_DEBIAN_ENABLE_COMPONENT_DEPENDS`. + +* The :module:`CPackDeb` module learned how to set custom package file names + including how to generate properly-named Debian packages:: + + _-_.deb + + For backward compatibility this feature is disabled by default. See + :variable:`CPACK_DEBIAN_FILE_NAME` and + :variable:`CPACK_DEBIAN__FILE_NAME`. + +* The :module:`CPackDeb` module learned how to set the package release number + (``DebianRevisionNumber`` in package file name when used in combination with + ``DEB-DEFAULT`` value set by :variable:`CPACK_DEBIAN_FILE_NAME`). See + :variable:`CPACK_DEBIAN_PACKAGE_RELEASE`. + +* The :module:`CPackDeb` module learned how to set the package architecture + per-component. See :variable:`CPACK_DEBIAN__PACKAGE_ARCHITECTURE`. + +* The :module:`CPackDMG` module learned a new option to tell the CPack + ``DragNDrop`` generaor to skip the ``/Applications`` symlink. + See the :variable:`CPACK_DMG_DISABLE_APPLICATIONS_SYMLINK` variable. + +* The :module:`CPackIFW` module gained a new + :command:`cpack_ifw_update_repository` command to update a QtIFW-specific + repository from a remote repository. + +* The :module:`CPackRPM` module learned how to set RPM ``dist`` tag as part of + RPM ``Release:`` tag when enabled (mandatory on some Linux distributions for + e.g. on Fedora). + See :variable:`CPACK_RPM_PACKAGE_RELEASE_DIST`. + +* The "CPackRPM" module learned how to set default values for owning user/group + and file/directory permissions of package content. + See :variable:`CPACK_RPM_DEFAULT_USER`, :variable:`CPACK_RPM_DEFAULT_GROUP`, + :variable:`CPACK_RPM_DEFAULT_FILE_PERMISSIONS`, + :variable:`CPACK_RPM_DEFAULT_DIR_PERMISSIONS` and their per component + counterparts. + +* The :module:`CPackRPM` module learned how to set user defined package file + names, how to specify that rpmbuild should decide on file name format as + well as handling of multiple rpm packages generated by a single user defined + spec file. + See :variable:`CPACK_RPM_PACKAGE_NAME` and + :variable:`CPACK_RPM__PACKAGE_NAME`. + +* The "CPackRPM" module learned how to correctly handle symlinks + that are pointing outside generated packages. + +* The "CPackRPM" module now supports upper cased component name + in per component CPackRPM specific variables. + E.g. component named ``foo`` now expects component specific + variable to be ``CPACK_RPM_FOO_PACKAGE_NAME`` while before + it expected ``CPACK_RPM_foo_PACKAGE_NAME``. + Upper cased component name part in variables is compatible + with convention used for other CPack variables. + For back compatibility old format of variables is still valid + and preferred if both versions of variable are set, but the + preferred future use is upper cased component names in variables. + New variables that will be added to CPackRPM in later versions + will only support upper cased component variable format. + +* The :command:`ctest_update` command now looks at the + :variable:`CTEST_GIT_INIT_SUBMODULES` variable to determine whether + submodules should be updated or not before updating. +* The :command:`ctest_update` command will now synchronize submodules on an + update. Updates which add submodules or change a submodule's URL will now be + pulled properly. + +* The :command:`add_custom_command` and :command:`add_custom_target` commands + learned how to use the :prop_tgt:`CROSSCOMPILING_EMULATOR` executable + target property. + +* The Clang compiler is now supported on CYGWIN. + +* The :module:`CMakeForceCompiler` module and its macros are now deprecated. + See module documentation for an explanation. + +* The :variable:`CMAKE__STANDARD_LIBRARIES` variable is now documented. + It is intended for use by toolchain files to specify system libraries to be + added to all linker command lines. + +* On Linux and FreeBSD platforms, when building CMake itself from source and + not using a system-provided libcurl, OpenSSL is now used by default if it is + found on the system. This enables SSL/TLS support for commands supporting + network communication via ``https``, such as :command:`file(DOWNLOAD)`, + :command:`file(UPLOAD)`, and :command:`ctest_submit`. + +* The :module:`ExternalProject` module now uses ``TLS_VERIFY`` when fetching + from git repositories. + +* The :manual:`cmake(1)` ``--build`` command-line tool now rejects multiple + ``--target`` options with an error instead of silently ignoring all but the + last one. + +* The :module:`ExternalProject` module leared the ``GIT_SHALLOW 1`` + option to perform a shallow clone of a Git repository. + +* The :module:`ExternalProject` module learned to initialize Git submodules + recursively and also to initialize new submodules on updates. Use the + ``GIT_SUBMODULES`` option to restrict which submodules are initalized and + updated. + +* The :module:`ExternalProject` module leared the ``DOWNLOAD_NO_EXTRACT 1`` + argument to skip extracting the file that is downloaded (e.g., for + self-extracting shell installers or ``.msi`` files). + +* The :module:`FindBLAS` and :module:`FindLAPACK` modules learned to + support `OpenBLAS `__. + +* The :command:`find_library`, :command:`find_path`, and :command:`find_file` + commands no longer search in installation prefixes derived from the ``PATH`` + environment variable on non-Windows platforms. This behavior was added in + CMake 3.3 to support Windows hosts but has proven problematic on UNIX hosts. + Users that keep some ``/bin`` directories in the ``PATH`` just for + their tools do not necessarily want any supporting ``/lib`` + directories searched. One may set the ``CMAKE_PREFIX_PATH`` environment + variable with a :ref:`;-list ` of prefixes that are + to be searched. + +* The :module:`FindCUDA` module learned to find the ``cublas_device`` library. + +* The :module:`FindGTest` module ``gtest_add_tests`` function now causes + CMake to automatically re-run when test sources change so that they + can be re-scanned. + +* The :module:`FindPkgConfig` module learned to optionally create imported + targets for the libraries it has found. + +* The :module:`FindProtobuf` module input and output variables were all renamed + from ``PROTOBUF_`` to ``Protobuf_`` for consistency with other find modules. + Input variables of the old case will be honored if provided, and output + variables of the old case are always provided. + +* The :module:`FindProtobuf` module learned to provide a ``Protobuf_VERSION`` + variable and check the version number requested in a :command:`find_package` + call. + +* The :module:`FindBISON` module ``BISON_TARGET`` macro now supports + special characters by passing the ``VERBATIM`` option to internal + :command:`add_custom_command` calls. This may break clients that + added escaping manually to work around the bug. + +* The :module:`FindFLEX` module ``FLEX_TARGET`` macro now supports + special characters by passing the ``VERBATIM`` option to internal + :command:`add_custom_command` calls. This may break clients that + added escaping manually to work around the bug. + +* The :command:`install` command learned a new ``EXCLUDE_FROM_ALL`` option + to leave installation rules out of the default installation. + +* The :module:`InstallRequiredSystemLibraries` module learned a new + ``CMAKE_INSTALL_UCRT_LIBRARIES`` option to enable app-local deployment + of the Windows Universal CRT libraries with Visual Studio 2015. + +* The :manual:`Compile Features ` functionality + is now aware of features supported by Intel C++ compilers versions 12.1 + through 16.0 on UNIX platforms. + +* The :command:`list` command gained a ``FILTER`` sub-command to filter + list elements by regular expression. + +* The :generator:`Ninja` generator now includes system header files in build + dependencies to ensure correct re-builds when system packages are updated. + +* The :generator:`Ninja` generator learned to produce phony targets + of the form ``sub/dir/all`` to drive the build of a subdirectory. + This is equivalent to ``cd sub/dir; make all`` with + :ref:`Makefile Generators`. + +* The :generator:`Ninja` generator learned to read a new + :variable:`CMAKE_NINJA_OUTPUT_PATH_PREFIX` variable to configure + the generated ``build.ninja`` file for use as a ``subninja``. + +* The :generator:`Visual Studio 6` generator has been removed. + +* The :generator:`Visual Studio 7` generator (for VS .NET 2002) has been + removed. + +* A :variable:`CMAKE__STANDARD_INCLUDE_DIRECTORIES` variable was + added for use by toolchain files to specify system include directories + to be appended to all compiler command lines. + +* CTest learned to optionally enforce a secondary timeout after matching + certain output from a test. See the :prop_test:`TIMEOUT_AFTER_MATCH` test + property. + +* The :command:`try_compile` command source file signature now honors + configuration-specific flags (e.g. :variable:`CMAKE__FLAGS_DEBUG`) + in the generated test project. Previously only the default such flags + for the current toolchain were used. + +* A :variable:`CMAKE_TRY_COMPILE_PLATFORM_VARIABLES` variable was + added for use by toolchain files to specify platform-specific + variables that must be propagated by the :command:`try_compile` + command into test projects. + +* The :command:`try_compile` command learned to check a new + :variable:`CMAKE_TRY_COMPILE_TARGET_TYPE` variable to optionally + build a static library instead of an executable. This is useful + for cross-compiling toolchains that cannot link binaries without + custom flags or scripts. + +* The :command:`string(TIMESTAMP)` and :command:`file(TIMESTAMP)` + commands gained support for the ``%s`` placeholder. This is + the number of seconds since the UNIX Epoch. + +* The precompiled OS X binary provided on ``cmake.org`` now requires + OS X 10.7 or newer. + +* The :generator:`Visual Studio 7 .NET 2003` generator is now + deprecated and will be removed in a future version of CMake. + +* The :generator:`Visual Studio 14 2015` generator learned to support the + Clang/C2 toolsets, e.g. with the ``-T v140_clang_3_7`` option. + +* The :generator:`Visual Studio 9 2008` and :generator:`Visual Studio 8 2005` + generators learned to generate the remote directory for WinCE project + deployment and debugger settings. See the + :prop_tgt:`DEPLOYMENT_REMOTE_DIRECTORY` target property. + +* The :ref:`Visual Studio Generators` learned to honor a new + :prop_dir:`VS_STARTUP_PROJECT` directory property that specifies + the default startup project for generated solutions (``.sln`` files). + +* :ref:`Visual Studio Generators` for VS 2010 and above learned a new + :prop_tgt:`VS_CONFIGURATION_TYPE` target property to specify a custom + project file type. diff --git a/Help/release/dev/CMakePushCheckState-CMAKE_EXTRA_INCLUDE_FILES.rst b/Help/release/dev/CMakePushCheckState-CMAKE_EXTRA_INCLUDE_FILES.rst deleted file mode 100644 index a4e9a14..0000000 --- a/Help/release/dev/CMakePushCheckState-CMAKE_EXTRA_INCLUDE_FILES.rst +++ /dev/null @@ -1,5 +0,0 @@ -CMakePushCheckState-CMAKE_EXTRA_INCLUDE_FILE --------------------------------------------- - -* The :module:`CMakePushCheckState` module now pushes/pops/resets the variable - ``CMAKE_EXTRA_INCLUDE_FILE`` used in :module:`CheckTypeSize`. diff --git a/Help/release/dev/ExternalProject-git-clone-shallow.rst b/Help/release/dev/ExternalProject-git-clone-shallow.rst deleted file mode 100644 index f06fe34..0000000 --- a/Help/release/dev/ExternalProject-git-clone-shallow.rst +++ /dev/null @@ -1,5 +0,0 @@ -ExternalProject-git-clone-shallow ---------------------------------- - -* The :module:`ExternalProject` module leared the ``GIT_SHALLOW 1`` - option to perform a shallow clone of a Git repository. diff --git a/Help/release/dev/ExternalProject-git-recursive-init.rst b/Help/release/dev/ExternalProject-git-recursive-init.rst deleted file mode 100644 index 1ebcced..0000000 --- a/Help/release/dev/ExternalProject-git-recursive-init.rst +++ /dev/null @@ -1,7 +0,0 @@ -ExternalProject-git-recursive-init ----------------------------------- - -* The :module:`ExternalProject` module learned to initialize Git submodules - recursively and also to initialize new submodules on updates. Use the - ``GIT_SUBMODULES`` option to restrict which submodules are initalized and - updated. diff --git a/Help/release/dev/FindCUDA-cublas_device.rst b/Help/release/dev/FindCUDA-cublas_device.rst deleted file mode 100644 index 2ceed60..0000000 --- a/Help/release/dev/FindCUDA-cublas_device.rst +++ /dev/null @@ -1,4 +0,0 @@ -FindCUDA-cublas_device ----------------------- - -* The :module:`FindCUDA` module learned to find the ``cublas_device`` library. diff --git a/Help/release/dev/FindGTest-depends.rst b/Help/release/dev/FindGTest-depends.rst deleted file mode 100644 index 33c1489..0000000 --- a/Help/release/dev/FindGTest-depends.rst +++ /dev/null @@ -1,6 +0,0 @@ -FindGTest-depends ------------------ - -* The :module:`FindGTest` module ``gtest_add_tests`` function now causes - CMake to automatically re-run when test sources change so that they - can be re-scanned. diff --git a/Help/release/dev/FindPkgConfig-targets.rst b/Help/release/dev/FindPkgConfig-targets.rst deleted file mode 100644 index b18cb7b..0000000 --- a/Help/release/dev/FindPkgConfig-targets.rst +++ /dev/null @@ -1,5 +0,0 @@ -FindPkgConfig-targets ---------------------- - -* The :module:`FindPkgConfig` module learned to optionally create imported - targets for the libraries it has found. diff --git a/Help/release/dev/FindProtobuf-variable-case.rst b/Help/release/dev/FindProtobuf-variable-case.rst deleted file mode 100644 index 0df00e7..0000000 --- a/Help/release/dev/FindProtobuf-variable-case.rst +++ /dev/null @@ -1,7 +0,0 @@ -FindProtobuf-variable-case --------------------------- - -* The :module:`FindProtobuf` module input and output variables were all renamed - from ``PROTOBUF_`` to ``Protobuf_`` for consistency with other find modules. - Input variables of the old case will be honored if provided, and output - variables of the old case are always provided. diff --git a/Help/release/dev/FindProtobuf-version.rst b/Help/release/dev/FindProtobuf-version.rst deleted file mode 100644 index 40c2ff5..0000000 --- a/Help/release/dev/FindProtobuf-version.rst +++ /dev/null @@ -1,6 +0,0 @@ -FindProtobuf-version --------------------- - -* The :module:`FindProtobuf` module learned to provide a ``Protobuf_VERSION`` - variable and check the version number requested in a :command:`find_package` - call. diff --git a/Help/release/dev/InstallRequiredSystemLibraries-Windows-UCRT.rst b/Help/release/dev/InstallRequiredSystemLibraries-Windows-UCRT.rst deleted file mode 100644 index e52531d..0000000 --- a/Help/release/dev/InstallRequiredSystemLibraries-Windows-UCRT.rst +++ /dev/null @@ -1,6 +0,0 @@ -InstallRequiredSystemLibraries-Windows-UCRT -------------------------------------------- - -* The :module:`InstallRequiredSystemLibraries` module learned a new - ``CMAKE_INSTALL_UCRT_LIBRARIES`` option to enable app-local deployment - of the Windows Universal CRT libraries with Visual Studio 2015. diff --git a/Help/release/dev/add-FindLTTngUST.rst b/Help/release/dev/add-FindLTTngUST.rst deleted file mode 100644 index a156cc8..0000000 --- a/Help/release/dev/add-FindLTTngUST.rst +++ /dev/null @@ -1,5 +0,0 @@ -add-FindLTTngUST ----------------- - -* The :module:`FindLTTngUST` module was introduced to find the LTTng-UST - library. diff --git a/Help/release/dev/add-bruce-c.rst b/Help/release/dev/add-bruce-c.rst deleted file mode 100644 index 9e47900..0000000 --- a/Help/release/dev/add-bruce-c.rst +++ /dev/null @@ -1,4 +0,0 @@ -add-bruce-c ------------ - -* Support was added for the Bruce C Compiler with compiler id ``Bruce``. diff --git a/Help/release/dev/automoc-diagnostics.rst b/Help/release/dev/automoc-diagnostics.rst deleted file mode 100644 index d89f2e1..0000000 --- a/Help/release/dev/automoc-diagnostics.rst +++ /dev/null @@ -1,6 +0,0 @@ -automoc-diagnostics -------------------- - -* :prop_tgt:`AUTOMOC` now diagnoses name collisions when multiple source - files in different directories use ``#include `` with the - same name (because the generated ``moc_foo.cpp`` files would collide). diff --git a/Help/release/dev/clang-tidy.rst b/Help/release/dev/clang-tidy.rst deleted file mode 100644 index 030a7c9..0000000 --- a/Help/release/dev/clang-tidy.rst +++ /dev/null @@ -1,7 +0,0 @@ -clang-tidy ----------- - -* A :prop_tgt:`_CLANG_TIDY` target property and supporting - :variable:`CMAKE__CLANG_TIDY` variable were introduced to tell the - :ref:`Makefile Generators` and the :generator:`Ninja` generator to run - ``clang-tidy`` along with the compiler for ``C`` and ``CXX`` languages. diff --git a/Help/release/dev/cmake-depend-in-project-only.rst b/Help/release/dev/cmake-depend-in-project-only.rst deleted file mode 100644 index 8553e80..0000000 --- a/Help/release/dev/cmake-depend-in-project-only.rst +++ /dev/null @@ -1,6 +0,0 @@ -cmake-depend-in-project-only ----------------------------- - -* The :ref:`Makefile Generators` learned to optionally limit dependency - scanning only to files in the project source and build trees. - See the :variable:`CMAKE_DEPENDS_IN_PROJECT_ONLY` variable. diff --git a/Help/release/dev/cmake-host-solaris.rst b/Help/release/dev/cmake-host-solaris.rst deleted file mode 100644 index da7ab89..0000000 --- a/Help/release/dev/cmake-host-solaris.rst +++ /dev/null @@ -1,5 +0,0 @@ -cmake-host-solaris ------------------- - -* A new :variable:`CMAKE_HOST_SOLARIS` variable was introduced to - indicate when CMake is running on an Oracle Solaris host. diff --git a/Help/release/dev/cpack-deb-autodep-ORIGIN-RPATH.rst b/Help/release/dev/cpack-deb-autodep-ORIGIN-RPATH.rst deleted file mode 100644 index b0d6196..0000000 --- a/Help/release/dev/cpack-deb-autodep-ORIGIN-RPATH.rst +++ /dev/null @@ -1,6 +0,0 @@ -cpack-deb-autodep-ORIGIN-RPATH --------------------------------- - -* The "CPackDeb" module learned how to handle ``$ORIGIN`` - in ``CMAKE_INSTALL_RPATH`` when :variable:`CPACK_DEBIAN_PACKAGE_SHLIBDEPS` - is used for dependency auto detection. diff --git a/Help/release/dev/cpack-deb-imporvements.rst b/Help/release/dev/cpack-deb-imporvements.rst deleted file mode 100644 index 63312b5..0000000 --- a/Help/release/dev/cpack-deb-imporvements.rst +++ /dev/null @@ -1,32 +0,0 @@ -cpack-deb-imporvements ----------------------- - -* The :module:`CPackDeb` module learned how to generate ``DEBIAN/shlibs`` - contorl file when package contains shared libraries. - -* The :module:`CPackDeb` module learned how to generate ``DEBIAN/postinst`` and - ``DEBIAN/postrm`` files if the package installs libraries in - ldconfig-controlled locations (e.g. ``/lib/``, ``/usr/lib/``). - -* The :module:`CPackDeb` module learned how to generate dependencies between - Debian packages if multi-component setup is used and - :variable:`CPACK_COMPONENT__DEPENDS` variables are set. - For backward compatibility this feature is disabled by default. See - :variable:`CPACK_DEBIAN_ENABLE_COMPONENT_DEPENDS`. - -* The :module:`CPackDeb` module learned how to set custom package file names - including how to generate properly-named Debian packages:: - - _-_.deb - - For backward compatibility this feature is disabled by default. See - :variable:`CPACK_DEBIAN_FILE_NAME` and - :variable:`CPACK_DEBIAN__FILE_NAME`. - -* The :module:`CPackDeb` module learned how to set the package release number - (``DebianRevisionNumber`` in package file name when used in combination with - ``DEB-DEFAULT`` value set by :variable:`CPACK_DEBIAN_FILE_NAME`). See - :variable:`CPACK_DEBIAN_PACKAGE_RELEASE`. - -* The :module:`CPackDeb` module learned how to set the package architecture - per-component. See :variable:`CPACK_DEBIAN__PACKAGE_ARCHITECTURE`. diff --git a/Help/release/dev/cpack-dmg-no-app-link.rst b/Help/release/dev/cpack-dmg-no-app-link.rst deleted file mode 100644 index 46101a5..0000000 --- a/Help/release/dev/cpack-dmg-no-app-link.rst +++ /dev/null @@ -1,6 +0,0 @@ -cpack-dmg-no-app-link ---------------------- - -* The :module:`CPackDMG` module learned a new option to tell the CPack - ``DragNDrop`` generaor to skip the ``/Applications`` symlink. - See the :variable:`CPACK_DMG_DISABLE_APPLICATIONS_SYMLINK` variable. diff --git a/Help/release/dev/cpack-ifw-updates.rst b/Help/release/dev/cpack-ifw-updates.rst deleted file mode 100644 index 868f46c..0000000 --- a/Help/release/dev/cpack-ifw-updates.rst +++ /dev/null @@ -1,6 +0,0 @@ -cpack-ifw-updates ------------------ - -* The :module:`CPackIFW` module gained a new - :command:`cpack_ifw_update_repository` command to update a QtIFW-specific - repository from a remote repository. diff --git a/Help/release/dev/cpack-rpm-adding-dist-to-release-tag.rst b/Help/release/dev/cpack-rpm-adding-dist-to-release-tag.rst deleted file mode 100644 index 42599a9..0000000 --- a/Help/release/dev/cpack-rpm-adding-dist-to-release-tag.rst +++ /dev/null @@ -1,7 +0,0 @@ -cpack-rpm-adding-dist-to-release-tag ------------------------------------- - -* The :module:`CPackRPM` module learned how to set RPM ``dist`` tag as part of - RPM ``Release:`` tag when enabled (mandatory on some Linux distributions for - e.g. on Fedora). - See :variable:`CPACK_RPM_PACKAGE_RELEASE_DIST`. diff --git a/Help/release/dev/cpack-rpm-default-user-and-group.rst b/Help/release/dev/cpack-rpm-default-user-and-group.rst deleted file mode 100644 index 7667c7f..0000000 --- a/Help/release/dev/cpack-rpm-default-user-and-group.rst +++ /dev/null @@ -1,9 +0,0 @@ -cpack-rpm-default-user-and-group --------------------------------- - -* The "CPackRPM" module learned how to set default values for owning user/group - and file/directory permissions of package content. - See :variable:`CPACK_RPM_DEFAULT_USER`, :variable:`CPACK_RPM_DEFAULT_GROUP`, - :variable:`CPACK_RPM_DEFAULT_FILE_PERMISSIONS`, - :variable:`CPACK_RPM_DEFAULT_DIR_PERMISSIONS` and their per component - counterparts. diff --git a/Help/release/dev/cpack-rpm-different-package-names.rst b/Help/release/dev/cpack-rpm-different-package-names.rst deleted file mode 100644 index 48679e1..0000000 --- a/Help/release/dev/cpack-rpm-different-package-names.rst +++ /dev/null @@ -1,9 +0,0 @@ -cpack-rpm-different-package-names ---------------------------------- - -* The :module:`CPackRPM` module learned how to set user defined package file - names, how to specify that rpmbuild should decide on file name format as - well as handling of multiple rpm packages generated by a single user defined - spec file. - See :variable:`CPACK_RPM_PACKAGE_NAME` and - :variable:`CPACK_RPM__PACKAGE_NAME`. diff --git a/Help/release/dev/cpack-rpm-external-symlink-handling.rst b/Help/release/dev/cpack-rpm-external-symlink-handling.rst deleted file mode 100644 index ff74e1d..0000000 --- a/Help/release/dev/cpack-rpm-external-symlink-handling.rst +++ /dev/null @@ -1,5 +0,0 @@ -cpack-rpm-external-symlink-handling ------------------------------------ - -* The "CPackRPM" module learned how to correctly handle symlinks - that are pointing outside generated packages. diff --git a/Help/release/dev/cpack-rpm-upper-cased-components.rst b/Help/release/dev/cpack-rpm-upper-cased-components.rst deleted file mode 100644 index 0628170..0000000 --- a/Help/release/dev/cpack-rpm-upper-cased-components.rst +++ /dev/null @@ -1,15 +0,0 @@ -cpack-rpm-upper-cased-components --------------------------------- - -* The "CPackRPM" module now supports upper cased component name - in per component CPackRPM specific variables. - E.g. component named ``foo`` now expects component specific - variable to be ``CPACK_RPM_FOO_PACKAGE_NAME`` while before - it expected ``CPACK_RPM_foo_PACKAGE_NAME``. - Upper cased component name part in variables is compatible - with convention used for other CPack variables. - For back compatibility old format of variables is still valid - and preferred if both versions of variable are set, but the - preferred future use is upper cased component names in variables. - New variables that will be added to CPackRPM in later versions - will only support upper cased component variable format. diff --git a/Help/release/dev/ctest-run-submodule-sync.rst b/Help/release/dev/ctest-run-submodule-sync.rst deleted file mode 100644 index c41cc2f..0000000 --- a/Help/release/dev/ctest-run-submodule-sync.rst +++ /dev/null @@ -1,9 +0,0 @@ -ctest-run-submodule-sync ------------------------- - -* The :command:`ctest_update` command now looks at the - :variable:`CTEST_GIT_INIT_SUBMODULES` variable to determine whether - submodules should be updated or not before updating. -* The :command:`ctest_update` command will now synchronize submodules on an - update. Updates which add submodules or change a submodule's URL will now be - pulled properly. diff --git a/Help/release/dev/custom-command-CROSSCOMPILING_EMULATOR.rst b/Help/release/dev/custom-command-CROSSCOMPILING_EMULATOR.rst deleted file mode 100644 index 390463e..0000000 --- a/Help/release/dev/custom-command-CROSSCOMPILING_EMULATOR.rst +++ /dev/null @@ -1,6 +0,0 @@ -custom-command-CROSSCOMPILING_EMULATOR --------------------------------------- - -* The :command:`add_custom_command` and :command:`add_custom_target` commands - learned how to use the :prop_tgt:`CROSSCOMPILING_EMULATOR` executable - target property. diff --git a/Help/release/dev/cygwin-clang.rst b/Help/release/dev/cygwin-clang.rst deleted file mode 100644 index 7d06d2a..0000000 --- a/Help/release/dev/cygwin-clang.rst +++ /dev/null @@ -1,4 +0,0 @@ -cygwin-clang ------------- - -* The Clang compiler is now supported on CYGWIN. diff --git a/Help/release/dev/deprecate-CMakeForceCompiler.rst b/Help/release/dev/deprecate-CMakeForceCompiler.rst deleted file mode 100644 index dc6e817..0000000 --- a/Help/release/dev/deprecate-CMakeForceCompiler.rst +++ /dev/null @@ -1,5 +0,0 @@ -deprecate-CMakeForceCompiler ----------------------------- - -* The :module:`CMakeForceCompiler` module and its macros are now deprecated. - See module documentation for an explanation. diff --git a/Help/release/dev/doc-standard-libs.rst b/Help/release/dev/doc-standard-libs.rst deleted file mode 100644 index 6a99037..0000000 --- a/Help/release/dev/doc-standard-libs.rst +++ /dev/null @@ -1,6 +0,0 @@ -doc-standard-libs ------------------ - -* The :variable:`CMAKE__STANDARD_LIBRARIES` variable is now documented. - It is intended for use by toolchain files to specify system libraries to be - added to all linker command lines. diff --git a/Help/release/dev/enable-ssl-automatically.rst b/Help/release/dev/enable-ssl-automatically.rst deleted file mode 100644 index 8ded656..0000000 --- a/Help/release/dev/enable-ssl-automatically.rst +++ /dev/null @@ -1,8 +0,0 @@ -enable-ssl-automatically ------------------------- - -* On Linux and FreeBSD platforms, when building CMake itself from source and - not using a system-provided libcurl, OpenSSL is now used by default if it is - found on the system. This enables SSL/TLS support for commands supporting - network communication via ``https``, such as :command:`file(DOWNLOAD)`, - :command:`file(UPLOAD)`, and :command:`ctest_submit`. diff --git a/Help/release/dev/ep-tls-verify-git.rst b/Help/release/dev/ep-tls-verify-git.rst deleted file mode 100644 index 3c727de..0000000 --- a/Help/release/dev/ep-tls-verify-git.rst +++ /dev/null @@ -1,5 +0,0 @@ -ep-tls-verify-git ------------------ - -* The :module:`ExternalProject` module now uses ``TLS_VERIFY`` when fetching - from git repositories. diff --git a/Help/release/dev/error-multiple-targets.rst b/Help/release/dev/error-multiple-targets.rst deleted file mode 100644 index 060b26b..0000000 --- a/Help/release/dev/error-multiple-targets.rst +++ /dev/null @@ -1,6 +0,0 @@ -error-multiple-targets ----------------------- - -* The :manual:`cmake(1)` ``--build`` command-line tool now rejects multiple - ``--target`` options with an error instead of silently ignoring all but the - last one. diff --git a/Help/release/dev/external-project-no-extract.rst b/Help/release/dev/external-project-no-extract.rst deleted file mode 100644 index b3293cd..0000000 --- a/Help/release/dev/external-project-no-extract.rst +++ /dev/null @@ -1,6 +0,0 @@ -external-project-no-extract ---------------------------- - -* The :module:`ExternalProject` module leared the ``DOWNLOAD_NO_EXTRACT 1`` - argument to skip extracting the file that is downloaded (e.g., for - self-extracting shell installers or ``.msi`` files). diff --git a/Help/release/dev/find-blas-lapack-OpenBLAS.rst b/Help/release/dev/find-blas-lapack-OpenBLAS.rst deleted file mode 100644 index 893422a..0000000 --- a/Help/release/dev/find-blas-lapack-OpenBLAS.rst +++ /dev/null @@ -1,5 +0,0 @@ -find-blas-lapack-OpenBLAS -------------------------- - -* The :module:`FindBLAS` and :module:`FindLAPACK` modules learned to - support `OpenBLAS `__. diff --git a/Help/release/dev/find-command-prefix-from-PATH-windows-only.rst b/Help/release/dev/find-command-prefix-from-PATH-windows-only.rst deleted file mode 100644 index be6eb3e..0000000 --- a/Help/release/dev/find-command-prefix-from-PATH-windows-only.rst +++ /dev/null @@ -1,12 +0,0 @@ -find-command-prefix-from-PATH-windows-only ------------------------------------------- - -* The :command:`find_library`, :command:`find_path`, and :command:`find_file` - commands no longer search in installation prefixes derived from the ``PATH`` - environment variable on non-Windows platforms. This behavior was added in - CMake 3.3 to support Windows hosts but has proven problematic on UNIX hosts. - Users that keep some ``/bin`` directories in the ``PATH`` just for - their tools do not necessarily want any supporting ``/lib`` - directories searched. One may set the ``CMAKE_PREFIX_PATH`` environment - variable with a :ref:`;-list ` of prefixes that are - to be searched. diff --git a/Help/release/dev/fix-bison-flex-command-escaping.rst b/Help/release/dev/fix-bison-flex-command-escaping.rst deleted file mode 100644 index dc2e87b..0000000 --- a/Help/release/dev/fix-bison-flex-command-escaping.rst +++ /dev/null @@ -1,12 +0,0 @@ -fix-bison-flex-command-escaping -------------------------------- - -* The :module:`FindBISON` module ``BISON_TARGET`` macro now supports - special characters by passing the ``VERBATIM`` option to internal - :command:`add_custom_command` calls. This may break clients that - added escaping manually to work around the bug. - -* The :module:`FindFLEX` module ``FLEX_TARGET`` macro now supports - special characters by passing the ``VERBATIM`` option to internal - :command:`add_custom_command` calls. This may break clients that - added escaping manually to work around the bug. diff --git a/Help/release/dev/install-EXCLUDE_FROM_ALL.rst b/Help/release/dev/install-EXCLUDE_FROM_ALL.rst deleted file mode 100644 index a611eae..0000000 --- a/Help/release/dev/install-EXCLUDE_FROM_ALL.rst +++ /dev/null @@ -1,5 +0,0 @@ -install-EXCLUDE_FROM_ALL ------------------------- - -* The :command:`install` command learned a new ``EXCLUDE_FROM_ALL`` option - to leave installation rules out of the default installation. diff --git a/Help/release/dev/intel-compiler-features.rst b/Help/release/dev/intel-compiler-features.rst deleted file mode 100644 index f154dc9..0000000 --- a/Help/release/dev/intel-compiler-features.rst +++ /dev/null @@ -1,6 +0,0 @@ -intel-compiler-features ------------------------ - -* The :manual:`Compile Features ` functionality - is now aware of features supported by Intel C++ compilers versions 12.1 - through 16.0 on UNIX platforms. diff --git a/Help/release/dev/list-FILTER-command.rst b/Help/release/dev/list-FILTER-command.rst deleted file mode 100644 index 3fee4f0..0000000 --- a/Help/release/dev/list-FILTER-command.rst +++ /dev/null @@ -1,5 +0,0 @@ -list-FILTER-command -------------------- - -* The :command:`list` command gained a ``FILTER`` sub-command to filter - list elements by regular expression. diff --git a/Help/release/dev/ninja-depfile-system-headers.rst b/Help/release/dev/ninja-depfile-system-headers.rst deleted file mode 100644 index 7033cef..0000000 --- a/Help/release/dev/ninja-depfile-system-headers.rst +++ /dev/null @@ -1,5 +0,0 @@ -ninja-depfile-system-headers ----------------------------- - -* The :generator:`Ninja` generator now includes system header files in build - dependencies to ensure correct re-builds when system packages are updated. diff --git a/Help/release/dev/ninja-directory-targets.rst b/Help/release/dev/ninja-directory-targets.rst deleted file mode 100644 index 4826228..0000000 --- a/Help/release/dev/ninja-directory-targets.rst +++ /dev/null @@ -1,7 +0,0 @@ -ninja-directory-targets ------------------------ - -* The :generator:`Ninja` generator learned to produce phony targets - of the form ``sub/dir/all`` to drive the build of a subdirectory. - This is equivalent to ``cd sub/dir; make all`` with - :ref:`Makefile Generators`. diff --git a/Help/release/dev/ninja-output-path-prefix.rst b/Help/release/dev/ninja-output-path-prefix.rst deleted file mode 100644 index 47a9660..0000000 --- a/Help/release/dev/ninja-output-path-prefix.rst +++ /dev/null @@ -1,6 +0,0 @@ -ninja-output-path-prefix ------------------------- - -* The :generator:`Ninja` generator learned to read a new - :variable:`CMAKE_NINJA_OUTPUT_PATH_PREFIX` variable to configure - the generated ``build.ninja`` file for use as a ``subninja``. diff --git a/Help/release/dev/remove-vs6-generator.rst b/Help/release/dev/remove-vs6-generator.rst deleted file mode 100644 index 921b93a..0000000 --- a/Help/release/dev/remove-vs6-generator.rst +++ /dev/null @@ -1,4 +0,0 @@ -remove-vs6-generator --------------------- - -* The :generator:`Visual Studio 6` generator has been removed. diff --git a/Help/release/dev/remove-vs7.0-generator.rst b/Help/release/dev/remove-vs7.0-generator.rst deleted file mode 100644 index 314bef9..0000000 --- a/Help/release/dev/remove-vs7.0-generator.rst +++ /dev/null @@ -1,5 +0,0 @@ -remove-vs7.0-generator ----------------------- - -* The :generator:`Visual Studio 7` generator (for VS .NET 2002) has been - removed. diff --git a/Help/release/dev/standard-include-directories.rst b/Help/release/dev/standard-include-directories.rst deleted file mode 100644 index a03d7db..0000000 --- a/Help/release/dev/standard-include-directories.rst +++ /dev/null @@ -1,6 +0,0 @@ -standard-include-directories ----------------------------- - -* A :variable:`CMAKE__STANDARD_INCLUDE_DIRECTORIES` variable was - added for use by toolchain files to specify system include directories - to be appended to all compiler command lines. diff --git a/Help/release/dev/timeout_after_match.rst b/Help/release/dev/timeout_after_match.rst deleted file mode 100644 index 83f316d..0000000 --- a/Help/release/dev/timeout_after_match.rst +++ /dev/null @@ -1,6 +0,0 @@ -timeout_after_match -------------------- - -* CTest learned to optionally enforce a secondary timeout after matching - certain output from a test. See the :prop_test:`TIMEOUT_AFTER_MATCH` test - property. diff --git a/Help/release/dev/try_compile-config-flags.rst b/Help/release/dev/try_compile-config-flags.rst deleted file mode 100644 index 7e5e461..0000000 --- a/Help/release/dev/try_compile-config-flags.rst +++ /dev/null @@ -1,7 +0,0 @@ -try_compile-config-flags ------------------------- - -* The :command:`try_compile` command source file signature now honors - configuration-specific flags (e.g. :variable:`CMAKE__FLAGS_DEBUG`) - in the generated test project. Previously only the default such flags - for the current toolchain were used. diff --git a/Help/release/dev/try_compile-custom-variables.rst b/Help/release/dev/try_compile-custom-variables.rst deleted file mode 100644 index 539b364..0000000 --- a/Help/release/dev/try_compile-custom-variables.rst +++ /dev/null @@ -1,7 +0,0 @@ -try_compile-custom-variables ----------------------------- - -* A :variable:`CMAKE_TRY_COMPILE_PLATFORM_VARIABLES` variable was - added for use by toolchain files to specify platform-specific - variables that must be propagated by the :command:`try_compile` - command into test projects. diff --git a/Help/release/dev/try_compile-target-type.rst b/Help/release/dev/try_compile-target-type.rst deleted file mode 100644 index cc41bf3..0000000 --- a/Help/release/dev/try_compile-target-type.rst +++ /dev/null @@ -1,8 +0,0 @@ -try_compile-target-type ------------------------ - -* The :command:`try_compile` command learned to check a new - :variable:`CMAKE_TRY_COMPILE_TARGET_TYPE` variable to optionally - build a static library instead of an executable. This is useful - for cross-compiling toolchains that cannot link binaries without - custom flags or scripts. diff --git a/Help/release/dev/unix-timestamps.rst b/Help/release/dev/unix-timestamps.rst deleted file mode 100644 index cdb0e5b..0000000 --- a/Help/release/dev/unix-timestamps.rst +++ /dev/null @@ -1,6 +0,0 @@ -unix-timestamps ---------------- - -* The :command:`string(TIMESTAMP)` and :command:`file(TIMESTAMP)` - commands gained support for the ``%s`` placeholder. This is - the number of seconds since the UNIX Epoch. diff --git a/Help/release/dev/update-osx-release.rst b/Help/release/dev/update-osx-release.rst deleted file mode 100644 index 7634c05..0000000 --- a/Help/release/dev/update-osx-release.rst +++ /dev/null @@ -1,5 +0,0 @@ -update-osx-release ------------------- - -* The precompiled OS X binary provided on ``cmake.org`` now requires - OS X 10.7 or newer. diff --git a/Help/release/dev/vs-clang-cl.rst b/Help/release/dev/vs-clang-cl.rst deleted file mode 100644 index ac09188..0000000 --- a/Help/release/dev/vs-clang-cl.rst +++ /dev/null @@ -1,5 +0,0 @@ -vs-clang-cl ------------ - -* The :generator:`Visual Studio 14 2015` generator learned to support the - Clang/C2 toolsets, e.g. with the ``-T v140_clang_3_7`` option. diff --git a/Help/release/dev/vs-remote-directory.rst b/Help/release/dev/vs-remote-directory.rst deleted file mode 100644 index 194236d..0000000 --- a/Help/release/dev/vs-remote-directory.rst +++ /dev/null @@ -1,7 +0,0 @@ -vs-remote-directory -------------------- - -* The :generator:`Visual Studio 9 2008` and :generator:`Visual Studio 8 2005` - generators learned to generate the remote directory for WinCE project - deployment and debugger settings. See the - :prop_tgt:`DEPLOYMENT_REMOTE_DIRECTORY` target property. diff --git a/Help/release/dev/vs-startup-project.rst b/Help/release/dev/vs-startup-project.rst deleted file mode 100644 index f467400..0000000 --- a/Help/release/dev/vs-startup-project.rst +++ /dev/null @@ -1,6 +0,0 @@ -vs-startup-project ------------------- - -* The :ref:`Visual Studio Generators` learned to honor a new - :prop_dir:`VS_STARTUP_PROJECT` directory property that specifies - the default startup project for generated solutions (``.sln`` files). diff --git a/Help/release/dev/vs-vcxproj-ConfigurationType.rst b/Help/release/dev/vs-vcxproj-ConfigurationType.rst deleted file mode 100644 index 46d05b4..0000000 --- a/Help/release/dev/vs-vcxproj-ConfigurationType.rst +++ /dev/null @@ -1,6 +0,0 @@ -vs-vcxproj-ConfigurationType ----------------------------- - -* :ref:`Visual Studio Generators` for VS 2010 and above learned a new - :prop_tgt:`VS_CONFIGURATION_TYPE` target property to specify a custom - project file type. diff --git a/Help/release/dev/vs71-deprecate.rst b/Help/release/dev/vs71-deprecate.rst deleted file mode 100644 index 1946304..0000000 --- a/Help/release/dev/vs71-deprecate.rst +++ /dev/null @@ -1,5 +0,0 @@ -vs71-deprecate --------------- - -* The :generator:`Visual Studio 7 .NET 2003` generator is now - deprecated and will be removed in a future version of CMake. diff --git a/Help/release/index.rst b/Help/release/index.rst index 7ecf910..e93b880 100644 --- a/Help/release/index.rst +++ b/Help/release/index.rst @@ -13,6 +13,7 @@ Releases .. toctree:: :maxdepth: 1 + 3.6 <3.6> 3.5 <3.5> 3.4 <3.4> 3.3 <3.3> -- cgit v0.12 From 98eafa9b5f346f3695befcc0b52f5206904c8309 Mon Sep 17 00:00:00 2001 From: Brad King Date: Wed, 1 Jun 2016 10:21:30 -0400 Subject: Help: Organize and revise 3.6 release notes Add section headers similar to the 3.5 release notes and move each individual bullet into an appropriate section. Revise a few bullets. --- Help/release/3.6.rst | 367 ++++++++++++++++++++++++++++----------------------- 1 file changed, 203 insertions(+), 164 deletions(-) diff --git a/Help/release/3.6.rst b/Help/release/3.6.rst index 7c3764a..5c08b39 100644 --- a/Help/release/3.6.rst +++ b/Help/release/3.6.rst @@ -7,31 +7,170 @@ CMake 3.6 Release Notes Changes made since CMake 3.5 include the following. -* Support was added for the Bruce C Compiler with compiler id ``Bruce``. +New Features +============ -* The :module:`FindLTTngUST` module was introduced to find the LTTng-UST - library. +Generators +---------- -* :prop_tgt:`AUTOMOC` now diagnoses name collisions when multiple source - files in different directories use ``#include `` with the - same name (because the generated ``moc_foo.cpp`` files would collide). +* The :generator:`Ninja` generator learned to produce phony targets + of the form ``sub/dir/all`` to drive the build of a subdirectory. + This is equivalent to ``cd sub/dir; make all`` with + :ref:`Makefile Generators`. + +* The :generator:`Ninja` generator now includes system header files in build + dependencies to ensure correct re-builds when system packages are updated. + +* The :generator:`Visual Studio 14 2015` generator learned to support the + Clang/C2 toolsets, e.g. with the ``-T v140_clang_3_7`` option. + This feature is experimental. + +Commands +-------- + +* The :command:`add_custom_command` and :command:`add_custom_target` commands + learned how to use the :prop_tgt:`CROSSCOMPILING_EMULATOR` executable + target property. + +* The :command:`install` command learned a new ``EXCLUDE_FROM_ALL`` option + to leave installation rules out of the default installation. + +* The :command:`list` command gained a ``FILTER`` sub-command to filter + list elements by regular expression. + +* The :command:`string(TIMESTAMP)` and :command:`file(TIMESTAMP)` + commands gained support for the ``%s`` placeholder. This is + the number of seconds since the UNIX Epoch. + +* The :command:`try_compile` command source file signature now honors + configuration-specific flags (e.g. :variable:`CMAKE__FLAGS_DEBUG`) + in the generated test project. Previously only the default such flags + for the current toolchain were used. + +Variables +--------- + +* A :variable:`CMAKE_DEPENDS_IN_PROJECT_ONLY` variable was introduced + to tell :ref:`Makefile Generators` to limit dependency scanning only + to files in the project source and build trees. + +* A new :variable:`CMAKE_HOST_SOLARIS` variable was introduced to + indicate when CMake is running on an Oracle Solaris host. + +* A :variable:`CMAKE__STANDARD_INCLUDE_DIRECTORIES` variable was + added for use by toolchain files to specify system include directories + to be appended to all compiler command lines. + +* The :variable:`CMAKE__STANDARD_LIBRARIES` variable is now documented. + It is intended for use by toolchain files to specify system libraries to be + added to all linker command lines. + +* A :variable:`CMAKE_NINJA_OUTPUT_PATH_PREFIX` variable was introduced + to tell the :generator:`Ninja` generator to configure the generated + ``build.ninja`` file for use as a ``subninja``. + +* A :variable:`CMAKE_TRY_COMPILE_PLATFORM_VARIABLES` variable was + added for use by toolchain files to specify platform-specific + variables that must be propagated by the :command:`try_compile` + command into test projects. + +* A :variable:`CMAKE_TRY_COMPILE_TARGET_TYPE` variable was added + to optionally tell the :command:`try_compile` command to build + a static library instead of an executable. This is useful for + cross-compiling toolchains that cannot link binaries without + custom flags or scripts. + +Properties +---------- + +* A :prop_tgt:`DEPLOYMENT_REMOTE_DIRECTORY` target property was introduced + to tell the :generator:`Visual Studio 9 2008` and + :generator:`Visual Studio 8 2005` generators to generate the "remote + directory" for WinCE project deployment and debugger settings. * A :prop_tgt:`_CLANG_TIDY` target property and supporting :variable:`CMAKE__CLANG_TIDY` variable were introduced to tell the :ref:`Makefile Generators` and the :generator:`Ninja` generator to run ``clang-tidy`` along with the compiler for ``C`` and ``CXX`` languages. -* The :ref:`Makefile Generators` learned to optionally limit dependency - scanning only to files in the project source and build trees. - See the :variable:`CMAKE_DEPENDS_IN_PROJECT_ONLY` variable. +* A :prop_test:`TIMEOUT_AFTER_MATCH` test property was introduced to + optionally tell CTest to enforce a secondary timeout after matching + certain output from a test. -* A new :variable:`CMAKE_HOST_SOLARIS` variable was introduced to - indicate when CMake is running on an Oracle Solaris host. +* A :prop_tgt:`VS_CONFIGURATION_TYPE` target property was introduced + to specify a custom project file type for :ref:`Visual Studio Generators` + supporting VS 2010 and above. + +* A :prop_dir:`VS_STARTUP_PROJECT` directory property was introduced + to specify for :ref:`Visual Studio Generators` the default startup + project for generated solutions (``.sln`` files). + +Modules +------- * The :module:`CMakePushCheckState` module now pushes/pops/resets the variable ``CMAKE_EXTRA_INCLUDE_FILE`` used in :module:`CheckTypeSize`. -* The "CPackDeb" module learned how to handle ``$ORIGIN`` +* The :module:`ExternalProject` module leared the ``GIT_SHALLOW 1`` + option to perform a shallow clone of a Git repository. + +* The :module:`ExternalProject` module learned to initialize Git submodules + recursively and also to initialize new submodules on updates. Use the + ``GIT_SUBMODULES`` option to restrict which submodules are initalized and + updated. + +* The :module:`ExternalProject` module leared the ``DOWNLOAD_NO_EXTRACT 1`` + argument to skip extracting the file that is downloaded (e.g., for + self-extracting shell installers or ``.msi`` files). + +* The :module:`ExternalProject` module now uses ``TLS_VERIFY`` when fetching + from git repositories. + +* The :module:`FindBLAS` and :module:`FindLAPACK` modules learned to + support `OpenBLAS `__. + +* The :module:`FindCUDA` module learned to find the ``cublas_device`` library. + +* The :module:`FindGTest` module ``gtest_add_tests`` function now causes + CMake to automatically re-run when test sources change so that they + can be re-scanned. + +* The :module:`FindLTTngUST` module was introduced to find the LTTng-UST + library. + +* The :module:`FindPkgConfig` module learned to optionally create imported + targets for the libraries it has found. + +* The :module:`FindProtobuf` module learned to provide a ``Protobuf_VERSION`` + variable and check the version number requested in a :command:`find_package` + call. + +* The :module:`InstallRequiredSystemLibraries` module learned a new + ``CMAKE_INSTALL_UCRT_LIBRARIES`` option to enable app-local deployment + of the Windows Universal CRT libraries with Visual Studio 2015. + +Platforms +--------- + +* The Clang compiler is now supported on CYGWIN. + +* Support was added for the Bruce C Compiler with compiler id ``Bruce``. + +CTest +----- + +* The :command:`ctest_update` command now looks at the + :variable:`CTEST_GIT_INIT_SUBMODULES` variable to determine whether + submodules should be updated or not before updating. + +* The :command:`ctest_update` command will now synchronize submodules on an + update. Updates which add submodules or change a submodule's URL will now be + pulled properly. + +CPack +----- + +* The :module:`CPackDeb` module learned how to handle ``$ORIGIN`` in ``CMAKE_INSTALL_RPATH`` when :variable:`CPACK_DEBIAN_PACKAGE_SHLIBDEPS` is used for dependency auto detection. @@ -45,8 +184,8 @@ Changes made since CMake 3.5 include the following. * The :module:`CPackDeb` module learned how to generate dependencies between Debian packages if multi-component setup is used and :variable:`CPACK_COMPONENT__DEPENDS` variables are set. - For backward compatibility this feature is disabled by default. See - :variable:`CPACK_DEBIAN_ENABLE_COMPONENT_DEPENDS`. + For backward compatibility this feature is disabled by default. + See :variable:`CPACK_DEBIAN_ENABLE_COMPONENT_DEPENDS`. * The :module:`CPackDeb` module learned how to set custom package file names including how to generate properly-named Debian packages:: @@ -78,8 +217,8 @@ Changes made since CMake 3.5 include the following. e.g. on Fedora). See :variable:`CPACK_RPM_PACKAGE_RELEASE_DIST`. -* The "CPackRPM" module learned how to set default values for owning user/group - and file/directory permissions of package content. +* The :module:`CPackRPM` module learned how to set default values for owning + user/group and file/directory permissions of package content. See :variable:`CPACK_RPM_DEFAULT_USER`, :variable:`CPACK_RPM_DEFAULT_GROUP`, :variable:`CPACK_RPM_DEFAULT_FILE_PERMISSIONS`, :variable:`CPACK_RPM_DEFAULT_DIR_PERMISSIONS` and their per component @@ -92,70 +231,22 @@ Changes made since CMake 3.5 include the following. See :variable:`CPACK_RPM_PACKAGE_NAME` and :variable:`CPACK_RPM__PACKAGE_NAME`. -* The "CPackRPM" module learned how to correctly handle symlinks +* The :module:`CPackRPM` module learned how to correctly handle symlinks that are pointing outside generated packages. -* The "CPackRPM" module now supports upper cased component name - in per component CPackRPM specific variables. - E.g. component named ``foo`` now expects component specific - variable to be ``CPACK_RPM_FOO_PACKAGE_NAME`` while before - it expected ``CPACK_RPM_foo_PACKAGE_NAME``. - Upper cased component name part in variables is compatible - with convention used for other CPack variables. - For back compatibility old format of variables is still valid - and preferred if both versions of variable are set, but the - preferred future use is upper cased component names in variables. - New variables that will be added to CPackRPM in later versions - will only support upper cased component variable format. - -* The :command:`ctest_update` command now looks at the - :variable:`CTEST_GIT_INIT_SUBMODULES` variable to determine whether - submodules should be updated or not before updating. -* The :command:`ctest_update` command will now synchronize submodules on an - update. Updates which add submodules or change a submodule's URL will now be - pulled properly. +Other +----- -* The :command:`add_custom_command` and :command:`add_custom_target` commands - learned how to use the :prop_tgt:`CROSSCOMPILING_EMULATOR` executable - target property. +* The :manual:`Compile Features ` functionality + is now aware of features supported by Intel C++ compilers versions 12.1 + through 16.0 on UNIX platforms. -* The Clang compiler is now supported on CYGWIN. +Deprecated and Removed Features +=============================== * The :module:`CMakeForceCompiler` module and its macros are now deprecated. See module documentation for an explanation. -* The :variable:`CMAKE__STANDARD_LIBRARIES` variable is now documented. - It is intended for use by toolchain files to specify system libraries to be - added to all linker command lines. - -* On Linux and FreeBSD platforms, when building CMake itself from source and - not using a system-provided libcurl, OpenSSL is now used by default if it is - found on the system. This enables SSL/TLS support for commands supporting - network communication via ``https``, such as :command:`file(DOWNLOAD)`, - :command:`file(UPLOAD)`, and :command:`ctest_submit`. - -* The :module:`ExternalProject` module now uses ``TLS_VERIFY`` when fetching - from git repositories. - -* The :manual:`cmake(1)` ``--build`` command-line tool now rejects multiple - ``--target`` options with an error instead of silently ignoring all but the - last one. - -* The :module:`ExternalProject` module leared the ``GIT_SHALLOW 1`` - option to perform a shallow clone of a Git repository. - -* The :module:`ExternalProject` module learned to initialize Git submodules - recursively and also to initialize new submodules on updates. Use the - ``GIT_SUBMODULES`` option to restrict which submodules are initalized and - updated. - -* The :module:`ExternalProject` module leared the ``DOWNLOAD_NO_EXTRACT 1`` - argument to skip extracting the file that is downloaded (e.g., for - self-extracting shell installers or ``.msi`` files). - -* The :module:`FindBLAS` and :module:`FindLAPACK` modules learned to - support `OpenBLAS `__. - * The :command:`find_library`, :command:`find_path`, and :command:`find_file` commands no longer search in installation prefixes derived from the ``PATH`` environment variable on non-Windows platforms. This behavior was added in @@ -166,23 +257,34 @@ Changes made since CMake 3.5 include the following. variable with a :ref:`;-list ` of prefixes that are to be searched. -* The :module:`FindCUDA` module learned to find the ``cublas_device`` library. +* The :generator:`Visual Studio 7 .NET 2003` generator is now + deprecated and will be removed in a future version of CMake. -* The :module:`FindGTest` module ``gtest_add_tests`` function now causes - CMake to automatically re-run when test sources change so that they - can be re-scanned. +* The :generator:`Visual Studio 7` generator (for VS .NET 2002) has been + removed. It had been deprecated since CMake 3.3. -* The :module:`FindPkgConfig` module learned to optionally create imported - targets for the libraries it has found. +* The :generator:`Visual Studio 6` generator has been removed. + It had been deprecated since CMake 3.3. -* The :module:`FindProtobuf` module input and output variables were all renamed - from ``PROTOBUF_`` to ``Protobuf_`` for consistency with other find modules. - Input variables of the old case will be honored if provided, and output - variables of the old case are always provided. +Other Changes +============= -* The :module:`FindProtobuf` module learned to provide a ``Protobuf_VERSION`` - variable and check the version number requested in a :command:`find_package` - call. +* The precompiled OS X binary provided on ``cmake.org`` now requires + OS X 10.7 or newer. + +* On Linux and FreeBSD platforms, when building CMake itself from source and + not using a system-provided libcurl, OpenSSL is now used by default if it is + found on the system. This enables SSL/TLS support for commands supporting + network communication via ``https``, such as :command:`file(DOWNLOAD)`, + :command:`file(UPLOAD)`, and :command:`ctest_submit`. + +* The :manual:`cmake(1)` ``--build`` command-line tool now rejects multiple + ``--target`` options with an error instead of silently ignoring all but the + last one. + +* :prop_tgt:`AUTOMOC` now diagnoses name collisions when multiple source + files in different directories use ``#include `` with the + same name (because the generated ``moc_foo.cpp`` files would collide). * The :module:`FindBISON` module ``BISON_TARGET`` macro now supports special characters by passing the ``VERBATIM`` option to internal @@ -194,83 +296,20 @@ Changes made since CMake 3.5 include the following. :command:`add_custom_command` calls. This may break clients that added escaping manually to work around the bug. -* The :command:`install` command learned a new ``EXCLUDE_FROM_ALL`` option - to leave installation rules out of the default installation. - -* The :module:`InstallRequiredSystemLibraries` module learned a new - ``CMAKE_INSTALL_UCRT_LIBRARIES`` option to enable app-local deployment - of the Windows Universal CRT libraries with Visual Studio 2015. - -* The :manual:`Compile Features ` functionality - is now aware of features supported by Intel C++ compilers versions 12.1 - through 16.0 on UNIX platforms. - -* The :command:`list` command gained a ``FILTER`` sub-command to filter - list elements by regular expression. - -* The :generator:`Ninja` generator now includes system header files in build - dependencies to ensure correct re-builds when system packages are updated. - -* The :generator:`Ninja` generator learned to produce phony targets - of the form ``sub/dir/all`` to drive the build of a subdirectory. - This is equivalent to ``cd sub/dir; make all`` with - :ref:`Makefile Generators`. - -* The :generator:`Ninja` generator learned to read a new - :variable:`CMAKE_NINJA_OUTPUT_PATH_PREFIX` variable to configure - the generated ``build.ninja`` file for use as a ``subninja``. - -* The :generator:`Visual Studio 6` generator has been removed. - -* The :generator:`Visual Studio 7` generator (for VS .NET 2002) has been - removed. - -* A :variable:`CMAKE__STANDARD_INCLUDE_DIRECTORIES` variable was - added for use by toolchain files to specify system include directories - to be appended to all compiler command lines. - -* CTest learned to optionally enforce a secondary timeout after matching - certain output from a test. See the :prop_test:`TIMEOUT_AFTER_MATCH` test - property. - -* The :command:`try_compile` command source file signature now honors - configuration-specific flags (e.g. :variable:`CMAKE__FLAGS_DEBUG`) - in the generated test project. Previously only the default such flags - for the current toolchain were used. - -* A :variable:`CMAKE_TRY_COMPILE_PLATFORM_VARIABLES` variable was - added for use by toolchain files to specify platform-specific - variables that must be propagated by the :command:`try_compile` - command into test projects. - -* The :command:`try_compile` command learned to check a new - :variable:`CMAKE_TRY_COMPILE_TARGET_TYPE` variable to optionally - build a static library instead of an executable. This is useful - for cross-compiling toolchains that cannot link binaries without - custom flags or scripts. - -* The :command:`string(TIMESTAMP)` and :command:`file(TIMESTAMP)` - commands gained support for the ``%s`` placeholder. This is - the number of seconds since the UNIX Epoch. - -* The precompiled OS X binary provided on ``cmake.org`` now requires - OS X 10.7 or newer. - -* The :generator:`Visual Studio 7 .NET 2003` generator is now - deprecated and will be removed in a future version of CMake. - -* The :generator:`Visual Studio 14 2015` generator learned to support the - Clang/C2 toolsets, e.g. with the ``-T v140_clang_3_7`` option. - -* The :generator:`Visual Studio 9 2008` and :generator:`Visual Studio 8 2005` - generators learned to generate the remote directory for WinCE project - deployment and debugger settings. See the - :prop_tgt:`DEPLOYMENT_REMOTE_DIRECTORY` target property. - -* The :ref:`Visual Studio Generators` learned to honor a new - :prop_dir:`VS_STARTUP_PROJECT` directory property that specifies - the default startup project for generated solutions (``.sln`` files). +* The :module:`FindProtobuf` module input and output variables were all renamed + from ``PROTOBUF_`` to ``Protobuf_`` for consistency with other find modules. + Input variables of the old case will be honored if provided, and output + variables of the old case are always provided. -* :ref:`Visual Studio Generators` for VS 2010 and above learned a new - :prop_tgt:`VS_CONFIGURATION_TYPE` target property to specify a custom - project file type. +* The :module:`CPackRPM` module now supports upper cased component + names in per component CPackRPM specific variables. + E.g. component named ``foo`` now expects component specific + variable to be ``CPACK_RPM_FOO_PACKAGE_NAME`` while before + it expected ``CPACK_RPM_foo_PACKAGE_NAME``. + Upper cased component name part in variables is compatible + with convention used for other CPack variables. + For back compatibility old format of variables is still valid + and preferred if both versions of variable are set, but the + preferred future use is upper cased component names in variables. + New variables that will be added to CPackRPM in later versions + will only support upper cased component variable format. -- cgit v0.12