Merge topic 'doc-3.4-relnotes'
19ce56e2Help: Organize and revise 3.4 release notesc922aa18Help: Consolidate 3.4 release notes
This commit is contained in:
Brad King
CMake Topic Stage
commit
3187de20fd
|
|
@ -0,0 +1,269 @@
|
||||||
|
CMake 3.4 Release Notes
|
||||||
|
***********************
|
||||||
|
|
||||||
|
.. only:: html
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
Changes made since CMake 3.4 include the following.
|
||||||
|
|
||||||
|
New Features
|
||||||
|
============
|
||||||
|
|
||||||
|
Generators
|
||||||
|
----------
|
||||||
|
|
||||||
|
* The :generator:`Visual Studio 14 2015` generator learned to select
|
||||||
|
a Windows 10 SDK based on the value of the :variable:`CMAKE_SYSTEM_VERSION`
|
||||||
|
variable and the SDKs available on the host.
|
||||||
|
|
||||||
|
* CMake learned rudimentary support for the Apple Swift language. When using
|
||||||
|
the :generator:`Xcode` generator with Xcode 6.1 or higher, one may enable
|
||||||
|
the ``Swift`` language with the :command:`enable_language` command or the
|
||||||
|
:command:`project` command (this is an error with other generators or when
|
||||||
|
Xcode is too old). Then one may list ``.swift`` source files in targets
|
||||||
|
for compilation.
|
||||||
|
|
||||||
|
Commands
|
||||||
|
--------
|
||||||
|
|
||||||
|
* The :command:`find_program` command learned a ``NAMES_PER_DIR``
|
||||||
|
option to consider all given ``NAMES`` in each directory before
|
||||||
|
moving on to the next directory.
|
||||||
|
|
||||||
|
* The :command:`get_filename_component` command learned a new ``BASE_DIR``
|
||||||
|
subcommand. This is used to specify a base directory when calculating an
|
||||||
|
absolute path from a relative path.
|
||||||
|
|
||||||
|
* The :command:`if` command learned a new ``TEST`` operator that evaluates
|
||||||
|
to true if a given test name has been defined by the :command:`add_test`
|
||||||
|
command. See policy :policy:`CMP0064`.
|
||||||
|
|
||||||
|
* The :command:`install(DIRECTORY)` command ``DESTINATION`` option learned to
|
||||||
|
support :manual:`generator expressions <cmake-generator-expressions(7)>`.
|
||||||
|
|
||||||
|
* The :command:`install(FILES)` command ``DESTINATION`` option learned to
|
||||||
|
support :manual:`generator expressions <cmake-generator-expressions(7)>`.
|
||||||
|
|
||||||
|
* The :command:`string` command learned a new ``APPEND`` subcommand.
|
||||||
|
|
||||||
|
Variables
|
||||||
|
---------
|
||||||
|
|
||||||
|
* The :ref:`Makefile Generators` and the :generator:`Ninja` generator
|
||||||
|
learned to add compiler launcher tools like distcc and ccache along
|
||||||
|
with the compiler for ``C`` and ``CXX`` languages. See the
|
||||||
|
:variable:`CMAKE_<LANG>_COMPILER_LAUNCHER` variable and
|
||||||
|
:prop_tgt:`<LANG>_COMPILER_LAUNCHER` target property for details.
|
||||||
|
|
||||||
|
* New :variable:`CMAKE_LINK_SEARCH_START_STATIC` and
|
||||||
|
:variable:`CMAKE_LINK_SEARCH_END_STATIC` variables were
|
||||||
|
introduced to initialize the
|
||||||
|
:prop_tgt:`LINK_SEARCH_START_STATIC` and
|
||||||
|
:prop_tgt:`LINK_SEARCH_END_STATIC` target properties,
|
||||||
|
respectively.
|
||||||
|
|
||||||
|
Properties
|
||||||
|
----------
|
||||||
|
|
||||||
|
* :ref:`Visual Studio Generators` learned to support additonal
|
||||||
|
target properties to customize projects for NVIDIA Nsight
|
||||||
|
Tegra Visual Studio Edition:
|
||||||
|
|
||||||
|
* :prop_tgt:`ANDROID_ANT_ADDITIONAL_OPTIONS`
|
||||||
|
* :prop_tgt:`ANDROID_ARCH`
|
||||||
|
* :prop_tgt:`ANDROID_ASSETS_DIRECTORIES`
|
||||||
|
* :prop_tgt:`ANDROID_JAR_DEPENDENCIES`
|
||||||
|
* :prop_tgt:`ANDROID_JAR_DIRECTORIES`
|
||||||
|
* :prop_tgt:`ANDROID_JAVA_SOURCE_DIR`
|
||||||
|
* :prop_tgt:`ANDROID_NATIVE_LIB_DEPENDENCIES`
|
||||||
|
* :prop_tgt:`ANDROID_NATIVE_LIB_DIRECTORIES`
|
||||||
|
* :prop_tgt:`ANDROID_PROCESS_MAX`
|
||||||
|
* :prop_tgt:`ANDROID_PROGUARD`
|
||||||
|
* :prop_tgt:`ANDROID_PROGUARD_CONFIG_PATH`
|
||||||
|
* :prop_tgt:`ANDROID_SECURE_PROPS_PATH`
|
||||||
|
* :prop_tgt:`ANDROID_SKIP_ANT_STEP`
|
||||||
|
* :prop_tgt:`ANDROID_STL_TYPE`
|
||||||
|
|
||||||
|
* The :prop_tgt:`ARCHIVE_OUTPUT_DIRECTORY`,
|
||||||
|
:prop_tgt:`LIBRARY_OUTPUT_DIRECTORY`, and
|
||||||
|
:prop_tgt:`RUNTIME_OUTPUT_DIRECTORY` target properties learned to
|
||||||
|
support :manual:`generator expressions <cmake-generator-expressions(7)>`.
|
||||||
|
|
||||||
|
* The :prop_tgt:`SOURCE_DIR` and :prop_tgt:`BINARY_DIR` target properties
|
||||||
|
were introduced to allow project code to query where a target is defined.
|
||||||
|
|
||||||
|
* The :prop_tgt:`OUTPUT_NAME` target property and its variants learned to
|
||||||
|
support :manual:`generator expressions <cmake-generator-expressions(7)>`.
|
||||||
|
|
||||||
|
* A :prop_gbl:`TARGET_MESSAGES` global property was added to tell the
|
||||||
|
:ref:`Makefile Generators` whether to generate commands to print output
|
||||||
|
after each target is completed.
|
||||||
|
|
||||||
|
* On Windows with MS-compatible tools, CMake learned to optionally
|
||||||
|
generate a module definition (``.def``) file for ``SHARED`` libraries.
|
||||||
|
See the :prop_tgt:`WINDOWS_EXPORT_ALL_SYMBOLS` target property.
|
||||||
|
|
||||||
|
Modules
|
||||||
|
-------
|
||||||
|
|
||||||
|
* The :module:`ExternalProject` module :command:`ExternalProject_Add`
|
||||||
|
function ``GIT_SUBMODULES`` option now also limits the set of
|
||||||
|
submodules that are initialized in addition to the prior behavior
|
||||||
|
of limiting the set of submodules that are updated.
|
||||||
|
|
||||||
|
* The :module:`ExternalProject` module learned new ``USES_TERMINAL``
|
||||||
|
arguments for giving steps exclusive terminal access. This is
|
||||||
|
useful with the :generator:`Ninja` generator to monitor CMake
|
||||||
|
superbuild progress and prevent CPU oversubscription.
|
||||||
|
|
||||||
|
* The :module:`FindBISON` module ``BISON_TARGET`` macro learned a
|
||||||
|
new ``DEFINES_FILE`` option to specify a custom output header
|
||||||
|
to be generated.
|
||||||
|
|
||||||
|
* The :module:`FindHDF5` module learend a new ``HDF5_PREFER_PARALLEL``
|
||||||
|
option allowing users to specify that a parallel HDF5 tool is
|
||||||
|
preferred if both are available.
|
||||||
|
|
||||||
|
* The :module:`FindIce` module now provides imported targets.
|
||||||
|
|
||||||
|
* The :module:`FindJava` module learned to optionally find
|
||||||
|
the ``idlj`` and ``jarsigner`` tools.
|
||||||
|
|
||||||
|
* The :module:`FindOpenSSL` module now provides imported targets.
|
||||||
|
|
||||||
|
* The :module:`FindOpenSSL` module learned a new ``OPENSSL_USE_STATIC_LIBS``
|
||||||
|
option to search only for static libraries.
|
||||||
|
|
||||||
|
* The :module:`FindPkgConfig` learned a new :command:`pkg_get_variable`
|
||||||
|
command which may be used to query for arbitrary variables from a package
|
||||||
|
(such as for related tools or data and plugin install paths).
|
||||||
|
|
||||||
|
* The :module:`FindProtobuf` module gained a new
|
||||||
|
:command:`protobuf_generate_python` function to generate python
|
||||||
|
sources from ``.proto`` files.
|
||||||
|
|
||||||
|
* The :module:`FindTIFF` module learned to search separately for
|
||||||
|
debug and release variants.
|
||||||
|
|
||||||
|
* The :module:`FindwxWidgets` module learned to support version requests.
|
||||||
|
|
||||||
|
* The :module:`FindXercesC` module learned to search separately for
|
||||||
|
debug and release variants.
|
||||||
|
|
||||||
|
* The :module:`FindZLIB` module learned to search separately for
|
||||||
|
debug and release variants.
|
||||||
|
|
||||||
|
* The :module:`GNUInstallDirs` module learned special default values
|
||||||
|
for certain installation prefixes according to the `GNU Coding
|
||||||
|
Standards`_ and the `Filesystem Hierarchy Standard`_.
|
||||||
|
|
||||||
|
* The :module:`UseJava` module ``add_jar`` function learned
|
||||||
|
to support response files (e.g. ``@srcs.txt``) for source
|
||||||
|
specification.
|
||||||
|
|
||||||
|
* The :module:`UseJava` module ``install_jar`` function learned
|
||||||
|
new ``DESTINATION`` and ``COMPONENT`` options to specify
|
||||||
|
the corresponding :command:`install` command options.
|
||||||
|
|
||||||
|
* The :module:`UseJava` module gained a new ``create_javah``
|
||||||
|
function to create C headers from Java classes.
|
||||||
|
|
||||||
|
.. _`GNU Coding Standards`: https://www.gnu.org/prep/standards/html_node/Directory-Variables.html
|
||||||
|
.. _`Filesystem Hierarchy Standard`: https://refspecs.linuxfoundation.org/FHS_3.0/fhs/index.html
|
||||||
|
|
||||||
|
Generator Expressions
|
||||||
|
---------------------
|
||||||
|
|
||||||
|
* A new ``$<SHELL_PATH:...>``
|
||||||
|
:manual:`generator expression <cmake-generator-expressions(7)>`
|
||||||
|
has been added.
|
||||||
|
|
||||||
|
CTest
|
||||||
|
-----
|
||||||
|
|
||||||
|
* CTest learned to optionally measure the CPU load during parallel
|
||||||
|
testing and avoid starting tests that may cause the load to exceed
|
||||||
|
a given threshold. See the :manual:`ctest(1)` command ``--test-load``
|
||||||
|
option, the ``TestLoad`` setting of the :ref:`CTest Test Step`,
|
||||||
|
the :variable:`CTEST_TEST_LOAD` variable, and the ``TEST_LOAD``
|
||||||
|
option of the :command:`ctest_test` command.
|
||||||
|
|
||||||
|
* :manual:`ctest(1)` learned options
|
||||||
|
``--test-output-size-passed`` and ``--test-output-size-failed``
|
||||||
|
to customize the limit on test output size submitted when
|
||||||
|
running as a :ref:`Dashboard Client`.
|
||||||
|
|
||||||
|
CPack
|
||||||
|
-----
|
||||||
|
|
||||||
|
* The :module:`CPackDeb` module learned to set package dependencies
|
||||||
|
per component. See variables:
|
||||||
|
|
||||||
|
* :variable:`CPACK_DEBIAN_<COMPONENT>_PACKAGE_BREAKS`
|
||||||
|
* :variable:`CPACK_DEBIAN_<COMPONENT>_PACKAGE_CONFLICTS`
|
||||||
|
* :variable:`CPACK_DEBIAN_<COMPONENT>_PACKAGE_ENHANCES`
|
||||||
|
* :variable:`CPACK_DEBIAN_<COMPONENT>_PACKAGE_PREDEPENDS`
|
||||||
|
* :variable:`CPACK_DEBIAN_<COMPONENT>_PACKAGE_PROVIDES`
|
||||||
|
* :variable:`CPACK_DEBIAN_<COMPONENT>_PACKAGE_RECOMMENDS`
|
||||||
|
* :variable:`CPACK_DEBIAN_<COMPONENT>_PACKAGE_REPLACES`
|
||||||
|
* :variable:`CPACK_DEBIAN_<COMPONENT>_PACKAGE_SUGGESTS`
|
||||||
|
|
||||||
|
* The :module:`CPack` module learned to package empty directories.
|
||||||
|
|
||||||
|
* The :module:`CPack` module gained a new setting, ``CPACK_VERBATIM_VARIABLES``,
|
||||||
|
which can be used to ensure the cpack program receives the settings' values
|
||||||
|
exactly as they were set, even if they contain CMake-special characters.
|
||||||
|
For compatibility, it's off by default.
|
||||||
|
|
||||||
|
Other
|
||||||
|
-----
|
||||||
|
|
||||||
|
* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
|
||||||
|
is now aware of features supported by GNU C compilers on Windows.
|
||||||
|
|
||||||
|
* CMake learned to honor ``*.manifest`` source files with MSVC tools.
|
||||||
|
Manifest files named as sources of ``.exe`` and ``.dll`` targets
|
||||||
|
will be merged with linker-generated manifests and embedded in the
|
||||||
|
binary.
|
||||||
|
|
||||||
|
* The `Concurrent Fortran 77 <https://ccur.com>`__ compiler is now supported.
|
||||||
|
Its :variable:`compiler id <CMAKE_<LANG>_COMPILER_ID>` is ``CCur``.
|
||||||
|
|
||||||
|
* :manual:`cmake(1)` gained a new ``--trace-expand`` command line option
|
||||||
|
that is like ``--trace`` but expands variable references in the output.
|
||||||
|
|
||||||
|
Deprecated and Removed Features
|
||||||
|
===============================
|
||||||
|
|
||||||
|
* The :module:`CMakeExpandImportedTargets` module is now documented
|
||||||
|
as deprecated. See module documentation for an explanation.
|
||||||
|
|
||||||
|
* The :variable:`CMAKE_USE_RELATIVE_PATHS` variable no longer has any
|
||||||
|
effect. Previously it was partially implemented and unreliable.
|
||||||
|
|
||||||
|
Other Changes
|
||||||
|
=============
|
||||||
|
|
||||||
|
* The :module:`CheckFunctionExists`, :module:`CheckLibraryExists`,
|
||||||
|
:module:`CheckSymbolExists`, and :module:`FindThreads` modules learned to
|
||||||
|
work in environments where only CXX is enabled.
|
||||||
|
|
||||||
|
* The :module:`CPackDeb` module now correctly excludes symlinks during package
|
||||||
|
checksum calculation.
|
||||||
|
|
||||||
|
* The :module:`CPackDeb` no longer uses fakeroot and system tar program for
|
||||||
|
packaging.
|
||||||
|
|
||||||
|
* The :module:`CPack` module no longer mangles settings with CMake-special
|
||||||
|
characters when they're used as defaults for other settings. The macro
|
||||||
|
``cpack_set_if_not_set``, which was responsible for this, is now deprecated.
|
||||||
|
|
||||||
|
* CMake no longer links executables with flags to export symbols
|
||||||
|
unless the :prop_tgt:`ENABLE_EXPORTS` target property is set.
|
||||||
|
See policy :policy:`CMP0065`.
|
||||||
|
|
||||||
|
* The ``SONAME`` field is no longer set for ``MODULE`` libraries
|
||||||
|
created with the :command:`add_library` command. ``MODULE``
|
||||||
|
libraries are meant for explicit dynamic loading at runtime.
|
||||||
|
They cannot be linked so ``SONAME`` is not useful.
|
||||||
|
|
@ -1,11 +0,0 @@
|
||||||
CPack-updates
|
|
||||||
-------------
|
|
||||||
|
|
||||||
* The :module:`CPack` module no longer mangles settings with CMake-special
|
|
||||||
characters when they're used as defaults for other settings. The macro
|
|
||||||
``cpack_set_if_not_set``, which was responsible for this, is now deprecated.
|
|
||||||
|
|
||||||
* The :module:`CPack` module gained a new setting, ``CPACK_VERBATIM_VARIABLES``,
|
|
||||||
which can be used to ensure the cpack program receives the settings' values
|
|
||||||
exactly as they were set, even if they contain CMake-special characters.
|
|
||||||
For compatibility, it's off by default.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
ConcurrentFortran-compiler-id
|
|
||||||
-----------------------------
|
|
||||||
|
|
||||||
* The `Concurrent Fortran 77 <https://ccur.com>`__ compiler is now supported.
|
|
||||||
Its :variable:`compiler id <CMAKE_<LANG>_COMPILER_ID>` is ``CCur``.
|
|
||||||
|
|
@ -1,7 +0,0 @@
|
||||||
ExternalProject-USES_TERMINAL
|
|
||||||
-----------------------------
|
|
||||||
|
|
||||||
* The :module:`ExternalProject` module learned new ``USES_TERMINAL``
|
|
||||||
arguments for giving steps exclusive terminal access. Especially
|
|
||||||
useful with the :generator:`Ninja` generator to monitor CMake
|
|
||||||
superbuild progress and prevent CPU oversubscription.
|
|
||||||
|
|
@ -1,7 +0,0 @@
|
||||||
ExternalProject_init_selected_submodules
|
|
||||||
----------------------------------------
|
|
||||||
|
|
||||||
* The :module:`ExternalProject` module :command:`ExternalProject_Add`
|
|
||||||
function ``GIT_SUBMODULES`` option now also limits the set of
|
|
||||||
submodules that are initialized in addition to the prior behavior
|
|
||||||
of limiting the set of submodules that are updated.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
ExternalProject_stash_save_all
|
|
||||||
------------------------------
|
|
||||||
|
|
||||||
* Use "git stash save --all" only if supported. The --all option for git-stash
|
|
||||||
wasn't introduced until git version 1.7.6.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
FindBISON-DEFINES_FILE
|
|
||||||
----------------------
|
|
||||||
|
|
||||||
* The :module:`FindBISON` module ``BISON_TARGET`` macro learned a
|
|
||||||
new ``DEFINES_FILE`` option to specify a custom output header
|
|
||||||
to be generated.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
FindHDF5-updates
|
|
||||||
----------------
|
|
||||||
|
|
||||||
* The :module:`FindHDF5` module learend a new ``HDF5_PREFER_PARALLEL``
|
|
||||||
option allowing users to specify that a parallel HDF5 tool is
|
|
||||||
preferred if both are available.
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
FindIce-imported-targets
|
|
||||||
------------------------
|
|
||||||
|
|
||||||
* The :module:`FindIce` module now provides imported targets.
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
FindOpenSSL-imported-targets
|
|
||||||
----------------------------
|
|
||||||
|
|
||||||
* The :module:`FindOpenSSL` module now provides imported targets.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
FindOpenSSL-static-libs
|
|
||||||
-----------------------
|
|
||||||
|
|
||||||
* The :module:`FindOpenSSL` module learned a new ``OPENSSL_USE_STATIC_LIBS``
|
|
||||||
option to search only for static libraries.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
FindProtobuf-python-extension
|
|
||||||
-----------------------------
|
|
||||||
|
|
||||||
* The :module:`FindProtobuf` module gained a new
|
|
||||||
:command:`protobuf_generate_python` function to generate python
|
|
||||||
sources from ``.proto`` files.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
FindTIFF-updates
|
|
||||||
----------------
|
|
||||||
|
|
||||||
* The :module:`FindTIFF` module learned to search separately for
|
|
||||||
debug and release variants.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
FindXercesC-updates
|
|
||||||
-------------------
|
|
||||||
|
|
||||||
* The :module:`FindXercesC` module learned to search separately for
|
|
||||||
debug and release variants.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
FindZLIB-per-config
|
|
||||||
-------------------
|
|
||||||
|
|
||||||
* The :module:`FindZLIB` module learned to search separately for
|
|
||||||
debug and release variants.
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
FindwxWidgets-updates
|
|
||||||
---------------------
|
|
||||||
|
|
||||||
* The :module:`FindwxWidgets` module learned to support version requests.
|
|
||||||
|
|
@ -1,9 +0,0 @@
|
||||||
GNUInstallDirs-special-prefixes
|
|
||||||
-------------------------------
|
|
||||||
|
|
||||||
* The :module:`GNUInstallDirs` module learned special default values
|
|
||||||
for certain installation prefixes according to the `GNU Coding
|
|
||||||
Standards`_ and the `Filesystem Hierarchy Standard`_.
|
|
||||||
|
|
||||||
.. _`GNU Coding Standards`: https://www.gnu.org/prep/standards/html_node/Directory-Variables.html
|
|
||||||
.. _`Filesystem Hierarchy Standard`: https://refspecs.linuxfoundation.org/FHS_3.0/fhs/index.html
|
|
||||||
|
|
@ -1,7 +0,0 @@
|
||||||
OUTPUT_DIRECTORY-genex
|
|
||||||
----------------------
|
|
||||||
|
|
||||||
* The :prop_tgt:`ARCHIVE_OUTPUT_DIRECTORY`,
|
|
||||||
:prop_tgt:`LIBRARY_OUTPUT_DIRECTORY`, and
|
|
||||||
:prop_tgt:`RUNTIME_OUTPUT_DIRECTORY` target properties learned to
|
|
||||||
support :manual:`generator expressions <cmake-generator-expressions(7)>`.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
OUTPUT_NAME-genex
|
|
||||||
-----------------
|
|
||||||
|
|
||||||
* The :prop_tgt:`OUTPUT_NAME` target property and its variants learned to
|
|
||||||
support :manual:`generator expressions <cmake-generator-expressions(7)>`.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
Threads-CXX
|
|
||||||
------------
|
|
||||||
|
|
||||||
* The :module:`CheckFunctionExists`, :module:`CheckLibraryExists`,
|
|
||||||
:module:`CheckSymbolExists`, and :module:`FindThreads` modules learned to
|
|
||||||
work in environments where only CXX is enabled.
|
|
||||||
|
|
@ -1,9 +0,0 @@
|
||||||
add-apple-swift-language
|
|
||||||
------------------------
|
|
||||||
|
|
||||||
* CMake learned rudimentary support for the Apple Swift language. When using
|
|
||||||
the :generator:`Xcode` generator with Xcode 6.1 or higher, one may enable
|
|
||||||
the ``Swift`` language with the :command:`enable_language` command or the
|
|
||||||
:command:`project` command (this is an error with other generators or when
|
|
||||||
Xcode is too old). Then one may list ``.swift`` source files in targets
|
|
||||||
for compilation.
|
|
||||||
|
|
@ -1,9 +0,0 @@
|
||||||
add-link-search-static-properties-defaults
|
|
||||||
------------------------------------------
|
|
||||||
|
|
||||||
* New :variable:`CMAKE_LINK_SEARCH_START_STATIC` and
|
|
||||||
:variable:`CMAKE_LINK_SEARCH_END_STATIC` variables were
|
|
||||||
introduced to initialize the
|
|
||||||
:prop_tgt:`LINK_SEARCH_START_STATIC` and
|
|
||||||
:prop_tgt:`LINK_SEARCH_END_STATIC` target properties,
|
|
||||||
respectively.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
auto_export_dll_symbols
|
|
||||||
-----------------------
|
|
||||||
|
|
||||||
* On Windows with MS-compatible tools, CMake learned to optionally
|
|
||||||
generate a module definition (``.def``) file for ``SHARED`` libraries.
|
|
||||||
See the :prop_tgt:`WINDOWS_EXPORT_ALL_SYMBOLS` target property.
|
|
||||||
|
|
@ -1,8 +0,0 @@
|
||||||
compiler-launcher
|
|
||||||
-----------------
|
|
||||||
|
|
||||||
* The :ref:`Makefile Generators` and the :generator:`Ninja` generator
|
|
||||||
learned to add compiler launcher tools like distcc and ccache along with the
|
|
||||||
compiler for ``C`` and ``CXX`` languages. See the
|
|
||||||
:variable:`CMAKE_<LANG>_COMPILER_LAUNCHER` variable and
|
|
||||||
:prop_tgt:`<LANG>_COMPILER_LAUNCHER` target property for details.
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
cpack-deb-checksum-on-symlinks
|
|
||||||
------------------------------
|
|
||||||
|
|
||||||
* The :module:`CPackDeb` module now correctly excludes symlinks during package checksum calculation.
|
|
||||||
|
|
@ -1,12 +0,0 @@
|
||||||
cpack-deb-component-dependencies
|
|
||||||
--------------------------------
|
|
||||||
|
|
||||||
* The :module:`CPackDeb` module learned to set package dependencies
|
|
||||||
per component. See :variable:`CPACK_DEBIAN_<COMPONENT>_PACKAGE_PREDEPENDS`,
|
|
||||||
:variable:`CPACK_DEBIAN_<COMPONENT>_PACKAGE_ENHANCES`,
|
|
||||||
:variable:`CPACK_DEBIAN_<COMPONENT>_PACKAGE_BREAKS`,
|
|
||||||
:variable:`CPACK_DEBIAN_<COMPONENT>_PACKAGE_CONFLICTS`,
|
|
||||||
:variable:`CPACK_DEBIAN_<COMPONENT>_PACKAGE_PROVIDES`,
|
|
||||||
:variable:`CPACK_DEBIAN_<COMPONENT>_PACKAGE_REPLACES`,
|
|
||||||
:variable:`CPACK_DEBIAN_<COMPONENT>_PACKAGE_RECOMMENDS` and
|
|
||||||
:variable:`CPACK_DEBIAN_<COMPONENT>_PACKAGE_SUGGESTS`.
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
cpack-deb-fakeroot-removal
|
|
||||||
--------------------------
|
|
||||||
|
|
||||||
* :module:`CPackDeb` no longer uses fakeroot and system tar program for packaging.
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
cpack-package-empty-dirs
|
|
||||||
------------------------
|
|
||||||
|
|
||||||
* The :module:`CPack` module learned to package empty directories.
|
|
||||||
|
|
@ -1,7 +0,0 @@
|
||||||
ctest-custom-output-size
|
|
||||||
------------------------
|
|
||||||
|
|
||||||
* :manual:`ctest(1)` learned options
|
|
||||||
``--test-output-size-passed`` and ``--test-output-size-failed``
|
|
||||||
to customize the limit on test output size submitted when
|
|
||||||
running as a :ref:`Dashboard Client`.
|
|
||||||
|
|
@ -1,9 +0,0 @@
|
||||||
ctest-test-load-option
|
|
||||||
----------------------
|
|
||||||
|
|
||||||
* CTest learned to optionally measure the CPU load during parallel
|
|
||||||
testing and avoid starting tests that may cause the load to exceed
|
|
||||||
a given threshold. See the :manual:`ctest(1)` command ``--test-load``
|
|
||||||
option, the ``TestLoad`` setting of the :ref:`CTest Test Step`,
|
|
||||||
the :variable:`CTEST_TEST_LOAD` variable, and the ``TEST_LOAD``
|
|
||||||
option of the :command:`ctest_test` command.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
doc-CMakeExpandImportedTargets-deprecated
|
|
||||||
-----------------------------------------
|
|
||||||
|
|
||||||
* The :module:`CMakeExpandImportedTargets` module is now documented
|
|
||||||
as deprecated. See module documentation for an explanation.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
find_program-NAMES_PER_DIR
|
|
||||||
--------------------------
|
|
||||||
|
|
||||||
* The :command:`find_program` command learned a ``NAMES_PER_DIR``
|
|
||||||
option to consdier all given ``NAMES`` in each directory before
|
|
||||||
moving on to the next directory.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
genex-SHELL_PATH
|
|
||||||
----------------
|
|
||||||
|
|
||||||
* A new ``$<SHELL_PATH:...>``
|
|
||||||
:manual:`generator expression <cmake-generator-expressions(7)>`
|
|
||||||
has been added.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
get-filename-component-base-dir
|
|
||||||
-------------------------------
|
|
||||||
|
|
||||||
* The :command:`get_filename_component` command learned a new ``BASE_DIR``
|
|
||||||
subcommand. This is used to specify a base directory when calculating an
|
|
||||||
absolute path from a relative path.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
if-TEST
|
|
||||||
-------
|
|
||||||
|
|
||||||
* Add a new TEST operator to if() that evaluates to true
|
|
||||||
if a given test name has been defined.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
install-directory-dest-genex
|
|
||||||
----------------------------
|
|
||||||
|
|
||||||
* The :command:`install(DIRECTORY)` command ``DESTINATION`` option learned to
|
|
||||||
support :manual:`generator expressions <cmake-generator-expressions(7)>`.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
install-files-dest-genex
|
|
||||||
------------------------
|
|
||||||
|
|
||||||
* The :command:`install(FILES)` command ``DESTINATION`` option learned to
|
|
||||||
support :manual:`generator expressions <cmake-generator-expressions(7)>`.
|
|
||||||
|
|
@ -1,16 +0,0 @@
|
||||||
java-updates
|
|
||||||
------------
|
|
||||||
|
|
||||||
* The :module:`FindJava` module learned to optionally find
|
|
||||||
the ``idlj`` and ``jarsigner`` tools.
|
|
||||||
|
|
||||||
* The :module:`UseJava` module ``add_jar`` function learned
|
|
||||||
to support response files (e.g. ``@srcs.txt``) for source
|
|
||||||
specification.
|
|
||||||
|
|
||||||
* The :module:`UseJava` module ``install_jar`` function learned
|
|
||||||
new ``DESTINATION`` and ``COMPONENT`` options to specify
|
|
||||||
the corresponding :command:`install` command options.
|
|
||||||
|
|
||||||
* The :module:`UseJava` module gained a new ``create_javah``
|
|
||||||
function to create C headers from Java classes.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
makefile-target-messages
|
|
||||||
------------------------
|
|
||||||
|
|
||||||
* A :prop_gbl:`TARGET_MESSAGES` global property was added to tell the
|
|
||||||
:ref:`Makefile Generators` whether to generate commands to print output
|
|
||||||
after each target is completed.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
mingw-compile-features-C
|
|
||||||
------------------------
|
|
||||||
|
|
||||||
* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
|
|
||||||
is now aware of features supported by GNU C compilers on Windows.
|
|
||||||
|
|
@ -1,7 +0,0 @@
|
||||||
modules-no-soname
|
|
||||||
-----------------
|
|
||||||
|
|
||||||
* The ``SONAME`` field is no longer set for ``MODULE`` libraries
|
|
||||||
created with the :command:`add_library` command. ``MODULE``
|
|
||||||
libraries are meant for explicit dynamic loading at runtime.
|
|
||||||
They cannot be linked so ``SONAME`` is not useful.
|
|
||||||
|
|
@ -1,7 +0,0 @@
|
||||||
ms-manifest-files
|
|
||||||
-----------------
|
|
||||||
|
|
||||||
* CMake learned to honor ``*.manifest`` source files with MSVC tools.
|
|
||||||
Manifest files named as sources of ``.exe`` and ``.dll`` targets
|
|
||||||
will be merged with linker-generated manifests and embedded in the
|
|
||||||
binary.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
pkg-config-variable-function
|
|
||||||
----------------------------
|
|
||||||
|
|
||||||
* The :module:`FindPkgConfig` learned a new :command:`pkg_get_variable`
|
|
||||||
command which may be used to query for arbitrary variables from a package
|
|
||||||
(such as for related tools or data and plugin install paths).
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
remove-CMAKE_USE_RELATIVE_PATHS
|
|
||||||
-------------------------------
|
|
||||||
|
|
||||||
* The :variable:`CMAKE_USE_RELATIVE_PATHS` variable no longer has any
|
|
||||||
effect. Previously it was partially implemented and unreliable.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
restrict-shlib-link-flags-to-enable-exports
|
|
||||||
-------------------------------------------
|
|
||||||
|
|
||||||
* CMake no longer links executables with flags to export symbols
|
|
||||||
unless the :prop_tgt:`ENABLE_EXPORTS` target property is set.
|
|
||||||
See policy :policy:`CMP0065`.
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
string-append
|
|
||||||
-------------
|
|
||||||
|
|
||||||
* The :command:`string` command learned a new ``APPEND`` subcommand.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
target-directory-properties
|
|
||||||
---------------------------
|
|
||||||
|
|
||||||
* The :prop_tgt:`SOURCE_DIR` and :prop_tgt:`BINARY_DIR` target properties
|
|
||||||
were introduced to allow project code to query where a target is defined.
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
trace-expand
|
|
||||||
------------
|
|
||||||
|
|
||||||
* Add ``--trace-expand`` argument to CMake. Acts like ``--trace``, but expands
|
|
||||||
variable references in the output.
|
|
||||||
|
|
@ -1,21 +0,0 @@
|
||||||
vs-nsight-tegra-attributes
|
|
||||||
--------------------------
|
|
||||||
|
|
||||||
* :ref:`Visual Studio Generators` learned to support additonal
|
|
||||||
target properties to customize projects for NVIDIA Nsight
|
|
||||||
Tegra Visual Studio Edition:
|
|
||||||
|
|
||||||
* :prop_tgt:`ANDROID_ANT_ADDITIONAL_OPTIONS`
|
|
||||||
* :prop_tgt:`ANDROID_ARCH`
|
|
||||||
* :prop_tgt:`ANDROID_ASSETS_DIRECTORIES`
|
|
||||||
* :prop_tgt:`ANDROID_JAR_DEPENDENCIES`
|
|
||||||
* :prop_tgt:`ANDROID_JAR_DIRECTORIES`
|
|
||||||
* :prop_tgt:`ANDROID_JAVA_SOURCE_DIR`
|
|
||||||
* :prop_tgt:`ANDROID_NATIVE_LIB_DEPENDENCIES`
|
|
||||||
* :prop_tgt:`ANDROID_NATIVE_LIB_DIRECTORIES`
|
|
||||||
* :prop_tgt:`ANDROID_PROCESS_MAX`
|
|
||||||
* :prop_tgt:`ANDROID_PROGUARD`
|
|
||||||
* :prop_tgt:`ANDROID_PROGUARD_CONFIG_PATH`
|
|
||||||
* :prop_tgt:`ANDROID_SECURE_PROPS_PATH`
|
|
||||||
* :prop_tgt:`ANDROID_SKIP_ANT_STEP`
|
|
||||||
* :prop_tgt:`ANDROID_STL_TYPE`
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
vs-win10-sdk
|
|
||||||
------------
|
|
||||||
|
|
||||||
* The :generator:`Visual Studio 14 2015` generator learned to select
|
|
||||||
a Windows 10 SDK based on the value of the :variable:`CMAKE_SYSTEM_VERSION`
|
|
||||||
variable and the SDKs available on the host.
|
|
||||||
|
|
@ -13,6 +13,7 @@ Releases
|
||||||
.. toctree::
|
.. toctree::
|
||||||
:maxdepth: 1
|
:maxdepth: 1
|
||||||
|
|
||||||
|
3.4 <3.4>
|
||||||
3.3 <3.3>
|
3.3 <3.3>
|
||||||
3.2 <3.2>
|
3.2 <3.2>
|
||||||
3.1 <3.1>
|
3.1 <3.1>
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue