Merge topic 'doc-3.6-relnotes'
98eafa9bHelp: Organize and revise 3.6 release notesc5df7483Help: Consolidate 3.6 release notes
This commit is contained in:
Brad King
CMake Topic Stage
commit
9d81f1b3aa
|
|
@ -0,0 +1,315 @@
|
||||||
|
CMake 3.6 Release Notes
|
||||||
|
***********************
|
||||||
|
|
||||||
|
.. only:: html
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
Changes made since CMake 3.5 include the following.
|
||||||
|
|
||||||
|
New Features
|
||||||
|
============
|
||||||
|
|
||||||
|
Generators
|
||||||
|
----------
|
||||||
|
|
||||||
|
* 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_<LANG>_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_<LANG>_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_<LANG>_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:`<LANG>_CLANG_TIDY` target property and supporting
|
||||||
|
:variable:`CMAKE_<LANG>_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.
|
||||||
|
|
||||||
|
* 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 :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 :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 <http://www.openblas.net>`__.
|
||||||
|
|
||||||
|
* 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.
|
||||||
|
|
||||||
|
* 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_<compName>_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::
|
||||||
|
|
||||||
|
<PackageName>_<VersionNumber>-<DebianRevisionNumber>_<DebianArchitecture>.deb
|
||||||
|
|
||||||
|
For backward compatibility this feature is disabled by default. See
|
||||||
|
:variable:`CPACK_DEBIAN_FILE_NAME` and
|
||||||
|
:variable:`CPACK_DEBIAN_<COMPONENT>_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_<COMPONENT>_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 :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
|
||||||
|
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_<component>_PACKAGE_NAME`.
|
||||||
|
|
||||||
|
* The :module:`CPackRPM` module learned how to correctly handle symlinks
|
||||||
|
that are pointing outside generated packages.
|
||||||
|
|
||||||
|
Other
|
||||||
|
-----
|
||||||
|
|
||||||
|
* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
|
||||||
|
is now aware of features supported by Intel C++ compilers versions 12.1
|
||||||
|
through 16.0 on UNIX platforms.
|
||||||
|
|
||||||
|
Deprecated and Removed Features
|
||||||
|
===============================
|
||||||
|
|
||||||
|
* The :module:`CMakeForceCompiler` module and its macros are now deprecated.
|
||||||
|
See module documentation for an explanation.
|
||||||
|
|
||||||
|
* 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 ``<prefix>/bin`` directories in the ``PATH`` just for
|
||||||
|
their tools do not necessarily want any supporting ``<prefix>/lib``
|
||||||
|
directories searched. One may set the ``CMAKE_PREFIX_PATH`` environment
|
||||||
|
variable with a :ref:`;-list <CMake Language Lists>` of prefixes that are
|
||||||
|
to be searched.
|
||||||
|
|
||||||
|
* 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 7` generator (for VS .NET 2002) has been
|
||||||
|
removed. It had been deprecated since CMake 3.3.
|
||||||
|
|
||||||
|
* The :generator:`Visual Studio 6` generator has been removed.
|
||||||
|
It had been deprecated since CMake 3.3.
|
||||||
|
|
||||||
|
Other Changes
|
||||||
|
=============
|
||||||
|
|
||||||
|
* 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 <moc_foo.cpp>`` 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
|
||||||
|
: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 :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:`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.
|
||||||
|
|
@ -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`.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
FindCUDA-cublas_device
|
|
||||||
----------------------
|
|
||||||
|
|
||||||
* The :module:`FindCUDA` module learned to find the ``cublas_device`` library.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
FindPkgConfig-targets
|
|
||||||
---------------------
|
|
||||||
|
|
||||||
* The :module:`FindPkgConfig` module learned to optionally create imported
|
|
||||||
targets for the libraries it has found.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
add-FindLTTngUST
|
|
||||||
----------------
|
|
||||||
|
|
||||||
* The :module:`FindLTTngUST` module was introduced to find the LTTng-UST
|
|
||||||
library.
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
add-bruce-c
|
|
||||||
-----------
|
|
||||||
|
|
||||||
* Support was added for the Bruce C Compiler with compiler id ``Bruce``.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
automoc-diagnostics
|
|
||||||
-------------------
|
|
||||||
|
|
||||||
* :prop_tgt:`AUTOMOC` now diagnoses name collisions when multiple source
|
|
||||||
files in different directories use ``#include <moc_foo.cpp>`` with the
|
|
||||||
same name (because the generated ``moc_foo.cpp`` files would collide).
|
|
||||||
|
|
@ -1,7 +0,0 @@
|
||||||
clang-tidy
|
|
||||||
----------
|
|
||||||
|
|
||||||
* A :prop_tgt:`<LANG>_CLANG_TIDY` target property and supporting
|
|
||||||
:variable:`CMAKE_<LANG>_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.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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_<compName>_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::
|
|
||||||
|
|
||||||
<PackageName>_<VersionNumber>-<DebianRevisionNumber>_<DebianArchitecture>.deb
|
|
||||||
|
|
||||||
For backward compatibility this feature is disabled by default. See
|
|
||||||
:variable:`CPACK_DEBIAN_FILE_NAME` and
|
|
||||||
:variable:`CPACK_DEBIAN_<COMPONENT>_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_<COMPONENT>_PACKAGE_ARCHITECTURE`.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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`.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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_<component>_PACKAGE_NAME`.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
cpack-rpm-external-symlink-handling
|
|
||||||
-----------------------------------
|
|
||||||
|
|
||||||
* The "CPackRPM" module learned how to correctly handle symlinks
|
|
||||||
that are pointing outside generated packages.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
cygwin-clang
|
|
||||||
------------
|
|
||||||
|
|
||||||
* The Clang compiler is now supported on CYGWIN.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
deprecate-CMakeForceCompiler
|
|
||||||
----------------------------
|
|
||||||
|
|
||||||
* The :module:`CMakeForceCompiler` module and its macros are now deprecated.
|
|
||||||
See module documentation for an explanation.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
doc-standard-libs
|
|
||||||
-----------------
|
|
||||||
|
|
||||||
* The :variable:`CMAKE_<LANG>_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.
|
|
||||||
|
|
@ -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`.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
ep-tls-verify-git
|
|
||||||
-----------------
|
|
||||||
|
|
||||||
* The :module:`ExternalProject` module now uses ``TLS_VERIFY`` when fetching
|
|
||||||
from git repositories.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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).
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
find-blas-lapack-OpenBLAS
|
|
||||||
-------------------------
|
|
||||||
|
|
||||||
* The :module:`FindBLAS` and :module:`FindLAPACK` modules learned to
|
|
||||||
support `OpenBLAS <http://www.openblas.net>`__.
|
|
||||||
|
|
@ -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 ``<prefix>/bin`` directories in the ``PATH`` just for
|
|
||||||
their tools do not necessarily want any supporting ``<prefix>/lib``
|
|
||||||
directories searched. One may set the ``CMAKE_PREFIX_PATH`` environment
|
|
||||||
variable with a :ref:`;-list <CMake Language Lists>` of prefixes that are
|
|
||||||
to be searched.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
intel-compiler-features
|
|
||||||
-----------------------
|
|
||||||
|
|
||||||
* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
|
|
||||||
is now aware of features supported by Intel C++ compilers versions 12.1
|
|
||||||
through 16.0 on UNIX platforms.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
list-FILTER-command
|
|
||||||
-------------------
|
|
||||||
|
|
||||||
* The :command:`list` command gained a ``FILTER`` sub-command to filter
|
|
||||||
list elements by regular expression.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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`.
|
|
||||||
|
|
@ -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``.
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
remove-vs6-generator
|
|
||||||
--------------------
|
|
||||||
|
|
||||||
* The :generator:`Visual Studio 6` generator has been removed.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
remove-vs7.0-generator
|
|
||||||
----------------------
|
|
||||||
|
|
||||||
* The :generator:`Visual Studio 7` generator (for VS .NET 2002) has been
|
|
||||||
removed.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
standard-include-directories
|
|
||||||
----------------------------
|
|
||||||
|
|
||||||
* A :variable:`CMAKE_<LANG>_STANDARD_INCLUDE_DIRECTORIES` variable was
|
|
||||||
added for use by toolchain files to specify system include directories
|
|
||||||
to be appended to all compiler command lines.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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_<LANG>_FLAGS_DEBUG`)
|
|
||||||
in the generated test project. Previously only the default such flags
|
|
||||||
for the current toolchain were used.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
update-osx-release
|
|
||||||
------------------
|
|
||||||
|
|
||||||
* The precompiled OS X binary provided on ``cmake.org`` now requires
|
|
||||||
OS X 10.7 or newer.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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).
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -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.
|
|
||||||
|
|
@ -13,6 +13,7 @@ Releases
|
||||||
.. toctree::
|
.. toctree::
|
||||||
:maxdepth: 1
|
:maxdepth: 1
|
||||||
|
|
||||||
|
3.6 <3.6>
|
||||||
3.5 <3.5>
|
3.5 <3.5>
|
||||||
3.4 <3.4>
|
3.4 <3.4>
|
||||||
3.3 <3.3>
|
3.3 <3.3>
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue