Merge topic 'doc-3.7-relnotes'

64e63da0 Help: Organize and revise 3.7 release notes
e82c33b8 Help: Consolidate 3.7 release notes

64 files changed, 310 insertions, 390 deletions

diff --git a/Help/release/3.7.rst b/Help/release/3.7.rst
new file mode 100644
index 0000000000..97c6f7c988
--- /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 <HTTP-header>`` and ``USERPWD <username>:<password>`` 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_<LANG>_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 <CMAKE_TOOLCHAIN_FILE>` may now set a
+  :variable:`CMAKE_<LANG>_FLAGS_INIT` variable to initialize the
+  :variable:`CMAKE_<LANG>_FLAGS` cache entry the first time a language is
+  enabled in a build tree.
+
+* :variable:`Toolchain files <CMAKE_TOOLCHAIN_FILE>` 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_<compName>_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=<file>`` 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 bf62812da6..0000000000
--- 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 927d1b269d..0000000000
--- 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 e3a362abcf..0000000000
--- 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 0b591284a0..0000000000
--- 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 cd25412cbb..0000000000
--- 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 259c745b0b..0000000000
--- 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 cb29a711bb..0000000000
--- 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 bb5447eff1..0000000000
--- 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 65ea7fb3d6..0000000000
--- 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 161261ccc6..0000000000
--- 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 998b3cd40c..0000000000
--- 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 a92899435e..0000000000
--- 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 dd7867ce7e..0000000000
--- 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 2ff53bfa44..0000000000
--- 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 79ae992db2..0000000000
--- 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 01855a2b07..0000000000
--- 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 be58b96a9f..0000000000
--- 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 8fc141639f..0000000000
--- 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 7abb9736cc..0000000000
--- 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 32f0f0f810..0000000000
--- 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 0b97660246..0000000000
--- 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 9b17f6cec7..0000000000
--- 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=<file>`` 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 0979228350..0000000000
--- 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 6113eafa0b..0000000000
--- 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 8b37fe4998..0000000000
--- 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 803b9fca5a..0000000000
--- 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 9780bb286f..0000000000
--- 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 5a286c7ce9..0000000000
--- 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 85f2c826b0..0000000000
--- 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 0bde63254c..0000000000
--- 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 60aa74e283..0000000000
--- 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 2147d402a1..0000000000
--- 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 <HTTP-header>`` option.
diff --git a/Help/release/dev/file-curl-userpw.rst b/Help/release/dev/file-curl-userpw.rst
deleted file mode 100644
index 4ae1feea7b..0000000000
--- 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 <username>:<password>`` option.
diff --git a/Help/release/dev/find-lib32.rst b/Help/release/dev/find-lib32.rst
deleted file mode 100644
index 00818dc09d..0000000000
--- 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 67b93ebd00..0000000000
--- 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 0950327f7b..0000000000
--- 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 e4e9657321..0000000000
--- 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 28ea5c4409..0000000000
--- 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 26e241ace7..0000000000
--- 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 5b70e976cd..0000000000
--- 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 8d1e598712..0000000000
--- 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 c8099fe8af..0000000000
--- 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 c4269d8ba3..0000000000
--- 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 612b1ff813..0000000000
--- 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 758b72a1bf..0000000000
--- 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 ebe213b5b6..0000000000
--- 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 a466c46842..0000000000
--- 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 ea54b5cf47..0000000000
--- 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 37e363d67a..0000000000
--- a/Help/release/dev/toolchain-flag-init.rst
+++ /dev/null
@@ -1,16 +0,0 @@
-toolchain-flag-init
--------------------
-
-* :variable:`Toolchain files <CMAKE_TOOLCHAIN_FILE>` may now set a
-  :variable:`CMAKE_<LANG>_FLAGS_INIT` variable to initialize the
-  :variable:`CMAKE_<LANG>_FLAGS` cache entry the first time a language is
-  enabled in a build tree.
-
-* :variable:`Toolchain files <CMAKE_TOOLCHAIN_FILE>` 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 ebfd6a4cc6..0000000000
--- 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_<LANG>_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 1757f9c709..0000000000
--- 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 be40cbce26..0000000000
--- 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 7cc9844cb2..0000000000
--- 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 55232e36dc..0000000000
--- 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 e1177c8d6c..0000000000
--- 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 48c16ec63a..0000000000
--- 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 cd12a88622..0000000000
--- 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 a7e4d5f597..0000000000
--- 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_<compName>_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 0b1cbe3687..0000000000
--- 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 24afed2839..0000000000
--- 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 35824fa6ca..0000000000
--- 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 5dff23c1d0..0000000000
--- 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 e93b8804d4..30decd539c 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>