summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2017-02-01 15:13:03 (GMT)
committerBrad King <brad.king@kitware.com>2017-02-06 15:34:12 (GMT)
commit3f5e4f1957c33335d792f6edde62ca59d3b158fb (patch)
tree57c9f84010b5667653ec4c37f60d1b44ef442d19 /Help
parent811c854efffba6f97bb3038b651fed7fc1bcf2be (diff)
downloadCMake-3f5e4f1957c33335d792f6edde62ca59d3b158fb.zip
CMake-3f5e4f1957c33335d792f6edde62ca59d3b158fb.tar.gz
CMake-3f5e4f1957c33335d792f6edde62ca59d3b158fb.tar.bz2
Help: Consolidate 3.8 release notes
Move all development release notes into a new version-specific document: tail -q -n +3 Help/release/dev/* > Help/release/3.8.rst git rm -- Help/release/dev/* except the sample topic: git checkout HEAD -- Help/release/dev/0-sample-topic.rst Reference the new document from the release notes index document. Add a title and intro sentence to the new document by hand.
Diffstat (limited to 'Help')
-rw-r--r--Help/release/3.8.rst381
-rw-r--r--Help/release/dev/CUDA-language-support.rst6
-rw-r--r--Help/release/dev/ExternalData-multiple-hashes.rst7
-rw-r--r--Help/release/dev/ExternalProject-GIT_CONFIG.rst5
-rw-r--r--Help/release/dev/FeatureSummary_enhancement.rst22
-rw-r--r--Help/release/dev/FindOpenGL-imported-targets.rst5
-rw-r--r--Help/release/dev/QtAutogen_Contain.rst10
-rw-r--r--Help/release/dev/QtAutogen_Skip.rst12
-rw-r--r--Help/release/dev/SOURCE_DATE_EPOCH.rst5
-rw-r--r--Help/release/dev/SublimeText-no-VERBOSE.rst6
-rw-r--r--Help/release/dev/UseSWIG-SWIG_OUTFILE_DIR.rst6
-rw-r--r--Help/release/dev/WCDH_allow_unsupported.rst8
-rw-r--r--Help/release/dev/add-BUILD_RPATH.rst6
-rw-r--r--Help/release/dev/add-LANG_CPPLINT.rst8
-rw-r--r--Help/release/dev/add-SHA-3.rst4
-rw-r--r--Help/release/dev/allow-fallback-config-mapping.rst6
-rw-r--r--Help/release/dev/capture-clang-tidy-errors.rst6
-rw-r--r--Help/release/dev/cdash_upload_retry.rst5
-rw-r--r--Help/release/dev/codeblocks-nmake-makefiles-jom.rst5
-rw-r--r--Help/release/dev/codelite-build-and-clean-targets-enhancement.rst10
-rw-r--r--Help/release/dev/compile-features-for-language-standards.rst7
-rw-r--r--Help/release/dev/cpack-ifw-configure-file.rst9
-rw-r--r--Help/release/dev/cpack-ifw-options.rst21
-rw-r--r--Help/release/dev/cpack-ifw-package-options.rst7
-rw-r--r--Help/release/dev/cpack-productbuild-signing.rst8
-rw-r--r--Help/release/dev/cpack-rpm-omit-unsupported-tags.rst8
-rw-r--r--Help/release/dev/cpack-rpm-single-debuginfo.rst11
-rw-r--r--Help/release/dev/cpack-rpm-user-file-list-with-multiple-directives.rst6
-rw-r--r--Help/release/dev/ctest_memcheck-leak_sanitizer.rst19
-rw-r--r--Help/release/dev/ctest_memcheck_defect_count.rst5
-rw-r--r--Help/release/dev/execute_process-encoding.rst5
-rw-r--r--Help/release/dev/expand_custom_commands.rst7
-rw-r--r--Help/release/dev/external-project-clone-progress.rst5
-rw-r--r--Help/release/dev/features-c++17.rst6
-rw-r--r--Help/release/dev/fuchsia-platform.rst4
-rw-r--r--Help/release/dev/gcc-features.rst5
-rw-r--r--Help/release/dev/if-genex.rst7
-rw-r--r--Help/release/dev/imported-interface-libname.rst7
-rw-r--r--Help/release/dev/imported-interface-no-system.rst5
-rw-r--r--Help/release/dev/intel-compile-features-windows.rst6
-rw-r--r--Help/release/dev/manually-added-dependencies.rst6
-rw-r--r--Help/release/dev/math-EXPR-unary.rst5
-rw-r--r--Help/release/dev/pkg-config-recheck.rst7
-rw-r--r--Help/release/dev/source_group-tree.rst5
-rw-r--r--Help/release/dev/src-COMPILE_FLAGS-genex.rst5
-rw-r--r--Help/release/dev/st2-env-settings.rst6
-rw-r--r--Help/release/dev/st2-exclude-patterns-variable.rst7
-rw-r--r--Help/release/dev/static-frameworks.rst6
-rw-r--r--Help/release/dev/swig_add_library.rst8
-rw-r--r--Help/release/dev/timestamp-percent.rst5
-rw-r--r--Help/release/dev/try_compile-honor-CMAKE_WARN_DEPRECATED.rst6
-rw-r--r--Help/release/dev/try_compile-lang-std.rst9
-rw-r--r--Help/release/dev/vs-advanced-source-properties.rst12
-rw-r--r--Help/release/dev/vs-csharp-support.rst34
-rw-r--r--Help/release/dev/vs-custom-msbuild-props.rst9
-rw-r--r--Help/release/dev/vs-debugger-config.rst6
-rw-r--r--Help/release/dev/vs-default-build-package.rst7
-rw-r--r--Help/release/dev/vs-dotnet-references.rst13
-rw-r--r--Help/release/dev/vs-flag-order.rst9
-rw-r--r--Help/release/dev/vs-host-x64-tools.rst7
-rw-r--r--Help/release/dev/vs_targets_file_as_library.rst6
-rw-r--r--Help/release/dev/wix-reg-install-dir.rst6
-rw-r--r--Help/release/dev/xcode-effective-platform-name.rst8
-rw-r--r--Help/release/dev/xcode-message-extension.rst7
-rw-r--r--Help/release/index.rst1
65 files changed, 382 insertions, 499 deletions
diff --git a/Help/release/3.8.rst b/Help/release/3.8.rst
new file mode 100644
index 0000000..1efafac
--- /dev/null
+++ b/Help/release/3.8.rst
@@ -0,0 +1,381 @@
+CMake 3.8 Release Notes
+***********************
+
+.. only:: html
+
+ .. contents::
+
+Changes made since CMake 3.7 include the following.
+
+* A :variable:`CMAKE_BUILD_RPATH` variable and corresponding
+ :prop_tgt:`BUILD_RPATH` target property were added to support custom
+ ``RPATH`` locations to be added to binaries in the build tree.
+
+* A :prop_tgt:`<LANG>_CPPLINT` target property and supporting
+ :variable:`CMAKE_<LANG>_CPPLINT` variable were introduced to tell
+ the :ref:`Makefile Generators` and the :generator:`Ninja` generator to
+ run the ``cpplint`` style checker along with the compiler for ``C`` and
+ ``CXX`` languages.
+
+* CMake functionality using cryptographic hashes now supports SHA-3 algorithms.
+
+* The :prop_tgt:`MAP_IMPORTED_CONFIG_<CONFIG>` target property learned
+ to interpret empty list elements as referring to the configuration-less
+ imported location specified by :prop_tgt:`IMPORTED_LOCATION`.
+
+* If a command specified by the :prop_tgt:`<LANG>_CLANG_TIDY` target property
+ returns non-zero at build time this is now treated as an error instead of
+ silently ignored.
+
+* The ``CDASH_UPLOAD`` signature of :command:`ctest_submit` was taught to honor
+ the ``RETRY_COUNT``, ``RETRY_DELAY``, and ``QUIET`` options.
+
+* The :generator:`CodeBlocks` now can generate with
+ :generator:`NMake Makefiles JOM`.
+
+* The :generator:`CodeLite` extra generator gained a new option
+ set by the :variable:`CMAKE_CODELITE_USE_TARGETS` variable to
+ change the generated project to have target-centric organization.
+ The "build", "rebuild", and "clean" operations within CodeLite
+ then work on a selected target rather than the whole workspace.
+ (Note that the :generator:`Ninja` clean operation on a target
+ includes its dependencies, though.)
+
+* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
+ now offers meta-features that request compiler modes for specific language
+ standard levels. See :prop_gbl:`CMAKE_C_KNOWN_FEATURES` and
+ :prop_gbl:`CMAKE_CXX_KNOWN_FEATURES`.
+
+* The :command:`cpack_ifw_configure_file` command was added
+ (in :module:`CPackIFWConfigureFile`) to configure file templates prepared
+ in QtIFW/SDK/Creator style.
+
+* The :module:`CPackIFWConfigureFile` module was added to define
+ :command:`cpack_ifw_configure_file` command.
+
+* The :module:`CPackIFW` module :command:`cpack_ifw_configure_component` and
+ :command:`cpack_ifw_configure_component_group` commands gained a new
+ ``DEFAULT``, ``VIRTUAL``, ``FORCED_INSTALLATION``, ``REQUIRES_ADMIN_RIGHTS``,
+ ``DISPLAY_NAME``, ``UPDATE_TEXT``, ``DESCRIPTION``, ``RELEASE_DATE``,
+ ``AUTO_DEPEND_ON`` and ``TRANSLATIONS`` options to more specific
+ configuration.
+
+* The :module:`CPackIFW` module :command:`cpack_ifw_configure_component`
+ command gained a new ``DEPENDENCIES`` alias for ``DEPENDS`` option.
+
+* The :module:`CPackIFW` module :command:`cpack_ifw_configure_component_group`
+ command gained a new ``DEPENDS`` option. The ``DEPENDENCIES`` alias also
+ added.
+
+* The :module:`CPackIFW` module :command:`cpack_ifw_configure_component` and
+ :command:`cpack_ifw_configure_component_group` commands ``PRIORITY``
+ option now is deprecated and will be removed in a future version of CMake.
+ Please use new ``SORTING_PRIORITY`` option instead.
+
+* The :module:`CPackIFW` module gained new :variable:`CPACK_IFW_PACKAGE_WATERMARK`, :variable:`CPACK_IFW_PACKAGE_BANNER`,
+ :variable:`CPACK_IFW_PACKAGE_BACKGROUND`, :variable:`CPACK_IFW_PACKAGE_WIZARD_STYLE`, :variable:`CPACK_IFW_PACKAGE_WIZARD_DEFAULT_WIDTH`,
+ :variable:`CPACK_IFW_PACKAGE_WIZARD_DEFAULT_HEIGHT` and :variable:`CPACK_IFW_PACKAGE_TITLE_COLOR`
+ variables to customize a QtIFW installer look.
+
+* The :module:`CPackProductBuild` module gained options to sign packages.
+ See the variables :variable:`CPACK_PRODUCTBUILD_IDENTITY_NAME`,
+ :variable:`CPACK_PRODUCTBUILD_KEYCHAIN_PATH`,
+ :variable:`CPACK_PKGBUILD_IDENTITY_NAME`, and
+ :variable:`CPACK_PKGBUILD_KEYCHAIN_PATH`.
+
+* The :module:`CPackRPM` module learned to omit
+ tags that are not supported by provided
+ rpmbuild tool. If unsupported tags are set
+ they are ignored and a developer warning is
+ printed out.
+
+* The :module:`CPackRPM` module learned to generate main component package
+ which forces generation of a rpm for defined component without component
+ suffix in filename and package name.
+ See :variable:`CPACK_RPM_MAIN_COMPONENT` variable.
+
+* The :module:`CPackRPM` module learned to generate a single debuginfo package
+ on demand even if components packagin is used.
+ See :variable:`CPACK_RPM_DEBUGINFO_SINGLE_PACKAGE` variable.
+
+* The :module:`CPackRPM` module learned to support
+ multiple directives per file when using
+ :variable:`CPACK_RPM_USER_FILELIST` variable.
+
+* The :command:`ctest_memcheck` command gained a ``DEFECT_COUNT <var>``
+ option to capture the number of memory defects detected.
+
+* The :command:`ctest_memcheck` command learned to support ``LeakSanitizer``
+ independently from ``AddressSanitizer``.
+
+* The :command:`ctest_memcheck` command no longer automatically adds
+ ``leak_check=1`` to the options used by ``AddressSanitizer``. The default
+ behavior of ``AddressSanitizer`` is to run `LeakSanitizer` to check leaks
+ unless ``leak_check=0``.
+
+* The :command:`ctest_memcheck` command learned to read the location of
+ suppressions files for sanitizers from the
+ :variable:`CTEST_MEMORYCHECK_SUPPRESSIONS_FILE` variable.
+
+* The :command:`ctest_memcheck` command was fixed to correctly append extra
+ sanitizer options read from the
+ :variable:`CTEST_MEMORYCHECK_SANITIZER_OPTIONS` variable to the environment
+ variables used internally by the sanitizers.
+
+* CMake learned to support CUDA as a first-class language.
+ It is supported by the :ref:`Makefile Generators` and the
+ :generator:`Ninja` generator.
+
+* The :command:`execute_process` command gained an ``ENCODING`` option to
+ specify on Windows which encoding is used for output from child process.
+
+* The commands :command:`add_custom_command` and :command:`add_custom_target`
+ learned the option ``COMMAND_EXPAND_LISTS`` which causes lists in the
+ ``COMMAND`` argument to be expanded, including lists created by generator
+ expressions.
+
+* The :module:`ExternalData` module learned to support multiple
+ content links for one data file using different hashes, e.g.
+ ``img.png.sha256`` and ``img.png.sha1``. This allows objects
+ to be fetched from sources indexed by different hash algorithms.
+
+* The :module:`ExternalProject` module gained the ``GIT_PROGRESS`` option to
+ force Git to show progress when cloning repositories.
+
+* The :module:`ExternalProject` module gained a ``GIT_CONFIG`` option
+ to pass ``--config`` options to Git when cloning repositories.
+
+* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
+ is now aware of C++ 17. No specific features are yet enumerated besides
+ the ``cxx_std_17`` meta-feature.
+
+* The :command:`set_package_info`, :command:`set_feature_info`,
+ :command:`print_enabled_features` and :command:`print_disabled_features`
+ commands from the the :module:`FeatureSummary` module are now deprecated.
+
+* The :command:`set_package_properties` command no longer forces the package
+ type to ``OPTIONAL`` when the type is not explicitly set.
+
+* The :command:`feature_summary` command in the :module:`FeatureSummary` module
+ accepts the new ``QUIET_ON_EMPTY`` option that will suppresses the output when
+ the list of packages that belong to the selected category is empty.
+
+* The :command:`add_feature_info` in the :module:`FeatureSummary` module learned
+ to accept lists of dependencies for deciding whether a feature is enabled or
+ not.
+
+* The package types accepted by the the :module:`FeatureSummary` module can now
+ be tweaked by changing the :variable:`FeatureSummary_PKG_TYPES`,
+ :variable:`FeatureSummary_REQUIRED_PKG_TYPES` and
+ :variable:`FeatureSummary_DEFAULT_PKG_TYPE` global properties.
+
+* The :module:`FindOpenGL` module now provides imported targets
+ ``OpenGL::GL`` and ``OpenGL::GLU`` when the libraries are found.
+
+* A new minimal platform file for Fuchsia was added.
+
+* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
+ is now aware of the availability of C99 in gcc since version 3.4.
+
+* A new logical generator expression for immediate-if was added:
+ ``$<IF:cond,true-value,false-value>``. It takes three arguments: One
+ condition, a true-value, and a false-value. Resolves to the true-value if the
+ condition is ``1``, and resolves to the false-value if the condition is ``0``.
+
+* :ref:`Imported <Imported Targets>` :ref:`Interface Libraries` learned new
+ :prop_tgt:`IMPORTED_LIBNAME` and :prop_tgt:`IMPORTED_LIBNAME_<CONFIG>`
+ target properties to specify a link library name since interface libraries
+ do not build their own library files.
+
+* The :prop_tgt:`NO_SYSTEM_FROM_IMPORTED` target property is now supported
+ on :ref:`Imported <Imported Targets>` :ref:`Interface Libraries`.
+
+* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
+ is now aware of features supported by Intel C++ compilers versions 12.1
+ through 17.0 on UNIX and Windows platforms.
+
+* The target property :prop_tgt:`MANUALLY_ADDED_DEPENDENCIES` has
+ been added. It is read-only and could be used to retrieve
+ dependencies that have been added with :command:`add_dependencies`.
+
+* The :command:`math(EXPR)` command gained support for unary
+ ``+`` and ``-`` expressions.
+
+* Calls to the :module:`FindPkgConfig` module :command:`pkg_check_modules`
+ command following a successful call learned to re-evaluate the cached values
+ for a given prefix after changes to the parameters to the command for that
+ prefix.
+
+* When using AUTOMOC or AUTOUIC, generated
+ ``moc_*``, ``*.moc`` and ``ui_*`` are placed in the
+ ``<CMAKE_CURRENT_BINARY_DIR>/<TARGETNAME>_autogen/include`` directory which
+ is automatically added to the target's :prop_tgt:`INCLUDE_DIRECTORIES`.
+ It is therefore not necessary anymore to have
+ :variable:`CMAKE_CURRENT_BINARY_DIR` in the target's
+ :prop_tgt:`INCLUDE_DIRECTORIES`.
+
+* The source file properties
+ :prop_sf:`SKIP_AUTOMOC`,
+ :prop_sf:`SKIP_AUTOUIC`,
+ :prop_sf:`SKIP_AUTORCC` and
+ :prop_sf:`SKIP_AUTOGEN`
+ allow to exclude files from
+ :prop_tgt:`AUTOMOC`,
+ :prop_tgt:`AUTOUIC` and
+ :prop_tgt:`AUTORCC` processing.
+
+* The :command:`string(TIMESTAMP)` will now honor the ``SOURCE_DATE_EPOCH``
+ environment variable and use its value instead of the current time.
+
+* The :command:`source_group` command gained ``TREE`` and ``PREFIX``
+ options to add groups following source tree directory structure.
+
+* The :prop_sf:`COMPILE_FLAGS` source file property learned to support
+ :manual:`generator expressions <cmake-generator-expressions(7)>`.
+
+* The :generator:`Sublime Text 2` extra generator learned to place
+ environment variables in the generated ``.sublime-project``.
+ See the :variable:`CMAKE_SUBLIME_TEXT_2_ENV_SETTINGS` variable.
+
+* The :generator:`Sublime Text 2` extra generator no longer excludes the
+ build tree from the ``.sublime-project`` when it is inside the source tree.
+ The :variable:`CMAKE_SUBLIME_TEXT_2_EXCLUDE_BUILD_TREE` variable
+ was added to control the behavior explicitly.
+
+* The :prop_tgt:`FRAMEWORK` property could now also be applied to
+ static libraries on Apple targets. It will result in a proper
+ Framework but with a static library inside.
+
+* The :generator:`Sublime Text 2` generator no longer runs the native
+ build command (e.g. ``ninja`` or ``make``) with verbose build output
+ enabled.
+
+* The :module:`UseSWIG` module gained a ``swig_add_library`` command
+ to give more flexibility over the old ``swig_add_module`` command.
+
+* The :module:`UseSWIG` module ``swig_add_module`` command is now
+ deprecated in favor of ``swig_add_library``.
+
+* The :command:`string(TIMESTAMP)` command learned to treat ``%%``
+ as a way to encode plain ``%``.
+
+* The :command:`try_compile` command source file signature now
+ honors the :variable:`CMAKE_WARN_DEPRECATED` variable value
+ in the generated test project.
+
+* The :command:`try_compile` command source file signature gained new options
+ to specify the language standard to use in the generated test project.
+
+* The :command:`try_compile` command source file signature now honors
+ language standard variables like :variable:`CMAKE_CXX_STANDARD`.
+ See policy :policy:`CMP0067`.
+
+* The :module:`UseSWIG` module ``swig_add_source_to_module`` command
+ learned a new ``SWIG_OUTFILE_DIR`` option to control the output
+ file location (``swig -o``).
+
+* The :ref:`Visual Studio Generators` for VS 2010 and above
+ learned some more source file properties:
+
+ - :prop_sf:`VS_RESOURCE_GENERATOR` (C# only): allows setting the resource
+ generator
+ - :prop_sf:`VS_COPY_TO_OUT_DIR`: parameter to set if file should be copied
+ to output directory (values: ``Never``, ``Always``, ``PreserveNewest``)
+ - :prop_sf:`VS_INCLUDE_IN_VSIX`: boolean property to include file include
+ Visual Studio extension package
+
+* The :ref:`Visual Studio Generators` for VS 2010 and above
+ learned to support the C# language. C# assemblies and
+ programs can be added just like common C++ targets using
+ the :command:`add_library` and :command:`add_executable`
+ commands. Referencing between several C# targets in the same
+ source tree is done by :command:`target_link_libraries` like
+ for C++. Referencing to system or 3rd party assemblies is
+ done by the target properties :prop_tgt:`VS_DOTNET_REFERENCE_<refname>`
+ and :prop_tgt:`VS_DOTNET_REFERENCES`.
+
+* C# as a language can be enabled using :command:`enable_language`
+ or :command:`project` with ``CSharp``. It is not enabled by
+ default.
+
+* Flag variables, target properties and other configuration
+ that specifically targets C# contains ``CSharp`` as a part of
+ their names.
+
+* More finetuning of C# targets can be done using target and source
+ file properties. Specifically the Visual Studio related target
+ properties (``VS_*``) are worth a look (for setting toolset
+ versions, root namespaces, assembly icons, ...).
+
+* **Auto-"linking"** in .csproj files: In C#/.NET development with
+ Visual Studio there is a number of visual editors used which
+ generate code. Both the generated files and the ones edited
+ with the UI are connected in the ``.csproj`` file using
+ ``<DependentUpon>`` tags. If CMake finds within a C# project
+ any source file with extension ``.Designer.cs`` or ``.xaml.cs``,
+ it checks sibling files with extension ``.xaml``, ``.settings``,
+ ``.resx`` or ``.cs`` and establishes the dependency connection.
+
+* The :ref:`Visual Studio Generators` for VS 2010 and above can
+ now be fine tuned using custom msbuild .props files.
+ :prop_tgt:`VS_USER_PROPS` can be
+ used to change the default path of the user .props file from
+ ``$(UserRootDir)\\Microsoft.Cpp.$(Platform).user.props`` to
+ an arbitrary filename.
+
+* For the :ref:`Visual Studio Generators` for VS 2010 and above
+ the working directory for debugging can be set using a new
+ :prop_tgt:`VS_DEBUGGER_WORKING_DIRECTORY` target property.
+
+* The :ref:`Visual Studio Generators` for VS 2010 and above now support
+ adding the PACKAGE target to the targets which are built by default.
+ The behavior is similar to :variable:`CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD`
+ and can be toggled using :variable:`CMAKE_VS_INCLUDE_PACKAGE_TO_DEFAULT_BUILD`.
+
+* The :ref:`Visual Studio Generators` for VS 2010 and above can
+ now handle .NET references with hintpaths. For this the new
+ target property group :prop_tgt:`VS_DOTNET_REFERENCE_<refname>`
+ was introduced. The ``<refname>`` part of the property name will
+ be the name of the reference, the value will be the actual
+ path to the assembly.
+
+* Copying of referenced assemblies to the output directory can
+ now be disabled using the target property
+ :prop_tgt:`VS_DOTNET_REFERENCES_COPY_LOCAL`.
+
+* The :ref:`Visual Studio Generators` for VS 2010 and above now place
+ per-source file flags after target-wide flags when they are classified
+ as raw flags with no project file setting (``AdditionalOptions``).
+ This behavior is more consistent with the ordering of flags produced
+ by other generators, and allows flags on more-specific properties
+ (per-source) to override those on more general ones (per-target).
+
+* The :ref:`Visual Studio Generators` for VS 2013 and above learned to
+ support a ``host=x64`` option in the :variable:`CMAKE_GENERATOR_TOOLSET`
+ value (e.g. via the :manual:`cmake(1)` ``-T`` option) to request use
+ of a VS 64-bit toolchain on 64-bit hosts.
+
+* :ref:`Visual Studio Generators` learned to treat files passed to
+ :command:`target_link_libraries` whose names end in ``.targets``
+ as MSBuild targets files to be imported into generated project files.
+
+* The :module:`WriteCompilerDetectionHeader` module gained the
+ ``ALLOW_UNKNOWN_COMPILERS`` and ``ALLOW_UNKNOWN_COMPILER_VERSIONS`` options
+ that allow creation of headers that will work also with unknown or old
+ compilers by simply assuming they do not support any of the requested
+ features.
+
+* The precompiled Windows binary MSI package provided on ``cmake.org`` now
+ records the installation directory in the Windows Registry under the key
+ ``HKLM\Software\Kitware\CMake`` with a value named ``InstallDir``.
+
+* The Xcode generator can now control emission of the
+ ``EFFECTIVE_PLATFORM_NAME`` variable through the
+ :prop_gbl:`XCODE_EMIT_EFFECTIVE_PLATFORM_NAME` global property.
+ This is useful when building with multiple SDKs like macosx and
+ iphoneos in parallel.
+
+* New :prop_tgt:`XCODE_PRODUCT_TYPE` and :prop_tgt:`XCODE_EXPLICIT_FILE_TYPE`
+ target properties were created to tell the :generator:`Xcode` generator
+ to use custom values of the corresponding attributes for a target in the
+ generated Xcode project.
diff --git a/Help/release/dev/CUDA-language-support.rst b/Help/release/dev/CUDA-language-support.rst
deleted file mode 100644
index 7df45bf..0000000
--- a/Help/release/dev/CUDA-language-support.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-CUDA-language-support
----------------------
-
-* CMake learned to support CUDA as a first-class language.
- It is supported by the :ref:`Makefile Generators` and the
- :generator:`Ninja` generator.
diff --git a/Help/release/dev/ExternalData-multiple-hashes.rst b/Help/release/dev/ExternalData-multiple-hashes.rst
deleted file mode 100644
index 608a277..0000000
--- a/Help/release/dev/ExternalData-multiple-hashes.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-ExternalData-multiple-hashes
-----------------------------
-
-* The :module:`ExternalData` module learned to support multiple
- content links for one data file using different hashes, e.g.
- ``img.png.sha256`` and ``img.png.sha1``. This allows objects
- to be fetched from sources indexed by different hash algorithms.
diff --git a/Help/release/dev/ExternalProject-GIT_CONFIG.rst b/Help/release/dev/ExternalProject-GIT_CONFIG.rst
deleted file mode 100644
index 2ab15e5..0000000
--- a/Help/release/dev/ExternalProject-GIT_CONFIG.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-ExternalProject-GIT_CONFIG
---------------------------
-
-* The :module:`ExternalProject` module gained a ``GIT_CONFIG`` option
- to pass ``--config`` options to Git when cloning repositories.
diff --git a/Help/release/dev/FeatureSummary_enhancement.rst b/Help/release/dev/FeatureSummary_enhancement.rst
deleted file mode 100644
index 3a5d85f..0000000
--- a/Help/release/dev/FeatureSummary_enhancement.rst
+++ /dev/null
@@ -1,22 +0,0 @@
-FeatureSummary_enhancement
---------------------------
-
-* The :command:`set_package_info`, :command:`set_feature_info`,
- :command:`print_enabled_features` and :command:`print_disabled_features`
- commands from the the :module:`FeatureSummary` module are now deprecated.
-
-* The :command:`set_package_properties` command no longer forces the package
- type to ``OPTIONAL`` when the type is not explicitly set.
-
-* The :command:`feature_summary` command in the :module:`FeatureSummary` module
- accepts the new ``QUIET_ON_EMPTY`` option that will suppresses the output when
- the list of packages that belong to the selected category is empty.
-
-* The :command:`add_feature_info` in the :module:`FeatureSummary` module learned
- to accept lists of dependencies for deciding whether a feature is enabled or
- not.
-
-* The package types accepted by the the :module:`FeatureSummary` module can now
- be tweaked by changing the :variable:`FeatureSummary_PKG_TYPES`,
- :variable:`FeatureSummary_REQUIRED_PKG_TYPES` and
- :variable:`FeatureSummary_DEFAULT_PKG_TYPE` global properties.
diff --git a/Help/release/dev/FindOpenGL-imported-targets.rst b/Help/release/dev/FindOpenGL-imported-targets.rst
deleted file mode 100644
index 79e3cb0..0000000
--- a/Help/release/dev/FindOpenGL-imported-targets.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-FindOpenGL-imported-targets
----------------------------
-
-* The :module:`FindOpenGL` module now provides imported targets
- ``OpenGL::GL`` and ``OpenGL::GLU`` when the libraries are found.
diff --git a/Help/release/dev/QtAutogen_Contain.rst b/Help/release/dev/QtAutogen_Contain.rst
deleted file mode 100644
index 182233b..0000000
--- a/Help/release/dev/QtAutogen_Contain.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-QtAutogen_Contain
------------------
-
-* When using AUTOMOC or AUTOUIC, generated
- ``moc_*``, ``*.moc`` and ``ui_*`` are placed in the
- ``<CMAKE_CURRENT_BINARY_DIR>/<TARGETNAME>_autogen/include`` directory which
- is automatically added to the target's :prop_tgt:`INCLUDE_DIRECTORIES`.
- It is therefore not necessary anymore to have
- :variable:`CMAKE_CURRENT_BINARY_DIR` in the target's
- :prop_tgt:`INCLUDE_DIRECTORIES`.
diff --git a/Help/release/dev/QtAutogen_Skip.rst b/Help/release/dev/QtAutogen_Skip.rst
deleted file mode 100644
index 37f795c..0000000
--- a/Help/release/dev/QtAutogen_Skip.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-QtAutogen_Skip
---------------
-
-* The source file properties
- :prop_sf:`SKIP_AUTOMOC`,
- :prop_sf:`SKIP_AUTOUIC`,
- :prop_sf:`SKIP_AUTORCC` and
- :prop_sf:`SKIP_AUTOGEN`
- allow to exclude files from
- :prop_tgt:`AUTOMOC`,
- :prop_tgt:`AUTOUIC` and
- :prop_tgt:`AUTORCC` processing.
diff --git a/Help/release/dev/SOURCE_DATE_EPOCH.rst b/Help/release/dev/SOURCE_DATE_EPOCH.rst
deleted file mode 100644
index 576e1da..0000000
--- a/Help/release/dev/SOURCE_DATE_EPOCH.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-SOURCE_DATE_EPOCH
------------------
-
-* The :command:`string(TIMESTAMP)` will now honor the ``SOURCE_DATE_EPOCH``
- environment variable and use its value instead of the current time.
diff --git a/Help/release/dev/SublimeText-no-VERBOSE.rst b/Help/release/dev/SublimeText-no-VERBOSE.rst
deleted file mode 100644
index 70dfa2b..0000000
--- a/Help/release/dev/SublimeText-no-VERBOSE.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-SublimeText-no-VERBOSE
-----------------------
-
-* The :generator:`Sublime Text 2` generator no longer runs the native
- build command (e.g. ``ninja`` or ``make``) with verbose build output
- enabled.
diff --git a/Help/release/dev/UseSWIG-SWIG_OUTFILE_DIR.rst b/Help/release/dev/UseSWIG-SWIG_OUTFILE_DIR.rst
deleted file mode 100644
index c001a88..0000000
--- a/Help/release/dev/UseSWIG-SWIG_OUTFILE_DIR.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-UseSWIG-SWIG_OUTFILE_DIR
-------------------------
-
-* The :module:`UseSWIG` module ``swig_add_source_to_module`` command
- learned a new ``SWIG_OUTFILE_DIR`` option to control the output
- file location (``swig -o``).
diff --git a/Help/release/dev/WCDH_allow_unsupported.rst b/Help/release/dev/WCDH_allow_unsupported.rst
deleted file mode 100644
index c0b7377..0000000
--- a/Help/release/dev/WCDH_allow_unsupported.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-WCDH_allow_unsupported
-----------------------
-
-* The :module:`WriteCompilerDetectionHeader` module gained the
- ``ALLOW_UNKNOWN_COMPILERS`` and ``ALLOW_UNKNOWN_COMPILER_VERSIONS`` options
- that allow creation of headers that will work also with unknown or old
- compilers by simply assuming they do not support any of the requested
- features.
diff --git a/Help/release/dev/add-BUILD_RPATH.rst b/Help/release/dev/add-BUILD_RPATH.rst
deleted file mode 100644
index 0d69e45..0000000
--- a/Help/release/dev/add-BUILD_RPATH.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-add-BUILD_RPATH
----------------
-
-* A :variable:`CMAKE_BUILD_RPATH` variable and corresponding
- :prop_tgt:`BUILD_RPATH` target property were added to support custom
- ``RPATH`` locations to be added to binaries in the build tree.
diff --git a/Help/release/dev/add-LANG_CPPLINT.rst b/Help/release/dev/add-LANG_CPPLINT.rst
deleted file mode 100644
index a0539cf..0000000
--- a/Help/release/dev/add-LANG_CPPLINT.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-add-LANG_CPPLINT
-----------------
-
-* A :prop_tgt:`<LANG>_CPPLINT` target property and supporting
- :variable:`CMAKE_<LANG>_CPPLINT` variable were introduced to tell
- the :ref:`Makefile Generators` and the :generator:`Ninja` generator to
- run the ``cpplint`` style checker along with the compiler for ``C`` and
- ``CXX`` languages.
diff --git a/Help/release/dev/add-SHA-3.rst b/Help/release/dev/add-SHA-3.rst
deleted file mode 100644
index 5743f10..0000000
--- a/Help/release/dev/add-SHA-3.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-add-SHA-3
----------
-
-* CMake functionality using cryptographic hashes now supports SHA-3 algorithms.
diff --git a/Help/release/dev/allow-fallback-config-mapping.rst b/Help/release/dev/allow-fallback-config-mapping.rst
deleted file mode 100644
index 2522e10..0000000
--- a/Help/release/dev/allow-fallback-config-mapping.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-allow-fallback-config-mapping
------------------------------
-
-* The :prop_tgt:`MAP_IMPORTED_CONFIG_<CONFIG>` target property learned
- to interpret empty list elements as referring to the configuration-less
- imported location specified by :prop_tgt:`IMPORTED_LOCATION`.
diff --git a/Help/release/dev/capture-clang-tidy-errors.rst b/Help/release/dev/capture-clang-tidy-errors.rst
deleted file mode 100644
index 14c32e6..0000000
--- a/Help/release/dev/capture-clang-tidy-errors.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-capture-clang-tidy-errors
--------------------------
-
-* If a command specified by the :prop_tgt:`<LANG>_CLANG_TIDY` target property
- returns non-zero at build time this is now treated as an error instead of
- silently ignored.
diff --git a/Help/release/dev/cdash_upload_retry.rst b/Help/release/dev/cdash_upload_retry.rst
deleted file mode 100644
index 2ceb42b..0000000
--- a/Help/release/dev/cdash_upload_retry.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-cdash-upload-retry
------------------------
-
-* The ``CDASH_UPLOAD`` signature of :command:`ctest_submit` was taught to honor
- the ``RETRY_COUNT``, ``RETRY_DELAY``, and ``QUIET`` options.
diff --git a/Help/release/dev/codeblocks-nmake-makefiles-jom.rst b/Help/release/dev/codeblocks-nmake-makefiles-jom.rst
deleted file mode 100644
index f5612f0..0000000
--- a/Help/release/dev/codeblocks-nmake-makefiles-jom.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-codeblocks-nmake-makefiles-jom
-------------------------------
-
-* The :generator:`CodeBlocks` now can generate with
- :generator:`NMake Makefiles JOM`.
diff --git a/Help/release/dev/codelite-build-and-clean-targets-enhancement.rst b/Help/release/dev/codelite-build-and-clean-targets-enhancement.rst
deleted file mode 100644
index c6b78cf..0000000
--- a/Help/release/dev/codelite-build-and-clean-targets-enhancement.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-codelite-build-and-clean-targets-enhancement
---------------------------------------------
-
-* The :generator:`CodeLite` extra generator gained a new option
- set by the :variable:`CMAKE_CODELITE_USE_TARGETS` variable to
- change the generated project to have target-centric organization.
- The "build", "rebuild", and "clean" operations within CodeLite
- then work on a selected target rather than the whole workspace.
- (Note that the :generator:`Ninja` clean operation on a target
- includes its dependencies, though.)
diff --git a/Help/release/dev/compile-features-for-language-standards.rst b/Help/release/dev/compile-features-for-language-standards.rst
deleted file mode 100644
index 20473b7..0000000
--- a/Help/release/dev/compile-features-for-language-standards.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-compile-features-for-language-standards
----------------------------------------
-
-* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
- now offers meta-features that request compiler modes for specific language
- standard levels. See :prop_gbl:`CMAKE_C_KNOWN_FEATURES` and
- :prop_gbl:`CMAKE_CXX_KNOWN_FEATURES`.
diff --git a/Help/release/dev/cpack-ifw-configure-file.rst b/Help/release/dev/cpack-ifw-configure-file.rst
deleted file mode 100644
index c9a1220..0000000
--- a/Help/release/dev/cpack-ifw-configure-file.rst
+++ /dev/null
@@ -1,9 +0,0 @@
-cpack-ifw-configure-file
-------------------------
-
-* The :command:`cpack_ifw_configure_file` command was added
- (in :module:`CPackIFWConfigureFile`) to configure file templates prepared
- in QtIFW/SDK/Creator style.
-
-* The :module:`CPackIFWConfigureFile` module was added to define
- :command:`cpack_ifw_configure_file` command.
diff --git a/Help/release/dev/cpack-ifw-options.rst b/Help/release/dev/cpack-ifw-options.rst
deleted file mode 100644
index 9838fd4..0000000
--- a/Help/release/dev/cpack-ifw-options.rst
+++ /dev/null
@@ -1,21 +0,0 @@
-cpack-ifw-options
------------------
-
-* The :module:`CPackIFW` module :command:`cpack_ifw_configure_component` and
- :command:`cpack_ifw_configure_component_group` commands gained a new
- ``DEFAULT``, ``VIRTUAL``, ``FORCED_INSTALLATION``, ``REQUIRES_ADMIN_RIGHTS``,
- ``DISPLAY_NAME``, ``UPDATE_TEXT``, ``DESCRIPTION``, ``RELEASE_DATE``,
- ``AUTO_DEPEND_ON`` and ``TRANSLATIONS`` options to more specific
- configuration.
-
-* The :module:`CPackIFW` module :command:`cpack_ifw_configure_component`
- command gained a new ``DEPENDENCIES`` alias for ``DEPENDS`` option.
-
-* The :module:`CPackIFW` module :command:`cpack_ifw_configure_component_group`
- command gained a new ``DEPENDS`` option. The ``DEPENDENCIES`` alias also
- added.
-
-* The :module:`CPackIFW` module :command:`cpack_ifw_configure_component` and
- :command:`cpack_ifw_configure_component_group` commands ``PRIORITY``
- option now is deprecated and will be removed in a future version of CMake.
- Please use new ``SORTING_PRIORITY`` option instead.
diff --git a/Help/release/dev/cpack-ifw-package-options.rst b/Help/release/dev/cpack-ifw-package-options.rst
deleted file mode 100644
index 1fec324..0000000
--- a/Help/release/dev/cpack-ifw-package-options.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-cpack-ifw-package-options
--------------------------
-
-* The :module:`CPackIFW` module gained new :variable:`CPACK_IFW_PACKAGE_WATERMARK`, :variable:`CPACK_IFW_PACKAGE_BANNER`,
- :variable:`CPACK_IFW_PACKAGE_BACKGROUND`, :variable:`CPACK_IFW_PACKAGE_WIZARD_STYLE`, :variable:`CPACK_IFW_PACKAGE_WIZARD_DEFAULT_WIDTH`,
- :variable:`CPACK_IFW_PACKAGE_WIZARD_DEFAULT_HEIGHT` and :variable:`CPACK_IFW_PACKAGE_TITLE_COLOR`
- variables to customize a QtIFW installer look.
diff --git a/Help/release/dev/cpack-productbuild-signing.rst b/Help/release/dev/cpack-productbuild-signing.rst
deleted file mode 100644
index 0b91b38..0000000
--- a/Help/release/dev/cpack-productbuild-signing.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-cpack-productbuild-signing
---------------------------
-
-* The :module:`CPackProductBuild` module gained options to sign packages.
- See the variables :variable:`CPACK_PRODUCTBUILD_IDENTITY_NAME`,
- :variable:`CPACK_PRODUCTBUILD_KEYCHAIN_PATH`,
- :variable:`CPACK_PKGBUILD_IDENTITY_NAME`, and
- :variable:`CPACK_PKGBUILD_KEYCHAIN_PATH`.
diff --git a/Help/release/dev/cpack-rpm-omit-unsupported-tags.rst b/Help/release/dev/cpack-rpm-omit-unsupported-tags.rst
deleted file mode 100644
index abcb7a6..0000000
--- a/Help/release/dev/cpack-rpm-omit-unsupported-tags.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-cpack-rpm-omit-unsupported-tags
--------------------------------
-
-* The :module:`CPackRPM` module learned to omit
- tags that are not supported by provided
- rpmbuild tool. If unsupported tags are set
- they are ignored and a developer warning is
- printed out.
diff --git a/Help/release/dev/cpack-rpm-single-debuginfo.rst b/Help/release/dev/cpack-rpm-single-debuginfo.rst
deleted file mode 100644
index 34a710d..0000000
--- a/Help/release/dev/cpack-rpm-single-debuginfo.rst
+++ /dev/null
@@ -1,11 +0,0 @@
-cpack-rpm-single-debuginfo
---------------------------
-
-* The :module:`CPackRPM` module learned to generate main component package
- which forces generation of a rpm for defined component without component
- suffix in filename and package name.
- See :variable:`CPACK_RPM_MAIN_COMPONENT` variable.
-
-* The :module:`CPackRPM` module learned to generate a single debuginfo package
- on demand even if components packagin is used.
- See :variable:`CPACK_RPM_DEBUGINFO_SINGLE_PACKAGE` variable.
diff --git a/Help/release/dev/cpack-rpm-user-file-list-with-multiple-directives.rst b/Help/release/dev/cpack-rpm-user-file-list-with-multiple-directives.rst
deleted file mode 100644
index ad0154d..0000000
--- a/Help/release/dev/cpack-rpm-user-file-list-with-multiple-directives.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-cpack-rpm-user-file-list-with-multiple-directives
--------------------------------------------------
-
-* The :module:`CPackRPM` module learned to support
- multiple directives per file when using
- :variable:`CPACK_RPM_USER_FILELIST` variable.
diff --git a/Help/release/dev/ctest_memcheck-leak_sanitizer.rst b/Help/release/dev/ctest_memcheck-leak_sanitizer.rst
deleted file mode 100644
index 3fa5c49..0000000
--- a/Help/release/dev/ctest_memcheck-leak_sanitizer.rst
+++ /dev/null
@@ -1,19 +0,0 @@
-ctest_memcheck-leak_sanitizer
-=============================
-
-* The :command:`ctest_memcheck` command learned to support ``LeakSanitizer``
- independently from ``AddressSanitizer``.
-
-* The :command:`ctest_memcheck` command no longer automatically adds
- ``leak_check=1`` to the options used by ``AddressSanitizer``. The default
- behavior of ``AddressSanitizer`` is to run `LeakSanitizer` to check leaks
- unless ``leak_check=0``.
-
-* The :command:`ctest_memcheck` command learned to read the location of
- suppressions files for sanitizers from the
- :variable:`CTEST_MEMORYCHECK_SUPPRESSIONS_FILE` variable.
-
-* The :command:`ctest_memcheck` command was fixed to correctly append extra
- sanitizer options read from the
- :variable:`CTEST_MEMORYCHECK_SANITIZER_OPTIONS` variable to the environment
- variables used internally by the sanitizers.
diff --git a/Help/release/dev/ctest_memcheck_defect_count.rst b/Help/release/dev/ctest_memcheck_defect_count.rst
deleted file mode 100644
index 70061c1..0000000
--- a/Help/release/dev/ctest_memcheck_defect_count.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-ctest_memcheck_defect_count
----------------------------
-
-* The :command:`ctest_memcheck` command gained a ``DEFECT_COUNT <var>``
- option to capture the number of memory defects detected.
diff --git a/Help/release/dev/execute_process-encoding.rst b/Help/release/dev/execute_process-encoding.rst
deleted file mode 100644
index 1c7cd8c..0000000
--- a/Help/release/dev/execute_process-encoding.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-execute_process-encoding
-------------------------
-
-* The :command:`execute_process` command gained an ``ENCODING`` option to
- specify on Windows which encoding is used for output from child process.
diff --git a/Help/release/dev/expand_custom_commands.rst b/Help/release/dev/expand_custom_commands.rst
deleted file mode 100644
index c8cd897..0000000
--- a/Help/release/dev/expand_custom_commands.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-expand_custom_commands
-----------------------
-
-* The commands :command:`add_custom_command` and :command:`add_custom_target`
- learned the option ``COMMAND_EXPAND_LISTS`` which causes lists in the
- ``COMMAND`` argument to be expanded, including lists created by generator
- expressions.
diff --git a/Help/release/dev/external-project-clone-progress.rst b/Help/release/dev/external-project-clone-progress.rst
deleted file mode 100644
index 766a1a3..0000000
--- a/Help/release/dev/external-project-clone-progress.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-external-project-clone-progress
--------------------------------
-
-* The :module:`ExternalProject` module gained the ``GIT_PROGRESS`` option to
- force Git to show progress when cloning repositories.
diff --git a/Help/release/dev/features-c++17.rst b/Help/release/dev/features-c++17.rst
deleted file mode 100644
index 9c28ddf..0000000
--- a/Help/release/dev/features-c++17.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-features-c++17
---------------
-
-* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
- is now aware of C++ 17. No specific features are yet enumerated besides
- the ``cxx_std_17`` meta-feature.
diff --git a/Help/release/dev/fuchsia-platform.rst b/Help/release/dev/fuchsia-platform.rst
deleted file mode 100644
index 9d5f3e8..0000000
--- a/Help/release/dev/fuchsia-platform.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-fuchsia-platform
-----------------
-
-* A new minimal platform file for Fuchsia was added.
diff --git a/Help/release/dev/gcc-features.rst b/Help/release/dev/gcc-features.rst
deleted file mode 100644
index c6959ab..0000000
--- a/Help/release/dev/gcc-features.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-gcc-features
-------------
-
-* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
- is now aware of the availability of C99 in gcc since version 3.4.
diff --git a/Help/release/dev/if-genex.rst b/Help/release/dev/if-genex.rst
deleted file mode 100644
index 62be3a7..0000000
--- a/Help/release/dev/if-genex.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-genex-if
---------
-
-* A new logical generator expression for immediate-if was added:
- ``$<IF:cond,true-value,false-value>``. It takes three arguments: One
- condition, a true-value, and a false-value. Resolves to the true-value if the
- condition is ``1``, and resolves to the false-value if the condition is ``0``.
diff --git a/Help/release/dev/imported-interface-libname.rst b/Help/release/dev/imported-interface-libname.rst
deleted file mode 100644
index fdbae78..0000000
--- a/Help/release/dev/imported-interface-libname.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-imported-interface-libname
---------------------------
-
-* :ref:`Imported <Imported Targets>` :ref:`Interface Libraries` learned new
- :prop_tgt:`IMPORTED_LIBNAME` and :prop_tgt:`IMPORTED_LIBNAME_<CONFIG>`
- target properties to specify a link library name since interface libraries
- do not build their own library files.
diff --git a/Help/release/dev/imported-interface-no-system.rst b/Help/release/dev/imported-interface-no-system.rst
deleted file mode 100644
index 3a727cc..0000000
--- a/Help/release/dev/imported-interface-no-system.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-imported-interface-no-system
-----------------------------
-
-* The :prop_tgt:`NO_SYSTEM_FROM_IMPORTED` target property is now supported
- on :ref:`Imported <Imported Targets>` :ref:`Interface Libraries`.
diff --git a/Help/release/dev/intel-compile-features-windows.rst b/Help/release/dev/intel-compile-features-windows.rst
deleted file mode 100644
index 6a2cdfe..0000000
--- a/Help/release/dev/intel-compile-features-windows.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-intel-compile-features-windows
-------------------------------
-
-* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
- is now aware of features supported by Intel C++ compilers versions 12.1
- through 17.0 on UNIX and Windows platforms.
diff --git a/Help/release/dev/manually-added-dependencies.rst b/Help/release/dev/manually-added-dependencies.rst
deleted file mode 100644
index 6c486da..0000000
--- a/Help/release/dev/manually-added-dependencies.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-manually-added-dependencies
----------------------------
-
-* The target property :prop_tgt:`MANUALLY_ADDED_DEPENDENCIES` has
- been added. It is read-only and could be used to retrieve
- dependencies that have been added with :command:`add_dependencies`.
diff --git a/Help/release/dev/math-EXPR-unary.rst b/Help/release/dev/math-EXPR-unary.rst
deleted file mode 100644
index d4af15b..0000000
--- a/Help/release/dev/math-EXPR-unary.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-math-EXPR-unary
----------------
-
-* The :command:`math(EXPR)` command gained support for unary
- ``+`` and ``-`` expressions.
diff --git a/Help/release/dev/pkg-config-recheck.rst b/Help/release/dev/pkg-config-recheck.rst
deleted file mode 100644
index 950c3c8..0000000
--- a/Help/release/dev/pkg-config-recheck.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-pkg-config-recheck
-------------------
-
-* Calls to the :module:`FindPkgConfig` module :command:`pkg_check_modules`
- command following a successful call learned to re-evaluate the cached values
- for a given prefix after changes to the parameters to the command for that
- prefix.
diff --git a/Help/release/dev/source_group-tree.rst b/Help/release/dev/source_group-tree.rst
deleted file mode 100644
index c5fec1d..0000000
--- a/Help/release/dev/source_group-tree.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-source_group-tree
------------------
-
-* The :command:`source_group` command gained ``TREE`` and ``PREFIX``
- options to add groups following source tree directory structure.
diff --git a/Help/release/dev/src-COMPILE_FLAGS-genex.rst b/Help/release/dev/src-COMPILE_FLAGS-genex.rst
deleted file mode 100644
index 26cd3ef..0000000
--- a/Help/release/dev/src-COMPILE_FLAGS-genex.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-src-COMPILE_FLAGS-genex
------------------------
-
-* The :prop_sf:`COMPILE_FLAGS` source file property learned to support
- :manual:`generator expressions <cmake-generator-expressions(7)>`.
diff --git a/Help/release/dev/st2-env-settings.rst b/Help/release/dev/st2-env-settings.rst
deleted file mode 100644
index 7b36347..0000000
--- a/Help/release/dev/st2-env-settings.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-st2-env-settings
-----------------
-
-* The :generator:`Sublime Text 2` extra generator learned to place
- environment variables in the generated ``.sublime-project``.
- See the :variable:`CMAKE_SUBLIME_TEXT_2_ENV_SETTINGS` variable.
diff --git a/Help/release/dev/st2-exclude-patterns-variable.rst b/Help/release/dev/st2-exclude-patterns-variable.rst
deleted file mode 100644
index 8706c1f..0000000
--- a/Help/release/dev/st2-exclude-patterns-variable.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-st2-exclude-patterns-variable
------------------------------
-
-* The :generator:`Sublime Text 2` extra generator no longer excludes the
- build tree from the ``.sublime-project`` when it is inside the source tree.
- The :variable:`CMAKE_SUBLIME_TEXT_2_EXCLUDE_BUILD_TREE` variable
- was added to control the behavior explicitly.
diff --git a/Help/release/dev/static-frameworks.rst b/Help/release/dev/static-frameworks.rst
deleted file mode 100644
index eae80bd..0000000
--- a/Help/release/dev/static-frameworks.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-static-frameworks
------------------
-
-* The :prop_tgt:`FRAMEWORK` property could now also be applied to
- static libraries on Apple targets. It will result in a proper
- Framework but with a static library inside.
diff --git a/Help/release/dev/swig_add_library.rst b/Help/release/dev/swig_add_library.rst
deleted file mode 100644
index 4b7723b..0000000
--- a/Help/release/dev/swig_add_library.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-swig_add_library
-----------------
-
-* The :module:`UseSWIG` module gained a ``swig_add_library`` command
- to give more flexibility over the old ``swig_add_module`` command.
-
-* The :module:`UseSWIG` module ``swig_add_module`` command is now
- deprecated in favor of ``swig_add_library``.
diff --git a/Help/release/dev/timestamp-percent.rst b/Help/release/dev/timestamp-percent.rst
deleted file mode 100644
index 046d6c5..0000000
--- a/Help/release/dev/timestamp-percent.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-timestamp-percent
------------------
-
-* The :command:`string(TIMESTAMP)` command learned to treat ``%%``
- as a way to encode plain ``%``.
diff --git a/Help/release/dev/try_compile-honor-CMAKE_WARN_DEPRECATED.rst b/Help/release/dev/try_compile-honor-CMAKE_WARN_DEPRECATED.rst
deleted file mode 100644
index 9e13575..0000000
--- a/Help/release/dev/try_compile-honor-CMAKE_WARN_DEPRECATED.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-try_compile-honor-CMAKE_WARN_DEPRECATED
----------------------------------------
-
-* The :command:`try_compile` command source file signature now
- honors the :variable:`CMAKE_WARN_DEPRECATED` variable value
- in the generated test project.
diff --git a/Help/release/dev/try_compile-lang-std.rst b/Help/release/dev/try_compile-lang-std.rst
deleted file mode 100644
index 849cecc..0000000
--- a/Help/release/dev/try_compile-lang-std.rst
+++ /dev/null
@@ -1,9 +0,0 @@
-try_compile-lang-std
---------------------
-
-* The :command:`try_compile` command source file signature gained new options
- to specify the language standard to use in the generated test project.
-
-* The :command:`try_compile` command source file signature now honors
- language standard variables like :variable:`CMAKE_CXX_STANDARD`.
- See policy :policy:`CMP0067`.
diff --git a/Help/release/dev/vs-advanced-source-properties.rst b/Help/release/dev/vs-advanced-source-properties.rst
deleted file mode 100644
index dd391e0..0000000
--- a/Help/release/dev/vs-advanced-source-properties.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-vs-advanced-source-properties
------------------------------
-
-* The :ref:`Visual Studio Generators` for VS 2010 and above
- learned some more source file properties:
-
- - :prop_sf:`VS_RESOURCE_GENERATOR` (C# only): allows setting the resource
- generator
- - :prop_sf:`VS_COPY_TO_OUT_DIR`: parameter to set if file should be copied
- to output directory (values: ``Never``, ``Always``, ``PreserveNewest``)
- - :prop_sf:`VS_INCLUDE_IN_VSIX`: boolean property to include file include
- Visual Studio extension package
diff --git a/Help/release/dev/vs-csharp-support.rst b/Help/release/dev/vs-csharp-support.rst
deleted file mode 100644
index 46b235a..0000000
--- a/Help/release/dev/vs-csharp-support.rst
+++ /dev/null
@@ -1,34 +0,0 @@
-vs-native-csharp-support
-------------------------
-
-* The :ref:`Visual Studio Generators` for VS 2010 and above
- learned to support the C# language. C# assemblies and
- programs can be added just like common C++ targets using
- the :command:`add_library` and :command:`add_executable`
- commands. Referencing between several C# targets in the same
- source tree is done by :command:`target_link_libraries` like
- for C++. Referencing to system or 3rd party assemblies is
- done by the target properties :prop_tgt:`VS_DOTNET_REFERENCE_<refname>`
- and :prop_tgt:`VS_DOTNET_REFERENCES`.
-
-* C# as a language can be enabled using :command:`enable_language`
- or :command:`project` with ``CSharp``. It is not enabled by
- default.
-
-* Flag variables, target properties and other configuration
- that specifically targets C# contains ``CSharp`` as a part of
- their names.
-
-* More finetuning of C# targets can be done using target and source
- file properties. Specifically the Visual Studio related target
- properties (``VS_*``) are worth a look (for setting toolset
- versions, root namespaces, assembly icons, ...).
-
-* **Auto-"linking"** in .csproj files: In C#/.NET development with
- Visual Studio there is a number of visual editors used which
- generate code. Both the generated files and the ones edited
- with the UI are connected in the ``.csproj`` file using
- ``<DependentUpon>`` tags. If CMake finds within a C# project
- any source file with extension ``.Designer.cs`` or ``.xaml.cs``,
- it checks sibling files with extension ``.xaml``, ``.settings``,
- ``.resx`` or ``.cs`` and establishes the dependency connection.
diff --git a/Help/release/dev/vs-custom-msbuild-props.rst b/Help/release/dev/vs-custom-msbuild-props.rst
deleted file mode 100644
index 68dae42..0000000
--- a/Help/release/dev/vs-custom-msbuild-props.rst
+++ /dev/null
@@ -1,9 +0,0 @@
-vs-custom-msbuild-props
------------------------
-
-* The :ref:`Visual Studio Generators` for VS 2010 and above can
- now be fine tuned using custom msbuild .props files.
- :prop_tgt:`VS_USER_PROPS` can be
- used to change the default path of the user .props file from
- ``$(UserRootDir)\\Microsoft.Cpp.$(Platform).user.props`` to
- an arbitrary filename.
diff --git a/Help/release/dev/vs-debugger-config.rst b/Help/release/dev/vs-debugger-config.rst
deleted file mode 100644
index 58873a5..0000000
--- a/Help/release/dev/vs-debugger-config.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-vs-debugger-configuration
--------------------------
-
-* For the :ref:`Visual Studio Generators` for VS 2010 and above
- the working directory for debugging can be set using a new
- :prop_tgt:`VS_DEBUGGER_WORKING_DIRECTORY` target property.
diff --git a/Help/release/dev/vs-default-build-package.rst b/Help/release/dev/vs-default-build-package.rst
deleted file mode 100644
index 62c66e0..0000000
--- a/Help/release/dev/vs-default-build-package.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-vs-default-build-package
-------------------------
-
-* The :ref:`Visual Studio Generators` for VS 2010 and above now support
- adding the PACKAGE target to the targets which are built by default.
- The behavior is similar to :variable:`CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD`
- and can be toggled using :variable:`CMAKE_VS_INCLUDE_PACKAGE_TO_DEFAULT_BUILD`.
diff --git a/Help/release/dev/vs-dotnet-references.rst b/Help/release/dev/vs-dotnet-references.rst
deleted file mode 100644
index 8998afb..0000000
--- a/Help/release/dev/vs-dotnet-references.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-vs-dotnet-references
---------------------
-
-* The :ref:`Visual Studio Generators` for VS 2010 and above can
- now handle .NET references with hintpaths. For this the new
- target property group :prop_tgt:`VS_DOTNET_REFERENCE_<refname>`
- was introduced. The ``<refname>`` part of the property name will
- be the name of the reference, the value will be the actual
- path to the assembly.
-
-* Copying of referenced assemblies to the output directory can
- now be disabled using the target property
- :prop_tgt:`VS_DOTNET_REFERENCES_COPY_LOCAL`.
diff --git a/Help/release/dev/vs-flag-order.rst b/Help/release/dev/vs-flag-order.rst
deleted file mode 100644
index 21cea37..0000000
--- a/Help/release/dev/vs-flag-order.rst
+++ /dev/null
@@ -1,9 +0,0 @@
-vs-flag-order
--------------
-
-* The :ref:`Visual Studio Generators` for VS 2010 and above now place
- per-source file flags after target-wide flags when they are classified
- as raw flags with no project file setting (``AdditionalOptions``).
- This behavior is more consistent with the ordering of flags produced
- by other generators, and allows flags on more-specific properties
- (per-source) to override those on more general ones (per-target).
diff --git a/Help/release/dev/vs-host-x64-tools.rst b/Help/release/dev/vs-host-x64-tools.rst
deleted file mode 100644
index e42881a..0000000
--- a/Help/release/dev/vs-host-x64-tools.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-vs-host-x64-tools
------------------
-
-* The :ref:`Visual Studio Generators` for VS 2013 and above learned to
- support a ``host=x64`` option in the :variable:`CMAKE_GENERATOR_TOOLSET`
- value (e.g. via the :manual:`cmake(1)` ``-T`` option) to request use
- of a VS 64-bit toolchain on 64-bit hosts.
diff --git a/Help/release/dev/vs_targets_file_as_library.rst b/Help/release/dev/vs_targets_file_as_library.rst
deleted file mode 100644
index 9c923fa..0000000
--- a/Help/release/dev/vs_targets_file_as_library.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-vs_targets_file_as_library
---------------------------
-
-* :ref:`Visual Studio Generators` learned to treat files passed to
- :command:`target_link_libraries` whose names end in ``.targets``
- as MSBuild targets files to be imported into generated project files.
diff --git a/Help/release/dev/wix-reg-install-dir.rst b/Help/release/dev/wix-reg-install-dir.rst
deleted file mode 100644
index 961fad2..0000000
--- a/Help/release/dev/wix-reg-install-dir.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-wix-reg-install-dir
--------------------
-
-* The precompiled Windows binary MSI package provided on ``cmake.org`` now
- records the installation directory in the Windows Registry under the key
- ``HKLM\Software\Kitware\CMake`` with a value named ``InstallDir``.
diff --git a/Help/release/dev/xcode-effective-platform-name.rst b/Help/release/dev/xcode-effective-platform-name.rst
deleted file mode 100644
index e337ca0..0000000
--- a/Help/release/dev/xcode-effective-platform-name.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-xcode-effective-platform-name
------------------------------
-
-* The Xcode generator can now control emission of the
- ``EFFECTIVE_PLATFORM_NAME`` variable through the
- :prop_gbl:`XCODE_EMIT_EFFECTIVE_PLATFORM_NAME` global property.
- This is useful when building with multiple SDKs like macosx and
- iphoneos in parallel.
diff --git a/Help/release/dev/xcode-message-extension.rst b/Help/release/dev/xcode-message-extension.rst
deleted file mode 100644
index 11c0702..0000000
--- a/Help/release/dev/xcode-message-extension.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-xcode-message-extension
------------------------
-
-* New :prop_tgt:`XCODE_PRODUCT_TYPE` and :prop_tgt:`XCODE_EXPLICIT_FILE_TYPE`
- target properties were created to tell the :generator:`Xcode` generator
- to use custom values of the corresponding attributes for a target in the
- generated Xcode project.
diff --git a/Help/release/index.rst b/Help/release/index.rst
index 30decd5..292c9a8 100644
--- a/Help/release/index.rst
+++ b/Help/release/index.rst
@@ -13,6 +13,7 @@ Releases
.. toctree::
:maxdepth: 1
+ 3.8 <3.8>
3.7 <3.7>
3.6 <3.6>
3.5 <3.5>