Merge topic 'doc-3.2-relnotes'

d81bbc3f Help: Add 3.2 release note for AUTORCC dependency tracking
0f38d9c2 Help: Add 3.2 release notes for file(GENERATE) features
0f580e8e Help: Organize and revise 3.2 release notes
e08a78dc Help: Consolidate 3.2 release notes
3a4381b6 Help: Add link target to cmake-language.7 encoding section

53 files changed, 283 insertions, 341 deletions

diff --git a/Help/manual/cmake-language.7.rst b/Help/manual/cmake-language.7.rst
index 5ec5858ff4..3e0297cf6a 100644
--- a/Help/manual/cmake-language.7.rst
+++ b/Help/manual/cmake-language.7.rst
@@ -57,6 +57,8 @@ variable.
 Syntax
 ======
 
+.. _`CMake Language Encoding`:
+
 Encoding
 --------
 
diff --git a/Help/release/3.2.0.rst b/Help/release/3.2.0.rst
new file mode 100644
index 0000000000..5b12163520
--- /dev/null
+++ b/Help/release/3.2.0.rst
@@ -0,0 +1,280 @@
+CMake 3.2.0 Release Notes
+*************************
+
+.. only:: html
+
+  .. contents::
+
+Changes made since CMake 3.1.0 include the following.
+
+New Features
+============
+
+Syntax
+------
+
+* CMake learned to support unicode characters
+  :ref:`encoded as UTF-8 <CMake Language Encoding>`
+  on Windows.  This was already supported on platforms whose
+  system APIs accept UTF-8 encoded strings.
+  Unicode characters may now be used in CMake code, paths to
+  source files, configured files such as ``.h.in`` files, and
+  other files read and written by CMake.  Note that because CMake
+  interoperates with many other tools, there may still be some
+  limitations when using certain unicode characters.
+
+Commands
+--------
+
+* The :command:`add_custom_command` and :command:`add_custom_target`
+  commands learned a new ``BYPRODUCTS`` option to specify files
+  produced as side effects of the custom commands.  These are not
+  outputs because they do not always have to be newer than inputs.
+
+* The :command:`add_custom_command` and :command:`add_custom_target`
+  commands learned a new ``USES_TERMINAL`` option to request that
+  the command be given direct access to the terminal if possible.
+  The :generator:`Ninja` generator will places such commands in the
+  ``console`` :prop_gbl:`pool <JOB_POOLS>`.  Build targets provided by CMake
+  that are meant for individual interactive use, such as ``install``, are now
+  placed in this pool.
+
+* A new :command:`continue` command was added that can be called inside loop
+  contexts to end the current iteration and start the next one at the top of
+  the loop block.
+
+* The :command:`file(LOCK)` subcommand was created to allow CMake
+  processes to synchronize through file and directory locks.
+
+* The :command:`file(STRINGS)` now supports UTF-16LE, UTF-16BE,
+  UTF-32LE, UTF-32BE as ``ENCODING`` options.
+
+* The :command:`install(EXPORT)` command now works with an absolute
+  ``DESTINATION`` even if targets in the export set are installed
+  with a destination or :ref:`usage requirements <Target Usage Requirements>`
+  specified relative to the install prefix.  The value of the
+  :variable:`CMAKE_INSTALL_PREFIX` variable is hard-coded into the installed
+  export file as the base for relative references.
+
+* The :command:`try_compile` command source file signature now honors
+  link flags (e.g. :variable:`CMAKE_EXE_LINKER_FLAGS`) in the generated
+  test project.  See policy :policy:`CMP0056`.
+
+* The :command:`try_run` command learned to honor the ``LINK_LIBRARIES``
+  option just as :command:`try_compile` already does.
+
+* The :command:`file(GENERATE)` command now generates the output file with
+  the same permissions as the input file if set.
+
+* The :command:`file(GENERATE)` command can now generate files which are
+  used as source files for buildsystem targets.  Generated files
+  automatically get their :prop_sf:`GENERATED` property set to ``TRUE``.
+
+Variables
+---------
+
+* The :variable:`CMAKE_MATCH_COUNT` variable was introduced to record the
+  number of matches made in the last regular expression matched in an
+  :command:`if` command or a :command:`string` command.
+
+Properties
+----------
+
+* An :prop_tgt:`ANDROID_API_MIN` target property was introduced to
+  specify the minimum version to be targeted by the toolchain.
+
+* A :prop_sf:`VS_SHADER_FLAGS` source file property was added to specify
+  additional shader flags to ``.hlsl`` files, for the Visual Studio
+  generators.
+
+Modules
+-------
+
+* The :module:`ExternalData` module learned to support
+  :ref:`Custom Fetch Scripts <ExternalData Custom Fetch Scripts>`.
+  This allows projects to specify custom ``.cmake`` scripts for
+  fetching data objects during the build.
+
+* The :module:`ExternalProject` module learned options to create
+  independent external project step targets that do not depend
+  on the builtin steps.
+
+* The :module:`ExternalProject` module :command:`ExternalProject_Add`
+  command learned a new ``CMAKE_CACHE_DEFAULT_ARGS`` option to
+  initialize cache values in the external project without setting
+  them on future builds.
+
+* The :module:`ExternalProject` module :command:`ExternalProject_Add`
+  command learned a new ``TEST_EXCLUDE_FROM_MAIN`` option to exclude
+  tests from the main build.
+
+* The :module:`ExternalProject` module :command:`ExternalProject_Add`
+  command learned a new ``UPDATE_DISCONNECTED`` option to avoid
+  automatically updating the source tree checkout from version control.
+
+* The :module:`FindCUDA` module learned about the ``cusolver``
+  library in CUDA 7.0.
+
+* The :module:`FindGit` module learned to find the ``git`` command-line tool
+  that comes with GitHub for Windows installed in user home directories.
+
+* A :module:`FindGSL` module was introduced to find the
+  GNU Scientific Library.
+
+* A :module:`FindIntl` module was introduced to find the
+  Gettext ``libintl`` library.
+
+* A :module:`FindJsonCpp` module was introduced to find the
+  JsonCpp package.
+
+* The :module:`FindLATEX` module learned to support components.
+
+* The :module:`FindMPI` module learned to find MS-MPI on Windows.
+
+* The :module:`FindOpenGL` module no longer explicitly searches
+  for any dependency on X11 libraries with the :module:`FindX11`
+  module.  Such dependencies should not need to be explicit.
+  Applications using X11 APIs themselves should find and link
+  to X11 libraries explicitly.
+
+* The :module:`FindOpenSSL` module now reports ``crypto`` and ``ssl``
+  libraries separately in ``OPENSSL_CRYPTO_LIBRARY`` and
+  ``OPENSSL_SSL_LIBRARY``, respectively, to allow applications to
+  link to one without the other.
+
+* The :module:`WriteCompilerDetectionHeader` module learned to
+  create a define for portability of the ``cxx_thread_local`` feature.
+  The define expands to either the C++11 ``thread_local`` keyword, or a
+  pre-standardization compiler-specific equivalent, as appropriate.
+
+* The :module:`WriteCompilerDetectionHeader` module learned to create
+  multiple output files per compiler and per language, instead of creating
+  one large file.
+
+CTest
+-----
+
+* The :command:`ctest_coverage` command learned to support Delphi coverage.
+
+* The :command:`ctest_coverage` command learned to support Javascript coverage.
+
+* The :module:`CTestCoverageCollectGCOV` module was introduced as an
+  alternative to the :command:`ctest_coverage` command for collecting
+  ``gcov`` results for submission to CDash.
+
+CPack
+-----
+
+* The :module:`CPackRPM` module learned options to set per-component
+  descriptions and summaries.  See the
+  :variable:`CPACK_RPM_<component>_PACKAGE_DESCRIPTION` and
+  :variable:`CPACK_RPM_<component>_PACKAGE_SUMMARY` variables.
+
+* The :module:`CPackRPM` module learned options to specify
+  requirements for pre- and post-install scripts.  See the
+  :variable:`CPACK_RPM_PACKAGE_REQUIRES_PRE` and
+  :variable:`CPACK_RPM_PACKAGE_REQUIRES_POST` variables.
+
+* The :module:`CPackRPM` module learned options to specify
+  requirements for pre- and post-uninstall scripts.  See the
+  :variable:`CPACK_RPM_PACKAGE_REQUIRES_PREUN` and
+  :variable:`CPACK_RPM_PACKAGE_REQUIRES_POSTUN` variables.
+
+* The :module:`CPackRPM` module learned a new
+  :variable:`CPACK_RPM_<COMPONENT>_PACKAGE_PREFIX` variable to
+  specify a component-specific value to use instead of
+  :variable:`CPACK_PACKAGING_INSTALL_PREFIX`.
+
+* The :module:`CPackRPM` module learned a new
+  :variable:`CPACK_RPM_RELOCATION_PATHS` variable to
+  specify multiple relocation prefixes for a single rpm package.
+
+Other
+-----
+
+* The :manual:`cmake(1)` ``-E tar`` command now supports creating
+  ``.xz``-compressed archives with the ``J`` flag.
+
+* The :manual:`cmake(1)` ``-E tar`` command learned a new
+  ``--files-from=<file>`` option to specify file names using
+  lines in a file to overcome command-line length limits.
+
+* The :manual:`cmake(1)` ``-E tar`` command learned a new
+  ``--mtime=<date>`` option to specify the modification time
+  recorded in tarball entries.
+
+* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
+  is now aware of features supported by more compilers, including:
+
+  * Apple Clang (``AppleClang``) for Xcode versions 4.4 though 6.1.
+  * GNU compiler versions 4.4 through 5.0 on UNIX and Apple (``GNU``).
+  * Microsoft Visual Studio (``MSVC``) for versions 2010 through 2015.
+  * Oracle SolarisStudio (``SunPro``) version 12.4.
+
+* The :ref:`Qt AUTORCC` feature now tracks files listed in ``.qrc`` files
+  as dependencies. If an input file to the ``rcc`` tool is changed, the tool
+  is automatically re-run.
+
+New Diagnostics
+===============
+
+* The :command:`break` command now rejects calls outside of a loop
+  context or that pass arguments to the command.
+  See policy :policy:`CMP0055`.
+
+Deprecated and Removed Features
+===============================
+
+* Files written in the :manual:`cmake-language(7)`, such as
+  ``CMakeLists.txt`` or ``*.cmake`` files, are now expected to be
+  encoded as UTF-8.  If files are already ASCII, they will be
+  compatible.  If files were in a different encoding, including
+  Latin 1, they will need to be converted.
+
+* The implementation of CMake now relies on some C++ compiler features which
+  are not supported by some older compilers.  As a result, those old compilers
+  can no longer be used to build CMake itself.  CMake continues to be able to
+  generate Makefiles and project files for users of those old compilers
+  however.  Compilers known to no longer be capable of building CMake are:
+
+  * Visual Studio 6 and 7.0 -- superseded by VisualStudio 7.1 and newer.
+  * GCC 2.95 -- superseded by GCC 3 and newer compilers.
+  * Borland compilers -- superseded by other Windows compilers.
+  * Compaq compilers -- superseded by other compilers.
+  * SGI compilers -- IRIX was dropped as a host platform.
+
+Other Changes
+=============
+
+* On Windows and OS X, commands supporting network communication
+  via ``https``, such as :command:`file(DOWNLOAD)`,
+  :command:`file(UPLOAD)`, and :command:`ctest_submit`, now support
+  SSL/TLS even when CMake is not built against OpenSSL.
+  The Windows or OS X native SSL/TLS implementation is used by default.
+  OS-configured certificate authorities will be trusted automatically.
+
+  On other platforms, when CMake is built with OpenSSL, these
+  commands now search for OS-configured certificate authorities
+  in a few ``/etc`` paths to be trusted automatically.
+
+* On OS X with Makefile and Ninja generators, when a compiler is found
+  in ``/usr/bin`` it is now mapped to the corresponding compiler inside
+  the Xcode application folder, if any.  This allows such build
+  trees to continue to work with their original compiler even when
+  ``xcode-select`` switches to a different Xcode installation.
+
+* The Visual Studio generators now write solution and project
+  files in UTF-8 instead of Windows-1252.  Windows-1252 supported
+  Latin 1 languages such as those found in North and South America
+  and Western Europe.  With UTF-8, additional languages are now
+  supported.
+
+* The :generator:`Xcode` generator no longer requires a value for
+  the :variable:`CMAKE_MAKE_PROGRAM` variable to be located up front.
+  It now locates ``xcodebuild`` when needed at build time.
+
+* When building CMake itself using SolarisStudio 12, the default ``libCStd``
+  standard library is not sufficient to build CMake.  The SolarisStudio
+  distribution supports compiler options to use ``STLPort4`` or ``libstdc++``.
+  An appropriate option to select the standard library is now added
+  automatically when building CMake with SolarisStudio compilers.
diff --git a/Help/release/dev/Apple-GNU-compiler-features.rst b/Help/release/dev/Apple-GNU-compiler-features.rst
deleted file mode 100644
index 40c371287c..0000000000
--- a/Help/release/dev/Apple-GNU-compiler-features.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-Apple-GNU-compiler-features
----------------------------
-
-* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
-  is now aware of features supported by GNU compilers on OS X.
diff --git a/Help/release/dev/Apple-compiler-selection.rst b/Help/release/dev/Apple-compiler-selection.rst
deleted file mode 100644
index 5ff5653450..0000000000
--- a/Help/release/dev/Apple-compiler-selection.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-Apple-compiler-selection
-------------------------
-
-* On OS X with Makefile and Ninja generators, when a compiler is found
-  in ``/usr/bin`` it is now mapped to the corresponding compiler inside
-  the Xcode application folder, if any.  This allows such build
-  trees to continue to work with their original compiler even when
-  ``xcode-select`` switches to a different Xcode installation.
diff --git a/Help/release/dev/CTestCoverageCollectGCOV-refinements.rst b/Help/release/dev/CTestCoverageCollectGCOV-refinements.rst
deleted file mode 100644
index afa0a52fdd..0000000000
--- a/Help/release/dev/CTestCoverageCollectGCOV-refinements.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-CTestCoverageCollectGCOV-refinements
-------------------------------------
-
-* The :module:`CTestCoverageCollectGCOV` module was introduced as an
-  alternative to the :command:`ctest_coverage` command for collecting
-  ``gcov`` results for submission to CDash.
diff --git a/Help/release/dev/ExternalData-custom-download.rst b/Help/release/dev/ExternalData-custom-download.rst
deleted file mode 100644
index c40f4f7f3c..0000000000
--- a/Help/release/dev/ExternalData-custom-download.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-ExternalData-custom-download
-----------------------------
-
-* The :module:`ExternalData` module learned to support
-  :ref:`Custom Fetch Scripts <ExternalData Custom Fetch Scripts>`.
-  This allows projects to specify custom ``.cmake`` scripts for
-  fetching data objects during the build.
diff --git a/Help/release/dev/ExternalProject_CMAKE_CACHE_DEFAULT_ARGS.rst b/Help/release/dev/ExternalProject_CMAKE_CACHE_DEFAULT_ARGS.rst
deleted file mode 100644
index 1838ab6c31..0000000000
--- a/Help/release/dev/ExternalProject_CMAKE_CACHE_DEFAULT_ARGS.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-ExternalProject_CMAKE_CACHE_DEFAULT_ARGS
-----------------------------------------
-
-* The :module:`ExternalProject` module ``ExternalProject_Add`` function
-  learned a new ``CMAKE_CACHE_DEFAULT_ARGS`` option to initialize cache
-  values in the external project without setting them on future builds.
diff --git a/Help/release/dev/ExternalProject_TEST_EXCLUDE_FROM_MAIN.rst b/Help/release/dev/ExternalProject_TEST_EXCLUDE_FROM_MAIN.rst
deleted file mode 100644
index dfbf1089cc..0000000000
--- a/Help/release/dev/ExternalProject_TEST_EXCLUDE_FROM_MAIN.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-ExternalProject_TEST_EXCLUDE_FROM_MAIN
---------------------------------------
-
-* The :module:`ExternalProject` module :command:`ExternalProject_Add`
-  command learned a ``TEST_EXCLUDE_FROM_MAIN`` option to exclude tests
-  from the main build.
diff --git a/Help/release/dev/ExternalProject_UPDATE_DISCONNECTED.rst b/Help/release/dev/ExternalProject_UPDATE_DISCONNECTED.rst
deleted file mode 100644
index bed4a89447..0000000000
--- a/Help/release/dev/ExternalProject_UPDATE_DISCONNECTED.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-ExternalProject_UPDATE_DISCONNECTED
------------------------------------
-
-* The :module:`ExternalProject` module ``ExternalProject_Add`` command
-  learned an ``UPDATE_DISCONNECTED`` option to avoid automatically
-  updating the source tree checkout from version control.
diff --git a/Help/release/dev/ExternalProject_independent-step-targets.rst b/Help/release/dev/ExternalProject_independent-step-targets.rst
deleted file mode 100644
index 02e8db8385..0000000000
--- a/Help/release/dev/ExternalProject_independent-step-targets.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-ExternalProject_independent-step-targets
-----------------------------------------
-
-* The :module:`ExternalProject` module learned options to create
-  independent external project step targets that do not depend
-  on the builtin steps.
diff --git a/Help/release/dev/FindCUDA-cusolver.rst b/Help/release/dev/FindCUDA-cusolver.rst
deleted file mode 100644
index 7a61e784dc..0000000000
--- a/Help/release/dev/FindCUDA-cusolver.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-FindCUDA-cusolver
------------------
-
-* The :module:`FindCUDA` module learned about the ``cusolver``
-  library in CUDA 7.0.
diff --git a/Help/release/dev/FindGit-local-Github.rst b/Help/release/dev/FindGit-local-Github.rst
deleted file mode 100644
index 3523e86790..0000000000
--- a/Help/release/dev/FindGit-local-Github.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-FindGit-local-Github
---------------------
-
-* The :module:`FindGit` module learned to find the ``git`` command-line tool
-  that comes with GitHub for Windows installed in user home directories.
diff --git a/Help/release/dev/FindLATEX-components.rst b/Help/release/dev/FindLATEX-components.rst
deleted file mode 100644
index d161c1f822..0000000000
--- a/Help/release/dev/FindLATEX-components.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-FindLATEX-components
---------------------
-
-* The :module:`FindLATEX` module learned to support components.
diff --git a/Help/release/dev/FindOpenGL-no-X11.rst b/Help/release/dev/FindOpenGL-no-X11.rst
deleted file mode 100644
index dacf1651bf..0000000000
--- a/Help/release/dev/FindOpenGL-no-X11.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-FindOpenGL-no-X11
------------------
-
-* The :module:`FindOpenGL` module no longer explicitly searches
-  for any dependency on X11 libraries with the :module:`FindX11`
-  module.  Such dependencies should not need to be explicit.
-  Applications using X11 APIs themselves should find and link
-  to X11 libraries explicitly.
diff --git a/Help/release/dev/FindOpenSSL-separate-libs.rst b/Help/release/dev/FindOpenSSL-separate-libs.rst
deleted file mode 100644
index 96e39614e6..0000000000
--- a/Help/release/dev/FindOpenSSL-separate-libs.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-FindOpenSSL-separate-libs
--------------------------
-
-* The :module:`FindOpenSSL` module now reports ``crypto`` and ``ssl``
-  libraries separately in ``OPENSSL_CRYPTO_LIBRARY`` and
-  ``OPENSSL_SSL_LIBRARY``, respectively, to allow applications to
-  link to one without the other.
diff --git a/Help/release/dev/GNU-4.4-compile-features.rst b/Help/release/dev/GNU-4.4-compile-features.rst
deleted file mode 100644
index d5c13568d0..0000000000
--- a/Help/release/dev/GNU-4.4-compile-features.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-GNU-4.4-compile-features
-------------------------
-
-* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
-  is now aware of features supported by GNU 4.4 to 4.6 compilers.
diff --git a/Help/release/dev/SolarisStudio-compile-features.rst b/Help/release/dev/SolarisStudio-compile-features.rst
deleted file mode 100644
index 83110cd683..0000000000
--- a/Help/release/dev/SolarisStudio-compile-features.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-SolarisStudio-compile-features
-------------------------------
-
-* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
-  is now aware of features supported by Oracle SolarisStudio (``SunPro``).
diff --git a/Help/release/dev/WCDH-thread_local.rst b/Help/release/dev/WCDH-thread_local.rst
deleted file mode 100644
index 44516a78e0..0000000000
--- a/Help/release/dev/WCDH-thread_local.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-WriteCompilerDetectionHeader thread_local portability
------------------------------------------------------
-
-* The :module:`WriteCompilerDetectionHeader` module learned to
-  create a define for portability of the cxx_thread_local feature. The define
-  expands to either the C++11 ``thread_local`` keyword, or a
-  pre-standardization compiler-specific equivalent, as appropriate.
diff --git a/Help/release/dev/WriteCompilerDetectionHeader-multi-file-lang.rst b/Help/release/dev/WriteCompilerDetectionHeader-multi-file-lang.rst
deleted file mode 100644
index a8665da8f3..0000000000
--- a/Help/release/dev/WriteCompilerDetectionHeader-multi-file-lang.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-WriteCompilerDetectionHeader-multi-file
----------------------------------------
-
-* The :module:`WriteCompilerDetectionHeader` module learned to create
-  multiple output files per compiler and per language, instead of creating
-  one large file.
diff --git a/Help/release/dev/Xcode-clang-compile-features.rst b/Help/release/dev/Xcode-clang-compile-features.rst
deleted file mode 100644
index d93475fbe3..0000000000
--- a/Help/release/dev/Xcode-clang-compile-features.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-Xcode-clang-compile-features
-----------------------------
-
-* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
-  is now aware of features supported by Apple Clang (``AppleClang``).
diff --git a/Help/release/dev/add-FindGSL.rst b/Help/release/dev/add-FindGSL.rst
deleted file mode 100644
index 47a0a25ce1..0000000000
--- a/Help/release/dev/add-FindGSL.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-add-FindGSL
------------
-
-* A :module:`FindGSL` module was introduced to find the
-  GNU Scientific Library.
diff --git a/Help/release/dev/add-FindIntl.rst b/Help/release/dev/add-FindIntl.rst
deleted file mode 100644
index ac048c95dd..0000000000
--- a/Help/release/dev/add-FindIntl.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-add-FindIntl
-------------
-
-* The :module:`FindIntl` module was added to find the Gettext ``libintl``
-  library.
diff --git a/Help/release/dev/add-FindJsonCpp.rst b/Help/release/dev/add-FindJsonCpp.rst
deleted file mode 100644
index 5d1cb18dc6..0000000000
--- a/Help/release/dev/add-FindJsonCpp.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-add-FindJsonCpp
----------------
-
-* A :module:`FindJsonCpp` module was introduced to find the
-  JsonCpp package.
diff --git a/Help/release/dev/add-continue-command.rst b/Help/release/dev/add-continue-command.rst
deleted file mode 100644
index 4995a8ead2..0000000000
--- a/Help/release/dev/add-continue-command.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-add-continue-command
---------------------
-
-* A new :command:`continue` command was added that can be called inside loop
-  contexts to end the current iteration and start the next one at the top of
-  the loop block.
diff --git a/Help/release/dev/add-xz-support.rst b/Help/release/dev/add-xz-support.rst
deleted file mode 100644
index 9bdf5287cc..0000000000
--- a/Help/release/dev/add-xz-support.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-add-xz-support
---------------
-
-* The :manual:`cmake(1)` ``-E tar`` command now supports creating
-  ``.xz``-compressed archives with the ``J`` flag.
diff --git a/Help/release/dev/add_javascript_coverage_parser.rst b/Help/release/dev/add_javascript_coverage_parser.rst
deleted file mode 100644
index 0d068ee4aa..0000000000
--- a/Help/release/dev/add_javascript_coverage_parser.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-add_javascript_coverage_parser
-------------------------------
-
-* The :command:`ctest_coverage` learned to support Javascript coverage.
diff --git a/Help/release/dev/break-command-strictness.rst b/Help/release/dev/break-command-strictness.rst
deleted file mode 100644
index 0723774ed0..0000000000
--- a/Help/release/dev/break-command-strictness.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-break-command-strictness
-------------------------
-
-* The :command:`break` command now rejects calls outside of a loop
-  context or that pass arguments to the command.
-  See policy :policy:`CMP0055`.
diff --git a/Help/release/dev/cached-regex-clear-fixed.rst b/Help/release/dev/cached-regex-clear-fixed.rst
deleted file mode 100644
index fbf08cca7b..0000000000
--- a/Help/release/dev/cached-regex-clear-fixed.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-cached-regex-clear-fixed
-------------------------
-
-* Add :variable:`CMAKE_MATCH_COUNT` for the number of matches made in the last
-  regular expression.
diff --git a/Help/release/dev/cmake-E-tar-files-from.rst b/Help/release/dev/cmake-E-tar-files-from.rst
deleted file mode 100644
index f6087ff87d..0000000000
--- a/Help/release/dev/cmake-E-tar-files-from.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-cmake-E-tar-files-from
-----------------------
-
-* The :manual:`cmake(1)` ``-E tar`` command learned a new
-  ``--files-from=<file>`` option to specify file names using
-  lines in a file to overcome command-line length limits.
diff --git a/Help/release/dev/cmake-E-tar-mtime.rst b/Help/release/dev/cmake-E-tar-mtime.rst
deleted file mode 100644
index 6496577e3d..0000000000
--- a/Help/release/dev/cmake-E-tar-mtime.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-cmake-E-tar-mtime
------------------
-
-* The :manual:`cmake(1)` ``-E tar`` command learned a new
-  ``--mtime=<date>`` option to specify the modification time
-  recorded in tarball entries.
diff --git a/Help/release/dev/console-pool.rst b/Help/release/dev/console-pool.rst
deleted file mode 100644
index 1d9bdb8e49..0000000000
--- a/Help/release/dev/console-pool.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-console-pool
-------------
-
-* The :command:`add_custom_command` and :command:`add_custom_target`
-  commands learned a new ``USES_TERMINAL`` option to request that
-  the command be given direct access to the terminal if possible.
-  The :generator:`Ninja` generator will places such commands in the
-  ``console`` pool.  Build targets provided by CMake that are meant
-  for individual interactive use, such as ``install``, are now
-  placed in this pool.
diff --git a/Help/release/dev/cpack-rpm-component-descriptions.rst b/Help/release/dev/cpack-rpm-component-descriptions.rst
deleted file mode 100644
index 769a91285c..0000000000
--- a/Help/release/dev/cpack-rpm-component-descriptions.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-cpack-rpm-component-descriptions
---------------------------------
-
-* The :module:`CPackRPM` module learned options to set per-component
-  descriptions and summaries.  See the
-  :variable:`CPACK_RPM_<component>_PACKAGE_DESCRIPTION` and
-  :variable:`CPACK_RPM_<component>_PACKAGE_SUMMARY` variables.
diff --git a/Help/release/dev/cpack-rpm-pre-post-install.rst b/Help/release/dev/cpack-rpm-pre-post-install.rst
deleted file mode 100644
index 0909d940ef..0000000000
--- a/Help/release/dev/cpack-rpm-pre-post-install.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-cpack-rpm-pre-post-install
---------------------------
-
-* The :module:`CPackRPM` module learned options to specify
-  requirements for pre- and post-install scripts.  See the
-  :variable:`CPACK_RPM_PACKAGE_REQUIRES_PRE` and
-  :variable:`CPACK_RPM_PACKAGE_REQUIRES_POST` variables.
-
-* The :module:`CPackRPM` module learned options to specify
-  requirements for pre- and post-uninstall scripts.  See the
-  :variable:`CPACK_RPM_PACKAGE_REQUIRES_PREUN` and
-  :variable:`CPACK_RPM_PACKAGE_REQUIRES_POSTUN` variables.
diff --git a/Help/release/dev/ctest-delphi-coverage.rst b/Help/release/dev/ctest-delphi-coverage.rst
deleted file mode 100644
index efa97c9243..0000000000
--- a/Help/release/dev/ctest-delphi-coverage.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-ctest-delphi-coverage
----------------------
-
-* The :command:`ctest_coverage` learned to support Delphi coverage.
diff --git a/Help/release/dev/curl-darwinssl.rst b/Help/release/dev/curl-darwinssl.rst
deleted file mode 100644
index 3571bd1b38..0000000000
--- a/Help/release/dev/curl-darwinssl.rst
+++ /dev/null
@@ -1,9 +0,0 @@
-curl-darwinssl
---------------
-
-* On OS X, commands supporting network communication, such as
-  :command:`file(DOWNLOAD)`, :command:`file(UPLOAD)`, and
-  :command:`ctest_submit`, now support SSL/TLS even when CMake
-  is not built against OpenSSL.  The OS X native SSL/TLS
-  implementation is used by default.  OS-configured certificate
-  authorities will be trusted automatically.
diff --git a/Help/release/dev/curl-default-cainfo.rst b/Help/release/dev/curl-default-cainfo.rst
deleted file mode 100644
index ed45d36e3f..0000000000
--- a/Help/release/dev/curl-default-cainfo.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-curl-default-cainfo
--------------------
-
-* When CMake is built with OpenSSL on systems other than Windows
-  and OS X, commands supporting network communication via ``https``,
-  such as :command:`file(DOWNLOAD)`, :command:`file(UPLOAD)`, and
-  :command:`ctest_submit`, now search for OS-configured certificate
-  authorities in a few ``/etc`` paths to be trusted automatically.
diff --git a/Help/release/dev/curl-winssl.rst b/Help/release/dev/curl-winssl.rst
deleted file mode 100644
index 9a28f4fcad..0000000000
--- a/Help/release/dev/curl-winssl.rst
+++ /dev/null
@@ -1,9 +0,0 @@
-curl-winssl
------------
-
-* On Windows, commands supporting network communication, such as
-  :command:`file(DOWNLOAD)`, :command:`file(UPLOAD)`, and
-  :command:`ctest_submit`, now support SSL/TLS even when CMake
-  is not built against OpenSSL.  The Windows native SSL/TLS
-  implementation is used by default.  OS-configured certificate
-  authorities will be trusted automatically.
diff --git a/Help/release/dev/custom-command-byproducts.rst b/Help/release/dev/custom-command-byproducts.rst
deleted file mode 100644
index dc85fdbbc1..0000000000
--- a/Help/release/dev/custom-command-byproducts.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-custom-command-byproducts
--------------------------
-
-* The :command:`add_custom_command` and :command:`add_custom_target`
-  commands learned a new ``BYPRODUCTS`` option to specify files
-  produced as side effects of the custom commands.  These are not
-  outputs because they do not always have to be newer than inputs.
diff --git a/Help/release/dev/feature-record-msvc.rst b/Help/release/dev/feature-record-msvc.rst
deleted file mode 100644
index a8c9fd164c..0000000000
--- a/Help/release/dev/feature-record-msvc.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-feature-record-msvc
--------------------
-
-* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
-  is now aware of features supported by Microsoft Visual Studio (``MSVC``).
diff --git a/Help/release/dev/file-LOCK-command.rst b/Help/release/dev/file-LOCK-command.rst
deleted file mode 100644
index 4b11e9e6e3..0000000000
--- a/Help/release/dev/file-LOCK-command.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-file-LOCK-command
------------------
-
-* The :command:`file(LOCK)` subcommand was created to allow CMake
-  processes to synchronize through file and directory locks.
diff --git a/Help/release/dev/file-strings-utf-16.rst b/Help/release/dev/file-strings-utf-16.rst
deleted file mode 100644
index f40b63eb9c..0000000000
--- a/Help/release/dev/file-strings-utf-16.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-file-strings-utf-16
--------------------
-
-* The :command:`file(STRINGS)` now supports UTF-16LE, UTF-16BE,
-  UTF-32LE, UTF-32BE as ``ENCODING`` options.
diff --git a/Help/release/dev/find-msmpi.rst b/Help/release/dev/find-msmpi.rst
deleted file mode 100644
index 6ece5c8de4..0000000000
--- a/Help/release/dev/find-msmpi.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-find-msmpi
-----------
-
-* The :module:`FindMPI` module learned to find MS-MPI on Windows.
diff --git a/Help/release/dev/install-EXPORT-absolute-prefix.rst b/Help/release/dev/install-EXPORT-absolute-prefix.rst
deleted file mode 100644
index 1b2a01c183..0000000000
--- a/Help/release/dev/install-EXPORT-absolute-prefix.rst
+++ /dev/null
@@ -1,9 +0,0 @@
-install-EXPORT-absolute-prefix
-------------------------------
-
-* The :command:`install(EXPORT)` command now works with an absolute
-  ``DESTINATION`` even if targets in the export set are installed
-  with a destination or usage requirements specified relative to the
-  install prefix.  The value of the :variable:`CMAKE_INSTALL_PREFIX`
-  variable is hard-coded into the installed export file as the base
-  for relative references.
diff --git a/Help/release/dev/record-GNU-5-features.rst b/Help/release/dev/record-GNU-5-features.rst
deleted file mode 100644
index 0da9e759da..0000000000
--- a/Help/release/dev/record-GNU-5-features.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-record-GNU-5-features
----------------------
-
-* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
-  is now aware of features supported by GNU compiler version 5.0.
diff --git a/Help/release/dev/rpm_multi_prefix.rst b/Help/release/dev/rpm_multi_prefix.rst
deleted file mode 100644
index 0329592738..0000000000
--- a/Help/release/dev/rpm_multi_prefix.rst
+++ /dev/null
@@ -1,11 +0,0 @@
-rpm_multi_prefix
-----------------
-
-* The :module:`CPackRPM` module learned a new
-  :variable:`CPACK_RPM_<COMPONENT>_PACKAGE_PREFIX` variable to
-  specify a component-specific value to use instead of
-  :variable:`CPACK_PACKAGING_INSTALL_PREFIX`.
-
-* The :module:`CPackRPM` module learned a new
-  :variable:`CPACK_RPM_RELOCATION_PATHS` variable to
-  specify multiple relocation prefixes for a single rpm package.
diff --git a/Help/release/dev/try-run-link-libraries.rst b/Help/release/dev/try-run-link-libraries.rst
deleted file mode 100644
index 4f20cbd872..0000000000
--- a/Help/release/dev/try-run-link-libraries.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-try-run-link-libraries
-----------------------
-
-* The :command:`try_run` command learned to honor the ``LINK_LIBRARIES``
-  option just as :command:`try_compile` already does.
diff --git a/Help/release/dev/try_compile-link-flags.rst b/Help/release/dev/try_compile-link-flags.rst
deleted file mode 100644
index d995e0b92a..0000000000
--- a/Help/release/dev/try_compile-link-flags.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-try_compile-link-flags
-----------------------
-
-* The :command:`try_compile` command source file signature now honors
-  link flags (e.g. :variable:`CMAKE_EXE_LINKER_FLAGS`) in the generated
-  test project.  See policy :policy:`CMP0056`.
diff --git a/Help/release/dev/unsupported-compilers.rst b/Help/release/dev/unsupported-compilers.rst
deleted file mode 100644
index 1f3e8c16ac..0000000000
--- a/Help/release/dev/unsupported-compilers.rst
+++ /dev/null
@@ -1,22 +0,0 @@
-unsupported-compilers
----------------------
-
-* The implementation of CMake relies on some C++ compiler features which are
-  not supported by some older compilers.  As a result, those old compilers
-  can no longer be used to build CMake itself.  CMake continues to be able to
-  generate Makefiles and project files for users of those old compilers
-  however.  The compilers known to no longer be capable of building CMake
-  are:
-
-  * MSVC 6 and 7.0 - superceded by VisualStudio 7.1 and newer compilers.
-  * GCC 2.95 - superceded by GCC 3 and newer compilers.
-  * Borland compilers - superceded by other Windows compilers.
-  * Compaq compilers - superceded by other compilers.
-  * Comeau compilers - superceded by other compilers.
-  * SGI compilers - IRIX was dropped as a host platform.
-
-  When building using SolarisStudio 12, the default ``libCStd`` standard
-  library is not sufficient to build CMake.  The SolarisStudio distribution
-  supports compiler options to use ``STLPort4`` or ``libstdc++``.  An
-  appropriate option to select the standard library is now added
-  automatically when building CMake with SolarisStudio compilers.
diff --git a/Help/release/dev/vs-nsight-tegra-min-api.rst b/Help/release/dev/vs-nsight-tegra-min-api.rst
deleted file mode 100644
index f8fa056d86..0000000000
--- a/Help/release/dev/vs-nsight-tegra-min-api.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-vs-nsight-tegra-min-api
------------------------
-
-* A :prop_tgt:`ANDROID_API_MIN` target property was introduced to
-  specify the minimum version to be targeted by the toolchain.
diff --git a/Help/release/dev/vs-shader-flags.rst b/Help/release/dev/vs-shader-flags.rst
deleted file mode 100644
index 0d3f6cc3f5..0000000000
--- a/Help/release/dev/vs-shader-flags.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-vs-shader-flags
----------------
-
-* A :prop_sf:`VS_SHADER_FLAGS` source file property was added to specify
-  additional shader flags to ``.hlsl`` files, for the Visual Studio generators.
diff --git a/Help/release/dev/windows-utf-8.rst b/Help/release/dev/windows-utf-8.rst
deleted file mode 100644
index 64cd616388..0000000000
--- a/Help/release/dev/windows-utf-8.rst
+++ /dev/null
@@ -1,22 +0,0 @@
-windows-utf-8
--------------
-
-* On Windows, CMake learned to support international characters.
-  This allows use of characters from multiple (spoken) languages
-  in CMake code, paths to source files, configured files such as
-  ``.h.in`` files, and other files read and written by CMake.
-  Because CMake interoperates with many other tools, there may
-  still be some limitations when using certain international
-  characters.
-
-  Files written in the :manual:`cmake-language(7)`, such as
-  ``CMakeLists.txt`` or ``*.cmake`` files, are expected to be
-  encoded as UTF-8.  If files are already ASCII, they will be
-  compatible.  If files were in a different encoding, including
-  Latin 1, they will need to be converted.
-
-  The Visual Studio generators now write solution and project
-  files in UTF-8 instead of Windows-1252.  Windows-1252 supported
-  Latin 1 languages such as those found in North and South America
-  and Western Europe.  With UTF-8, additional languages are now
-  supported.
diff --git a/Help/release/dev/xcode-revise-make-program.rst b/Help/release/dev/xcode-revise-make-program.rst
deleted file mode 100644
index f50cf44a7b..0000000000
--- a/Help/release/dev/xcode-revise-make-program.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-xcode-revise-make-program
--------------------------
-
-* The :generator:`Xcode` generator no longer requires a value for
-  the :variable:`CMAKE_MAKE_PROGRAM` variable to be located up front.
-  It now locates ``xcodebuild`` when needed at build time.
diff --git a/Help/release/index.rst b/Help/release/index.rst
index abc19b8e8f..990accfe8c 100644
--- a/Help/release/index.rst
+++ b/Help/release/index.rst
@@ -13,5 +13,6 @@ Releases
 .. toctree::
    :maxdepth: 1
 
+   3.2.0 <3.2.0>
    3.1.0 <3.1.0>
    3.0.0 <3.0.0>