Merge topic 'doc-3.6-relnotes'

98eafa9b Help: Organize and revise 3.6 release notes
c5df7483 Help: Consolidate 3.6 release notes

58 files changed, 316 insertions, 380 deletions

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