diff --git a/Help/release/3.7.rst b/Help/release/3.7.rst new file mode 100644 index 000000000..97c6f7c98 --- /dev/null +++ b/Help/release/3.7.rst @@ -0,0 +1,309 @@ +CMake 3.7 Release Notes +*********************** + +.. only:: html + + .. contents:: + +Changes made since CMake 3.6 include the following. + +New Features +============ + +Platforms +--------- + +* CMake now supports :ref:`Cross Compiling for Android` with simple + toolchain files. + +* The Clang compiler is now supported on AIX. + +Generators +---------- + +* The :generator:`Ninja` generator learned to conditionally support + Fortran when using a ``ninja`` tool that has the necessary features. + See generator documentation for details. + +* The :generator:`Ninja` generator learned to produce phony targets + of the form ``sub/dir/{test,install,package}`` to drive the build + of a subdirectory installation, test or packaging target. + This is equivalent to ``cd sub/dir; make {test,install,package}`` + with :ref:`Makefile Generators`. + +* The :generator:`Visual Studio 15` generator was added. This is + experimental and based on Preview 4 because this version of VS + has not been released. + +* :ref:`Visual Studio Generators` for VS 2010 and above learned to + place ``.natvis`` source files into VS project files properly. + +* The :generator:`Xcode` generator's rudimentary Swift language support + learned to honor a new :variable:`CMAKE_Swift_LANGUAGE_VERSION` variable + to tell Xcode what version of Swift is used by the source. + +* The :generator:`CodeLite` generator gained a new + :variable:`CMAKE_CODELITE_USE_TARGETS` option + to change project creation from projects to targets. + +Commands +-------- + +* The :command:`add_custom_command` command gained a new ``DEPFILE`` + option that works with the :generator:`Ninja` generator to provide + implicit dependency information to the build tool. + +* The :command:`cmake_parse_arguments` command gained a new ``PARSE_ARGV`` + mode to read arguments directly from ``ARGC`` and ``ARGV#`` + variables inside a :command:`function` body. + +* The :command:`export` command gained an ``ANDROID_MK`` option + to generate ``Android.mk`` files referencing CMake-built + libraries as prebuilts for the Android NDK build system. + +* The :command:`file(DOWNLOAD)` and :command:`file(UPLOAD)` commands gained + ``HTTPHEADER `` and ``USERPWD :`` options. + +* The :command:`find_library` and :command:`find_package` commands learned + to search in ``lib32/`` directories when the build targets a 32-bit + architecture. See the :prop_gbl:`FIND_LIBRARY_USE_LIB32_PATHS` global + property. + +* The :command:`find_package` command gained the possibility of + sorting compatible libraries by ``NAME`` or by ``NATURAL`` sorting by + setting the two new variables :variable:`CMAKE_FIND_PACKAGE_SORT_ORDER` + and :variable:`CMAKE_FIND_PACKAGE_SORT_DIRECTION`. + +* The :command:`if` command gained new boolean comparison operations + ``LESS_EQUAL``, ``GREATER_EQUAL``, ``STRLESS_EQUAL``, ``STRGREATER_EQUAL``, + ``VERSION_LESS_EQUAL``, and ``VERSION_GREATER_EQUAL``. + +* The :command:`install` command gained an ``EXPORT_ANDROID_MK`` + subcommand to install ``Android.mk`` files referencing installed + libraries as prebuilts for the Android NDK build system. + +* The :command:`string(TIMESTAMP)` and :command:`file(TIMESTAMP)` + commands gained support for the ``%a`` and ``%b`` placeholders. + These are the abbreviated weekday and month names. + +* 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. See policy :policy:`CMP0066`. + +Variables +--------- + +* Variable :variable:`CMAKE_FIND_PACKAGE_SORT_ORDER` was added to control + the sorting mode of the :command:`find_package` command. + +* Variable :variable:`CMAKE_FIND_PACKAGE_SORT_DIRECTION` was added to control + the sorting direction the :command:`find_package` command. + +* :variable:`Toolchain files ` may now set a + :variable:`CMAKE__FLAGS_INIT` variable to initialize the + :variable:`CMAKE__FLAGS` cache entry the first time a language is + enabled in a build tree. + +* :variable:`Toolchain files ` may now set + :variable:`CMAKE_EXE_LINKER_FLAGS_INIT`, + :variable:`CMAKE_SHARED_LINKER_FLAGS_INIT`, and + :variable:`CMAKE_MODULE_LINKER_FLAGS_INIT` variables to initialize the + :variable:`CMAKE_EXE_LINKER_FLAGS`, + :variable:`CMAKE_SHARED_LINKER_FLAGS`, and + :variable:`CMAKE_MODULE_LINKER_FLAGS` cache entries the first time + a language is enabled in a build tree. + +Properties +---------- + +* On Apple platforms the :prop_tgt:`BUNDLE_EXTENSION` target property + now also applies to Frameworks and App Bundles. + +* A :prop_dir:`BINARY_DIR` directory property was added to get the + absolute path to the binary directory corresponding to the source + directory on which the property is read. + +* A :prop_dir:`BUILDSYSTEM_TARGETS` directory property was added to + get the list of logical buildsystem target names added by the + project in a directory. + +* A :prop_tgt:`LINK_WHAT_YOU_USE` target property and supporting + :variable:`CMAKE_LINK_WHAT_YOU_USE` variable were introduced + to detect (on UNIX) shared libraries that are linked but not + needed by running ``ldd -r -u``. + +* A :prop_dir:`SOURCE_DIR` directory property was added to get the + absolute path to the source directory associated with a directory. + +* A :prop_dir:`SUBDIRECTORIES` directory property was added to + get the list of subdirectories added by a project in a directory. + +* A :prop_tgt:`VS_SDK_REFERENCES` target property was added to tell + :ref:`Visual Studio Generators` to reference the named SDKs. + +* A :prop_sf:`VS_TOOL_OVERRIDE` source file property was created to tell + :ref:`Visual Studio Generators` what tool to use for a source file. + +* The :prop_tgt:`WINDOWS_EXPORT_ALL_SYMBOLS` target property now applies + to executable targets with the :prop_tgt:`ENABLE_EXPORTS` property set. + +* A :prop_sf:`XCODE_FILE_ATTRIBUTES` source file property was + added to tell the :generator:`Xcode` generator to generate + custom content in the Xcode project attributes for the file. + +Modules +------- + +* An :module:`AndroidTestUtilities` module was added to manage transfer + of test data to an Android device. + +* The :module:`CheckFortranSourceCompiles` module macro + ``CHECK_Fortran_SOURCE_COMPILES`` gained a ``SRC_EXT`` option + to specify a custom test Fortran source file extension. + +* The :module:`ExternalProject` module gained ``HTTP_USERNAME`` and + ``HTTP_PASSWORD`` options to set http download credentials. + +* The :module:`ExternalProject` module gained a ``HTTP_HEADER`` + option to add http download headers. + +* The :module:`FindBISON` module ``BISON_TARGET`` macro learned a new + ``REPORT_FILE`` option to specify the bison ``--report-file=`` option. + +* The :module:`FindBZip2` module now provides imported targets. + +* A :module:`FindICU` module was introduced to find the International + Components for Unicode (ICU) libraries and programs. + +* The :module:`FindMatlab` module learned to find a SIMULINK component. + +* The :module:`FindOpenCL` module now provides imported targets. + +* The :module:`FindOpenMP` module learned to detect the OpenMP + version (specification date) from the compiler. + +* A :module:`FindVulkan` module was added. + +* The :module:`GenerateExportHeader` module learned a new + ``CUSTOM_CONTENT_FROM_VARIABLE`` option to specify a variable + containing custom content for inclusion in the generated header. + +* The :module:`GNUInstallDirs` module gained a new + :command:`GNUInstallDirs_get_absolute_install_dir` command. + +* The :module:`UseJava` module gained APIs to "export" jar targets + for use by external CMake projects. See the ``install_jar_exports`` + and ``export_jars`` functions. + +CTest +----- + +* CTest now supports test fixtures through the new :prop_test:`FIXTURES_SETUP`, + :prop_test:`FIXTURES_CLEANUP` and :prop_test:`FIXTURES_REQUIRED` test + properties. When using regular expressions or ``--rerun-failed`` to limit + the tests to be run, a fixture's setup and cleanup tests will automatically + be added to the execution set if any test requires that fixture. + +* The :command:`ctest_configure`, :command:`ctest_build`, + :command:`ctest_test`, :command:`ctest_coverage`, and :command:`ctest_upload` + commands gained a new ``CAPTURE_CMAKE_ERROR`` option to capture any errors + that occur as the commands run into a variable and avoid affecting the return + code of the :manual:`ctest(1)` process. + +CPack +----- + +* CPack gained a ``productbuild`` generator on OS X, configured by + the :module:`CPackProductBuild` module. + +* CPack gained a new :variable:`CPACK_PACKAGE_CHECKSUM` variable to + enable generation of a checksum file for each package file. + +* The :module:`CPackDeb` module learned to support long file names + when archive format is set to GNU tar. + See :variable:`CPACK_DEBIAN_ARCHIVE_TYPE` + +* The :module:`CPackIFW` module gained a new + :command:`cpack_ifw_add_package_resources` command to include additional + resources in the installer binary. + +* The :module:`CPackIFW` module :command:`cpack_ifw_configure_component` and + :command:`cpack_ifw_configure_component_group` commands gained a new + ``USER_INTERFACES`` option to add a list of additonal pages to the IFW + installer. + +* The :module:`CPackRPM` module learned to generate debuginfo + packages on demand. See :variable:`CPACK_RPM_DEBUGINFO_PACKAGE` + and its per component version. + +* The :module:`CPackRPM` module learned to generate source rpm + (SRPM) packages on demand. See :variable:`CPACK_RPM_PACKAGE_SOURCES`, + :variable:`CPACK_RPM_SOURCE_PKG_BUILD_PARAMS` and + :variable:`CPACK_RPM_SOURCE_PKG_PACKAGING_INSTALL_PREFIX`. + +* The CPack WIX generator now supports + :variable:`CPACK_WIX_SKIP_PROGRAM_FOLDER` to allow specification + of a custom absolute installation prefix outside + of the ProgramFiles folders. + +* The CPack WIX generator now supports + :variable:`CPACK_COMPONENT__DISABLED`. + This can be used to deselect a component from being installed by default. + +* The CPack WIX generator now supports :variable:`CPACK_WIX_PATCH_FILE` + fragments for Feature elements. + +* The CPack WIX generator now supports + :variable:`CPACK_WIX_ROOT_FEATURE_TITLE` and + :variable:`CPACK_WIX_ROOT_FEATURE_DESCRIPTION` to allow the specification + of a custom title and description for the root feature element. + +Other +----- + +* :manual:`cmake(1)` gained a ``-E capabilities`` option to provide a + machine-readable (JSON) description of the capabilities of the + cmake tool (available generators, etc.). + +* A new :manual:`cmake-server(7)` mode was added to provide semantic + information about a CMake-generated buildsystem to clients through + a JSON protocol. Currently all protocols are experimental and subject + to change. + +* The :manual:`cmake(1)` command learned a ``--trace-source=`` option. + +* :manual:`ccmake(1)` learned to support vim-like navigation bindings. + +* :manual:`cmake-gui(1)` gained a button to open the generated project file + for :ref:`Visual Studio Generators` and the :generator:`Xcode` generator. + +Deprecated and Removed Features +=============================== + +* We no longer provide Linux i386 binaries for download from ``cmake.org`` + for new versions of CMake. + +* Vim support files ``cmake-indent.vim``, ``cmake-syntax.vim``, and + ``cmake-help.vim`` have been removed in favor of the files now provided + from the `vim-cmake-syntax`_ project. + +* Support for building CMake itself with some compilers was dropped: + + * Visual Studio 7.1 and 2005 -- superseded by VS 2008 and above + * MinGW.org mingw32 -- superseded by MSYS2 mingw32 and mingw64 + + CMake still supports generating build systems for other projects using + these compilers. + +Other Changes +============= + +* The Fortran dependency scanner learned to support the syntax of + `Fortran Submodules`_. + +* Vim support files ``indent/cmake.vim`` and ``syntax/cmake.vim`` + from the `vim-cmake-syntax`_ project are now distributed with CMake. + +.. _`Fortran Submodules`: http://fortranwiki.org/fortran/show/Submodules +.. _`vim-cmake-syntax`: https://github.com/pboettch/vim-cmake-syntax diff --git a/Help/release/dev/CheckFortranSourceCompiles-custom-ext.rst b/Help/release/dev/CheckFortranSourceCompiles-custom-ext.rst deleted file mode 100644 index bf62812da..000000000 --- a/Help/release/dev/CheckFortranSourceCompiles-custom-ext.rst +++ /dev/null @@ -1,6 +0,0 @@ -CheckFortranSourceCompiles-custom-ext -------------------------------------- - -* The :module:`CheckFortranSourceCompiles` module macro - ``CHECK_Fortran_SOURCE_COMPILES`` gained a ``SRC_EXT`` option - to specify a custom test Fortran source file extension. diff --git a/Help/release/dev/ExternalProject-HTTP_HEADER.rst b/Help/release/dev/ExternalProject-HTTP_HEADER.rst deleted file mode 100644 index 927d1b269..000000000 --- a/Help/release/dev/ExternalProject-HTTP_HEADER.rst +++ /dev/null @@ -1,5 +0,0 @@ -ExternalProject-HTTP_HEADER ---------------------------- - -* The :module:`ExternalProject` module gained a ``HTTP_HEADER`` - option to add http download headers. diff --git a/Help/release/dev/ExternalProject-http-credentials.rst b/Help/release/dev/ExternalProject-http-credentials.rst deleted file mode 100644 index e3a362abc..000000000 --- a/Help/release/dev/ExternalProject-http-credentials.rst +++ /dev/null @@ -1,5 +0,0 @@ -ExternalProject-http-credentials --------------------------------- - -* The :module:`ExternalProject` module gained ``HTTP_USERNAME`` and - ``HTTP_PASSWORD`` options to set http download credentials. diff --git a/Help/release/dev/FindBISON-report-file.rst b/Help/release/dev/FindBISON-report-file.rst deleted file mode 100644 index 0b591284a..000000000 --- a/Help/release/dev/FindBISON-report-file.rst +++ /dev/null @@ -1,5 +0,0 @@ -FindBISON-report-file ---------------------- - -* The :module:`FindBISON` module ``BISON_TARGET`` macro learned a new - ``REPORT_FILE`` option to specify the bison ``--report-file=`` option. diff --git a/Help/release/dev/FindMatlab-simulink.rst b/Help/release/dev/FindMatlab-simulink.rst deleted file mode 100644 index cd25412cb..000000000 --- a/Help/release/dev/FindMatlab-simulink.rst +++ /dev/null @@ -1,4 +0,0 @@ -FindMatlab-simulink -------------------- - -* The :module:`FindMatlab` module learned to find a SIMULINK component. diff --git a/Help/release/dev/FindOpenCL-imported-target.rst b/Help/release/dev/FindOpenCL-imported-target.rst deleted file mode 100644 index 259c745b0..000000000 --- a/Help/release/dev/FindOpenCL-imported-target.rst +++ /dev/null @@ -1,4 +0,0 @@ -FindOpenCL-imported-target --------------------------- - -* The :module:`FindOpenCL` module now provides imported targets. diff --git a/Help/release/dev/FindOpenMP-updates.rst b/Help/release/dev/FindOpenMP-updates.rst deleted file mode 100644 index cb29a711b..000000000 --- a/Help/release/dev/FindOpenMP-updates.rst +++ /dev/null @@ -1,5 +0,0 @@ -FindOpenMP-updates ------------------- - -* The :module:`FindOpenMP` module learned to detect the OpenMP - version (specification date) from the compiler. diff --git a/Help/release/dev/FindVulkan.rst b/Help/release/dev/FindVulkan.rst deleted file mode 100644 index bb5447eff..000000000 --- a/Help/release/dev/FindVulkan.rst +++ /dev/null @@ -1,4 +0,0 @@ -FindVulkan ----------- - -* A :module:`FindVulkan` module was added. diff --git a/Help/release/dev/GNUInstallDirs-function.rst b/Help/release/dev/GNUInstallDirs-function.rst deleted file mode 100644 index 65ea7fb3d..000000000 --- a/Help/release/dev/GNUInstallDirs-function.rst +++ /dev/null @@ -1,5 +0,0 @@ -GNUInstallDirs-function ------------------------ - -* The :module:`GNUInstallDirs` module gained a new - :command:`GNUInstallDirs_get_absolute_install_dir` command. diff --git a/Help/release/dev/GenerateExportHeader-custom-content.rst b/Help/release/dev/GenerateExportHeader-custom-content.rst deleted file mode 100644 index 161261ccc..000000000 --- a/Help/release/dev/GenerateExportHeader-custom-content.rst +++ /dev/null @@ -1,6 +0,0 @@ -GenerateExportHeader-custom-content ------------------------------------ - -* The :module:`GenerateExportHeader` module learned a new - ``CUSTOM_CONTENT_FROM_VARIABLE`` option to specify a variable - containing custom content for inclusion in the generated header. diff --git a/Help/release/dev/add-android-test-utilities-module.rst b/Help/release/dev/add-android-test-utilities-module.rst deleted file mode 100644 index 998b3cd40..000000000 --- a/Help/release/dev/add-android-test-utilities-module.rst +++ /dev/null @@ -1,5 +0,0 @@ -add-android-test-utilities-module ---------------------------------- - -* A :module:`AndroidTestUtilities` module was added to manage transfer of - test data to an Android device. diff --git a/Help/release/dev/add-extra-boolean-comparisons.rst b/Help/release/dev/add-extra-boolean-comparisons.rst deleted file mode 100644 index a92899435..000000000 --- a/Help/release/dev/add-extra-boolean-comparisons.rst +++ /dev/null @@ -1,6 +0,0 @@ -add-extra-boolean-comparisons ------------------------------ - -* The :command:`if` command gained new boolean comparison operations - ``LESS_EQUAL``, ``GREATER_EQUAL``, ``STRLESS_EQUAL``, ``STRGREATER_EQUAL``, - ``VERSION_LESS_EQUAL``, and ``VERSION_GREATER_EQUAL``. diff --git a/Help/release/dev/add_androidmk_generator.rst b/Help/release/dev/add_androidmk_generator.rst deleted file mode 100644 index dd7867ce7..000000000 --- a/Help/release/dev/add_androidmk_generator.rst +++ /dev/null @@ -1,10 +0,0 @@ -add_androidmk_generator ------------------------ - -* The :command:`install` command gained an ``EXPORT_ANDROID_MK`` - subcommand to install ``Android.mk`` files referencing installed - libraries as prebuilts for the Android NDK build system. - -* The :command:`export` command gained an ``ANDROID_MK`` option - to generate ``Android.mk`` files referencing CMake-built - libraries as prebuilts for the Android NDK build system. diff --git a/Help/release/dev/aix-clang.rst b/Help/release/dev/aix-clang.rst deleted file mode 100644 index 2ff53bfa4..000000000 --- a/Help/release/dev/aix-clang.rst +++ /dev/null @@ -1,4 +0,0 @@ -aix-clang ---------- - -* The Clang compiler is now supported on AIX. diff --git a/Help/release/dev/android-platform-modules.rst b/Help/release/dev/android-platform-modules.rst deleted file mode 100644 index 79ae992db..000000000 --- a/Help/release/dev/android-platform-modules.rst +++ /dev/null @@ -1,5 +0,0 @@ -android-platform-modules ------------------------- - -* CMake now supports :ref:`Cross Compiling for Android` with simple - toolchain files. diff --git a/Help/release/dev/app-framework-bundle-extension.rst b/Help/release/dev/app-framework-bundle-extension.rst deleted file mode 100644 index 01855a2b0..000000000 --- a/Help/release/dev/app-framework-bundle-extension.rst +++ /dev/null @@ -1,5 +0,0 @@ -app-framework-bundle-extension ------------------------------- - -* On Apple platforms the :prop_tgt:`BUNDLE_EXTENSION` now also applies to - Frameworks and App Bundles. diff --git a/Help/release/dev/bzip2-imported-targets.rst b/Help/release/dev/bzip2-imported-targets.rst deleted file mode 100644 index be58b96a9..000000000 --- a/Help/release/dev/bzip2-imported-targets.rst +++ /dev/null @@ -1,4 +0,0 @@ -bzip2-imported-targets ----------------------- - -* The :module:`FindBZip2` module now provides imported targets. diff --git a/Help/release/dev/ccmake-vim-navigation.rst b/Help/release/dev/ccmake-vim-navigation.rst deleted file mode 100644 index 8fc141639..000000000 --- a/Help/release/dev/ccmake-vim-navigation.rst +++ /dev/null @@ -1,4 +0,0 @@ -ccmake-vim-navigation ---------------------- - -* :manual:`ccmake(1)` learned to support vim-like navigation bindings. diff --git a/Help/release/dev/cmake-capabilities.rst b/Help/release/dev/cmake-capabilities.rst deleted file mode 100644 index 7abb9736c..000000000 --- a/Help/release/dev/cmake-capabilities.rst +++ /dev/null @@ -1,6 +0,0 @@ -cmake-capabilities ------------------- - -* :manual:`cmake(1)` gained a ``-E capabilities`` option to provide a - machine-readable (JSON) description of the capabilities of the - cmake tool (available generators, etc.). diff --git a/Help/release/dev/cmake-gui-open-project.rst b/Help/release/dev/cmake-gui-open-project.rst deleted file mode 100644 index 32f0f0f81..000000000 --- a/Help/release/dev/cmake-gui-open-project.rst +++ /dev/null @@ -1,5 +0,0 @@ -cmake-gui-open-project ----------------------- - -* :manual:`cmake-gui(1)` gained a button to open the generated project file - for :ref:`Visual Studio Generators` and the :generator:`Xcode` generator. diff --git a/Help/release/dev/cmake-server-basic.rst b/Help/release/dev/cmake-server-basic.rst deleted file mode 100644 index 0b9766024..000000000 --- a/Help/release/dev/cmake-server-basic.rst +++ /dev/null @@ -1,6 +0,0 @@ -cmake-server-basic ------------------- - -* A new :manual:`cmake-server(7)` mode was added to provide semantic - information about a CMake-generated buildsystem to clients through - a JSON protocol. diff --git a/Help/release/dev/cmake-trace-source.rst b/Help/release/dev/cmake-trace-source.rst deleted file mode 100644 index 9b17f6cec..000000000 --- a/Help/release/dev/cmake-trace-source.rst +++ /dev/null @@ -1,4 +0,0 @@ -cmake-trace-source ------------------- - -* The :manual:`cmake(1)` command learned a ``--trace-source=`` option. diff --git a/Help/release/dev/codelite-organize-by-target.rst b/Help/release/dev/codelite-organize-by-target.rst deleted file mode 100644 index 097922835..000000000 --- a/Help/release/dev/codelite-organize-by-target.rst +++ /dev/null @@ -1,6 +0,0 @@ -codelite-organize-by-target ---------------------------- - -* The :generator:`CodeLite` generator gained a new - :variable:`CMAKE_CODELITE_USE_TARGETS` option - to change project creation from projects to targets. diff --git a/Help/release/dev/cpack-deb-long-filenames.rst b/Help/release/dev/cpack-deb-long-filenames.rst deleted file mode 100644 index 6113eafa0..000000000 --- a/Help/release/dev/cpack-deb-long-filenames.rst +++ /dev/null @@ -1,6 +0,0 @@ -cpack-deb-long-filenames ------------------------- - -* The :module:`CPackDeb` module learned to support long file names - when archive format is set to GNU tar. - See :variable:`CPACK_DEBIAN_ARCHIVE_TYPE` diff --git a/Help/release/dev/cpack-rpm-debuginfo-pkg.rst b/Help/release/dev/cpack-rpm-debuginfo-pkg.rst deleted file mode 100644 index 8b37fe499..000000000 --- a/Help/release/dev/cpack-rpm-debuginfo-pkg.rst +++ /dev/null @@ -1,6 +0,0 @@ -cpack-rpm-debuginfo-pkg ------------------------ - -* The :module:`CPackRPM` module learned to generate debuginfo - packages on demand. See :variable:`CPACK_RPM_DEBUGINFO_PACKAGE` - and its per component version. diff --git a/Help/release/dev/cpack-rpm-srpm-package.rst b/Help/release/dev/cpack-rpm-srpm-package.rst deleted file mode 100644 index 803b9fca5..000000000 --- a/Help/release/dev/cpack-rpm-srpm-package.rst +++ /dev/null @@ -1,7 +0,0 @@ -cpack-rpm-srpm-package ----------------------- - -* The :module:`CPackRPM` module learned to generate source rpm - (SRPM) packages on demand. See :variable:`CPACK_RPM_PACKAGE_SOURCES`, - :variable:`CPACK_RPM_SOURCE_PKG_BUILD_PARAMS` and - :variable:`CPACK_RPM_SOURCE_PKG_PACKAGING_INSTALL_PREFIX`. diff --git a/Help/release/dev/cpack.hash_computing.rst b/Help/release/dev/cpack.hash_computing.rst deleted file mode 100644 index 9780bb286..000000000 --- a/Help/release/dev/cpack.hash_computing.rst +++ /dev/null @@ -1,5 +0,0 @@ -cpack.hash_computing --------------------- - -* CPack gained a new :variable:`CPACK_PACKAGE_CHECKSUM` variable to - enable generation of a checksum file for each package file. diff --git a/Help/release/dev/ctest-capture-error.rst b/Help/release/dev/ctest-capture-error.rst deleted file mode 100644 index 5a286c7ce..000000000 --- a/Help/release/dev/ctest-capture-error.rst +++ /dev/null @@ -1,8 +0,0 @@ -ctest-capture-error -------------------- - -* The :command:`ctest_configure`, :command:`ctest_build`, - :command:`ctest_test`, :command:`ctest_coverage`, and :command:`ctest_upload` - commands gained a new ``CAPTURE_CMAKE_ERROR`` option to capture any errors - that occur as the commands run into a variable and avoid affecting the return - code of the :manual:`ctest(1)` process. diff --git a/Help/release/dev/directory-list-targets-and-subdirs.rst b/Help/release/dev/directory-list-targets-and-subdirs.rst deleted file mode 100644 index 85f2c826b..000000000 --- a/Help/release/dev/directory-list-targets-and-subdirs.rst +++ /dev/null @@ -1,16 +0,0 @@ -directory-list-targets-and-subdirs ----------------------------------- - -* A :prop_dir:`SOURCE_DIR` directory property was added to get the - absolute path to the source directory associated with a directory. - -* A :prop_dir:`BINARY_DIR` directory property was added to get the - absolute path to the binary directory corresponding to the source - directory on which the property is read. - -* A :prop_dir:`BUILDSYSTEM_TARGETS` directory property was added to - get the list of logical buildsystem target names added by the - project in a directory. - -* A :prop_dir:`SUBDIRECTORIES` directory property was added to - get the list of subdirectories added by a project in a directory. diff --git a/Help/release/dev/doc-compilers-dropped.rst b/Help/release/dev/doc-compilers-dropped.rst deleted file mode 100644 index 0bde63254..000000000 --- a/Help/release/dev/doc-compilers-dropped.rst +++ /dev/null @@ -1,10 +0,0 @@ -doc-compilers-dropped ---------------------- - -* Support for building CMake itself with some compilers was dropped: - - * Visual Studio 7.1 and 2005 -- superseded by VS 2008 and above - * MinGW.org mingw32 -- superseded by MSYS2 mingw32 and mingw64 - - CMake still supports generating build systems for other projects using - these compilers. diff --git a/Help/release/dev/drop-linux-i386-binary.rst b/Help/release/dev/drop-linux-i386-binary.rst deleted file mode 100644 index 60aa74e28..000000000 --- a/Help/release/dev/drop-linux-i386-binary.rst +++ /dev/null @@ -1,5 +0,0 @@ -drop-linux-i386-binary ----------------------- - -* We no longer provide Linux i386 binaries for download from ``cmake.org`` - for new versions of CMake. diff --git a/Help/release/dev/file-curl-httpheader.rst b/Help/release/dev/file-curl-httpheader.rst deleted file mode 100644 index 2147d402a..000000000 --- a/Help/release/dev/file-curl-httpheader.rst +++ /dev/null @@ -1,5 +0,0 @@ -file-curl-httpheader --------------------- - -* The :command:`file(DOWNLOAD)` and :command:`file(UPLOAD)` commands - gained a ``HTTPHEADER `` option. diff --git a/Help/release/dev/file-curl-userpw.rst b/Help/release/dev/file-curl-userpw.rst deleted file mode 100644 index 4ae1feea7..000000000 --- a/Help/release/dev/file-curl-userpw.rst +++ /dev/null @@ -1,5 +0,0 @@ -file-curl-userpw ----------------- - -* The :command:`file(DOWNLOAD)` and :command:`file(UPLOAD)` commands - gained a ``USERPWD :`` option. diff --git a/Help/release/dev/find-lib32.rst b/Help/release/dev/find-lib32.rst deleted file mode 100644 index 00818dc09..000000000 --- a/Help/release/dev/find-lib32.rst +++ /dev/null @@ -1,7 +0,0 @@ -find-lib32 ----------- - -* The :command:`find_library` and :command:`find_package` commands learned - to search in ``lib32/`` directories when the build targets a 32-bit - architecture. See the :prop_gbl:`FIND_LIBRARY_USE_LIB32_PATHS` global - property. diff --git a/Help/release/dev/find_package-dir-sort.rst b/Help/release/dev/find_package-dir-sort.rst deleted file mode 100644 index 67b93ebd0..000000000 --- a/Help/release/dev/find_package-dir-sort.rst +++ /dev/null @@ -1,13 +0,0 @@ -find_package-dir-sort ---------------------- - -* The :command:`find_package` command gained the possibility of - sorting compatible libraries by ``NAME`` or by ``NATURAL`` sorting by - setting the two new variables :variable:`CMAKE_FIND_PACKAGE_SORT_ORDER` - and :variable:`CMAKE_FIND_PACKAGE_SORT_DIRECTION`. - -* Variable :variable:`CMAKE_FIND_PACKAGE_SORT_ORDER` was added to control - the sorting mode of the :command:`find_package` command. - -* Variable :variable:`CMAKE_FIND_PACKAGE_SORT_DIRECTION` was added to control - the sorting direction the :command:`find_package` command. diff --git a/Help/release/dev/findicu.rst b/Help/release/dev/findicu.rst deleted file mode 100644 index 0950327f7..000000000 --- a/Help/release/dev/findicu.rst +++ /dev/null @@ -1,5 +0,0 @@ -findicu -------- - -* A :module:`FindICU` module was introduced to find the International - Components for Unicode (ICU) libraries and programs. diff --git a/Help/release/dev/fortran-submodules.rst b/Help/release/dev/fortran-submodules.rst deleted file mode 100644 index e4e965732..000000000 --- a/Help/release/dev/fortran-submodules.rst +++ /dev/null @@ -1,7 +0,0 @@ -fortran-submodules ------------------- - -* The Fortran dependency scanner learned to support the syntax of - `Fortran Submodules`_. - -.. _`Fortran Submodules`: http://fortranwiki.org/fortran/show/Submodules diff --git a/Help/release/dev/ifw-package-resources.rst b/Help/release/dev/ifw-package-resources.rst deleted file mode 100644 index 28ea5c440..000000000 --- a/Help/release/dev/ifw-package-resources.rst +++ /dev/null @@ -1,6 +0,0 @@ -ifw-package-resources ---------------------- - -* The :module:`CPackIFW` module gained a new - :command:`cpack_ifw_add_package_resources` command to include additional - resources in the installer binary. diff --git a/Help/release/dev/ifw-user-interfaces.rst b/Help/release/dev/ifw-user-interfaces.rst deleted file mode 100644 index 26e241ace..000000000 --- a/Help/release/dev/ifw-user-interfaces.rst +++ /dev/null @@ -1,7 +0,0 @@ -ifw-user-interfaces -------------------- - -* The :module:`CPackIFW` module :command:`cpack_ifw_configure_component` and - :command:`cpack_ifw_configure_component_group` commands gained a new - ``USER_INTERFACES`` option to add a list of additonal pages to the IFW - installer. diff --git a/Help/release/dev/java-export-targets.rst b/Help/release/dev/java-export-targets.rst deleted file mode 100644 index 5b70e976c..000000000 --- a/Help/release/dev/java-export-targets.rst +++ /dev/null @@ -1,6 +0,0 @@ -java-export-targets -------------------- - -* The :module:`UseJava` module gained APIs to "export" jar targets - for use by external CMake projects. See the ``install_jar_exports`` - and ``export_jars`` functions. diff --git a/Help/release/dev/link_what_you_use.rst b/Help/release/dev/link_what_you_use.rst deleted file mode 100644 index 8d1e59871..000000000 --- a/Help/release/dev/link_what_you_use.rst +++ /dev/null @@ -1,7 +0,0 @@ -link_what_you_use ------------------ - -* A :prop_tgt:`LINK_WHAT_YOU_USE` target property and supporting - :variable:`CMAKE_LINK_WHAT_YOU_USE` variable were introduced - to detect (on UNIX) shared libraries that are linked but not - needed by running ``ldd -r -u``. diff --git a/Help/release/dev/ninja-add_custom_command-depfile.rst b/Help/release/dev/ninja-add_custom_command-depfile.rst deleted file mode 100644 index c8099fe8a..000000000 --- a/Help/release/dev/ninja-add_custom_command-depfile.rst +++ /dev/null @@ -1,6 +0,0 @@ -ninja-add_custom_command-depfile --------------------------------- - -* The :command:`add_custom_command` command gained a new ``DEPFILE`` - option that works with the :generator:`Ninja` generator to provide - implicit dependency information to the build tool. diff --git a/Help/release/dev/ninja-directory-targets.rst b/Help/release/dev/ninja-directory-targets.rst deleted file mode 100644 index c4269d8ba..000000000 --- a/Help/release/dev/ninja-directory-targets.rst +++ /dev/null @@ -1,8 +0,0 @@ -ninja-directory-targets ------------------------ - -* The :generator:`Ninja` generator learned to produce phony targets - of the form ``sub/dir/{test,install,package}`` to drive the build - of a subdirectory installation, test or packaging target. - This is equivalent to ``cd sub/dir; make {test,install,package}`` - with :ref:`Makefile Generators`. diff --git a/Help/release/dev/ninja-fortran.rst b/Help/release/dev/ninja-fortran.rst deleted file mode 100644 index 612b1ff81..000000000 --- a/Help/release/dev/ninja-fortran.rst +++ /dev/null @@ -1,6 +0,0 @@ -ninja-fortran -------------- - -* The :generator:`Ninja` generator learned to conditionally support - Fortran when using a ``ninja`` tool that has the necessary features. - See generator documentation for details. diff --git a/Help/release/dev/parse_arguments_argv_n.rst b/Help/release/dev/parse_arguments_argv_n.rst deleted file mode 100644 index 758b72a1b..000000000 --- a/Help/release/dev/parse_arguments_argv_n.rst +++ /dev/null @@ -1,6 +0,0 @@ -parse_arguments_argv_n ----------------------- - -* The :command:`cmake_parse_arguments` command gained a new - mode to read arguments directly from ``ARGC`` and ``ARGV#`` - variables inside a :command:`function` body. diff --git a/Help/release/dev/productbuild.rst b/Help/release/dev/productbuild.rst deleted file mode 100644 index ebe213b5b..000000000 --- a/Help/release/dev/productbuild.rst +++ /dev/null @@ -1,5 +0,0 @@ -productbuild ------------- - -* CPack gained a ``productbuild`` generator on OS X, configured by - the :module:`CPackProductBuild` module. diff --git a/Help/release/dev/test-fixtures.rst b/Help/release/dev/test-fixtures.rst deleted file mode 100644 index a466c4684..000000000 --- a/Help/release/dev/test-fixtures.rst +++ /dev/null @@ -1,8 +0,0 @@ -test-fixtures -------------- - -* CTest now supports test fixtures through the new :prop_test:`FIXTURES_SETUP`, - :prop_test:`FIXTURES_CLEANUP` and :prop_test:`FIXTURES_REQUIRED` test - properties. When using regular expressions or ``--rerun-failed`` to limit - the tests to be run, a fixture's setup and cleanup tests will automatically - be added to the execution set if any test requires that fixture. diff --git a/Help/release/dev/timestamp-names.rst b/Help/release/dev/timestamp-names.rst deleted file mode 100644 index ea54b5cf4..000000000 --- a/Help/release/dev/timestamp-names.rst +++ /dev/null @@ -1,6 +0,0 @@ -timestamp-names ---------------- - -* The :command:`string(TIMESTAMP)` and :command:`file(TIMESTAMP)` - commands gained support for the ``%a`` and ``%b`` placeholders. - These are the abbreviated weekday and month names. diff --git a/Help/release/dev/toolchain-flag-init.rst b/Help/release/dev/toolchain-flag-init.rst deleted file mode 100644 index 37e363d67..000000000 --- a/Help/release/dev/toolchain-flag-init.rst +++ /dev/null @@ -1,16 +0,0 @@ -toolchain-flag-init -------------------- - -* :variable:`Toolchain files ` may now set a - :variable:`CMAKE__FLAGS_INIT` variable to initialize the - :variable:`CMAKE__FLAGS` cache entry the first time a language is - enabled in a build tree. - -* :variable:`Toolchain files ` may now set - :variable:`CMAKE_EXE_LINKER_FLAGS_INIT`, - :variable:`CMAKE_SHARED_LINKER_FLAGS_INIT`, and - :variable:`CMAKE_MODULE_LINKER_FLAGS_INIT` variables to initialize the - :variable:`CMAKE_EXE_LINKER_FLAGS`, - :variable:`CMAKE_SHARED_LINKER_FLAGS`, and - :variable:`CMAKE_MODULE_LINKER_FLAGS` cache entries the first time - a language is enabled in a build tree. 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 ebfd6a4cc..000000000 --- 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. See policy :policy:`CMP0066`. diff --git a/Help/release/dev/vim-cmake-syntax.rst b/Help/release/dev/vim-cmake-syntax.rst deleted file mode 100644 index 1757f9c70..000000000 --- a/Help/release/dev/vim-cmake-syntax.rst +++ /dev/null @@ -1,11 +0,0 @@ -vim-cmake-syntax ----------------- - -* Vim support files ``indent/cmake.vim`` and ``syntax/cmake.vim`` - from the `vim-cmake-syntax`_ project are now distributed with CMake. - -* Vim support files ``cmake-indent.vim``, ``cmake-syntax.vim``, and - ``cmake-help.vim`` have been removed in favor of the files now provided - from the `vim-cmake-syntax`_ project. - -.. _`vim-cmake-syntax`: https://github.com/pboettch/vim-cmake-syntax diff --git a/Help/release/dev/vs-15-generator.rst b/Help/release/dev/vs-15-generator.rst deleted file mode 100644 index be40cbce2..000000000 --- a/Help/release/dev/vs-15-generator.rst +++ /dev/null @@ -1,4 +0,0 @@ -vs-15-generator ---------------- - -* The :generator:`Visual Studio 15` generator was added. diff --git a/Help/release/dev/vs-natvis.rst b/Help/release/dev/vs-natvis.rst deleted file mode 100644 index 7cc9844cb..000000000 --- a/Help/release/dev/vs-natvis.rst +++ /dev/null @@ -1,5 +0,0 @@ -vs-natvis ---------- - -* :ref:`Visual Studio Generators` for VS 2010 and above learned to - place ``.natvis`` source files into VS project files properly. diff --git a/Help/release/dev/vs-sdk-refs.rst b/Help/release/dev/vs-sdk-refs.rst deleted file mode 100644 index 55232e36d..000000000 --- a/Help/release/dev/vs-sdk-refs.rst +++ /dev/null @@ -1,5 +0,0 @@ -vs-sdk-refs ------------ - -* A :prop_tgt:`VS_SDK_REFERENCES` target property was added to tell - :ref:`Visual Studio Generators` to reference the named SDKs. diff --git a/Help/release/dev/vs-tool-override.rst b/Help/release/dev/vs-tool-override.rst deleted file mode 100644 index e1177c8d6..000000000 --- a/Help/release/dev/vs-tool-override.rst +++ /dev/null @@ -1,5 +0,0 @@ -vs-tool-override ----------------- - -* A :prop_sf:`VS_TOOL_OVERRIDE` source file property was created to tell - :ref:`Visual Studio Generators` what tool to use for a source file. diff --git a/Help/release/dev/windows-export-all-from-exe.rst b/Help/release/dev/windows-export-all-from-exe.rst deleted file mode 100644 index 48c16ec63..000000000 --- a/Help/release/dev/windows-export-all-from-exe.rst +++ /dev/null @@ -1,5 +0,0 @@ -windows-export-all-from-exe ---------------------------- - -* The :prop_tgt:`WINDOWS_EXPORT_ALL_SYMBOLS` target property now applies - to executable targets with the :prop_tgt:`ENABLE_EXPORTS` property set. diff --git a/Help/release/dev/wix-custom-install-dir.rst b/Help/release/dev/wix-custom-install-dir.rst deleted file mode 100644 index cd12a8862..000000000 --- a/Help/release/dev/wix-custom-install-dir.rst +++ /dev/null @@ -1,7 +0,0 @@ -wix-custom-install-dir ----------------------- - -* The CPack WIX generator now supports - :variable:`CPACK_WIX_SKIP_PROGRAM_FOLDER` to allow specification - of a custom absolute installation prefix outside - of the ProgramFiles folders. diff --git a/Help/release/dev/wix-disabled-components.rst b/Help/release/dev/wix-disabled-components.rst deleted file mode 100644 index a7e4d5f59..000000000 --- a/Help/release/dev/wix-disabled-components.rst +++ /dev/null @@ -1,6 +0,0 @@ -wix-disabled-components ------------------------ - -* The CPack WIX generator now supports - :variable:`CPACK_COMPONENT__DISABLED`. - This can be used to deselect a component from being installed by default. diff --git a/Help/release/dev/wix-feature-patch.rst b/Help/release/dev/wix-feature-patch.rst deleted file mode 100644 index 0b1cbe368..000000000 --- a/Help/release/dev/wix-feature-patch.rst +++ /dev/null @@ -1,5 +0,0 @@ -wix-feature-patch ------------------ - -* The CPack WIX generator now supports - CPACK_WIX_PATCH_FILE fragments for Feature elements. diff --git a/Help/release/dev/wix-root-description.rst b/Help/release/dev/wix-root-description.rst deleted file mode 100644 index 24afed283..000000000 --- a/Help/release/dev/wix-root-description.rst +++ /dev/null @@ -1,7 +0,0 @@ -wix-root-description --------------------- - -* The CPack WIX generator now supports - :variable:`CPACK_WIX_ROOT_FEATURE_TITLE` and - :variable:`CPACK_WIX_ROOT_FEATURE_DESCRIPTION` to allow the specification - of a custom title and description for the root feature element. diff --git a/Help/release/dev/xcode-file-attributes.rst b/Help/release/dev/xcode-file-attributes.rst deleted file mode 100644 index 35824fa6c..000000000 --- a/Help/release/dev/xcode-file-attributes.rst +++ /dev/null @@ -1,6 +0,0 @@ -xcode-file-attributes ---------------------- - -* A :prop_sf:`XCODE_FILE_ATTRIBUTES` source file property was - added to tell the :generator:`Xcode` generator to generate - custom content in the Xcode project attributes for the file. diff --git a/Help/release/dev/xcode-swift-version.rst b/Help/release/dev/xcode-swift-version.rst deleted file mode 100644 index 5dff23c1d..000000000 --- a/Help/release/dev/xcode-swift-version.rst +++ /dev/null @@ -1,6 +0,0 @@ -xcode-swift-version -------------------- - -* The :generator:`Xcode` generator's rudimentary Swift language support - learned to honor a new :variable:`CMAKE_Swift_LANGUAGE_VERSION` variable - to tell Xcode what version of Swift is used by the source. diff --git a/Help/release/index.rst b/Help/release/index.rst index e93b8804d..30decd539 100644 --- a/Help/release/index.rst +++ b/Help/release/index.rst @@ -13,6 +13,7 @@ Releases .. toctree:: :maxdepth: 1 + 3.7 <3.7> 3.6 <3.6> 3.5 <3.5> 3.4 <3.4>