Merge topic 'doc-3.8-relnotes'

c2f7ef63 Help: Organize and revise 3.8 release notes
3f5e4f19 Help: Consolidate 3.8 release notes

Help/release/3.8.rst

@@ -0,0 +1,421 @@
+CMake 3.8 Release Notes
+***********************
+
+.. only:: html
+
+  .. contents::
+
+Changes made since CMake 3.7 include the following.
+
+New Features
+============
+
+Languages
+---------
+
+C#
+^^
+
+* CMake learned to support ``CSharp`` (C#) as a first-class language that
+  can be enabled via the :command:`project` and :command:`enable_language`
+  commands.  It is currently supported by the :ref:`Visual Studio Generators`
+  for VS 2010 and above.
+
+  C# assemblies and programs can be added just like common C++ targets using
+  the :command:`add_library` and :command:`add_executable` commands.
+  References between C# targets in the same source tree may be specified by
+  :command:`target_link_libraries` like for C++.  References to system or
+  3rd-party assemblies may be specified by the target properties
+  :prop_tgt:`VS_DOTNET_REFERENCE_<refname>` and
+  :prop_tgt:`VS_DOTNET_REFERENCES`.
+
+* More fine tuning of C# targets may be done using target and source
+  file properties.  Specifically the target properties related to
+  Visual Studio (``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 are 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.
+
+CUDA
+^^^^
+
+* CMake learned to support ``CUDA`` as a first-class language that can be
+  enabled via the :command:`project` and :command:`enable_language` commands.
+
+* ``CUDA`` is currently supported by the :ref:`Makefile Generators`
+  and the :generator:`Ninja` generator on Linux, macOS, and Windows.
+  Support for the Visual Studio IDE is under development but not
+  included in this release.
+
+* The NVIDIA CUDA Toolkit compiler (``nvcc``) is supported.
+
+C & C++
+^^^^^^^
+
+* The :manual:`Compile Features <cmake-compile-features(7)>` functionality
+  now offers meta-features that request compiler modes for specific language
+  standard levels (e.g. ``cxx_std_11``).  See
+  :prop_gbl:`CMAKE_C_KNOWN_FEATURES` and :prop_gbl:`CMAKE_CXX_KNOWN_FEATURES`.
+
+* 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 :manual:`Compile Features <cmake-compile-features(7)>` functionality
+  is now aware of the availability of C99 in gcc since version 3.4.
+
+Platforms
+---------
+
+* A new minimal platform file for ``Fuchsia`` was added.
+
+Generators
+----------
+
+* The :generator:`CodeBlocks` extra generator may now be used to
+  generate with :generator:`NMake Makefiles JOM`.
+
+* 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.
+
+* The :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.
+
+Commands
+--------
+
+* The :command:`add_custom_command` and :command:`add_custom_target` commands
+  learned the option ``COMMAND_EXPAND_LISTS`` which causes lists in the
+  ``COMMAND`` argument to be expanded, including lists created by generator
+  expressions.
+
+* The :command:`execute_process` command gained an ``ENCODING`` option to
+  specify on Windows which encoding is used for output from child process.
+
+* The :command:`math(EXPR)` command gained support for unary
+  ``+`` and ``-`` operators.
+
+* The :command:`source_group` command gained ``TREE`` and ``PREFIX``
+  options to add groups following source tree directory structure.
+
+* The :command:`string(TIMESTAMP)` command learned to treat ``%%``
+  as a way to encode plain ``%``.
+
+* The :command:`string(TIMESTAMP)` command will now honor the
+  ``SOURCE_DATE_EPOCH`` environment variable and use its value
+  instead of the current time.
+
+* 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`.
+
+Variables
+---------
+
+* A :variable:`CMAKE_CODELITE_USE_TARGETS` variable was added to tell the
+  :generator:`CodeLite` extra generator 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 :variable:`CMAKE_SUBLIME_TEXT_2_ENV_SETTINGS` variable was added to
+  tell the :generator:`Sublime Text 2` extra generator to place specified
+  environment variables in the generated ``.sublime-project``.
+
+* The :variable:`CMAKE_SUBLIME_TEXT_2_EXCLUDE_BUILD_TREE` variable was added
+  to tell the :generator:`Sublime Text 2` extra generator whether to exclude
+  the build tree from the ``.sublime-project`` when it is inside the source
+  tree.
+
+* A :variable:`CMAKE_VS_INCLUDE_PACKAGE_TO_DEFAULT_BUILD` variable was
+  added to tell :ref:`Visual Studio Generators` for VS 2010 and above
+  to include the ``PACKAGE`` target in the default build, similar to
+  the existing :variable:`CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD`
+  variable for the ``INSTALL`` target.
+
+Properties
+----------
+
+* A :prop_tgt:`BUILD_RPATH` target property and corresponding
+  :variable:`CMAKE_BUILD_RPATH` variable were added to support custom
+  ``RPATH`` locations to be added to binaries in the build tree.
+
+* The :prop_sf:`COMPILE_FLAGS` source file property learned to support
+  :manual:`generator expressions <cmake-generator-expressions(7)>`.
+
+* The :prop_tgt:`FRAMEWORK` target property may now also be applied to
+  static libraries on Apple targets.  It will result in a proper
+  Framework but with a static library inside.
+
+* :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.
+
+* 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.
+
+* A :prop_tgt:`MANUALLY_ADDED_DEPENDENCIES` target property has been added.
+  It provides a read-only list of dependencies that have been added with
+  the :command:`add_dependencies` command.
+
+* 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`.
+
+* The :prop_tgt:`NO_SYSTEM_FROM_IMPORTED` target property is now supported
+  on :ref:`Imported <Imported Targets>` :ref:`Interface Libraries`.
+
+* New source file properties :prop_sf:`SKIP_AUTOMOC`, :prop_sf:`SKIP_AUTOUIC`,
+  :prop_sf:`SKIP_AUTORCC`, and :prop_sf:`SKIP_AUTOGEN` were added to allow
+  source files to be excluded from processing by :prop_tgt:`AUTOMOC`,
+  :prop_tgt:`AUTOUIC`, and :prop_tgt:`AUTORCC` target properties.
+
+* A :prop_sf:`VS_COPY_TO_OUT_DIR` source file property was added to
+  tell :ref:`Visual Studio Generators` for VS 2010 and above whether
+  or not a file should e copied to the output directory.
+
+* A :prop_tgt:`VS_DEBUGGER_WORKING_DIRECTORY` target property was added
+  to tell :ref:`Visual Studio Generators` for VS 2010 and above what
+  debugger working directory should be set for the target.
+
+* A :prop_tgt:`VS_DOTNET_REFERENCES_COPY_LOCAL` target property was added
+  to specify whether to copy referenced assemblies to the output directory.
+
+* A :prop_tgt:`VS_DOTNET_REFERENCE_<refname>` target property was added
+  to tell :ref:`Visual Studio Generators` for VS 2010 and above to add
+  a .NET reference with a given hint path.
+
+* A :prop_sf:`VS_INCLUDE_IN_VSIX` source file property was added to
+  tell :ref:`Visual Studio Generators` for VS 2010 and above whether
+  to include the file in a Visual Studio extension package.
+
+* A :prop_sf:`VS_RESOURCE_GENERATOR` source file property was added to
+  give :ref:`Visual Studio Generators` for VS 2010 and above a setting
+  for the resource generator (``C#`` only).
+
+* A :prop_tgt:`VS_USER_PROPS` target property was added to tell
+  :ref:`Visual Studio Generators` for VS 2010 and above to use a
+  custom MSBuild user ``.props`` file.
+
+* A :prop_gbl:`XCODE_EMIT_EFFECTIVE_PLATFORM_NAME` global property was
+  added to tell the :generator:`Xcode` generator whether to emit the
+  ``EFFECTIVE_PLATFORM_NAME`` variable.  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.
+
+Modules
+-------
+
+* 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 :module:`FeatureSummary` module :command:`feature_summary` command now
+  accepts a new ``QUIET_ON_EMPTY`` option that suppresses the output when
+  the list of packages that belong to the selected category is empty.
+
+* The :module:`FeatureSummary` module :command:`add_feature_info` command
+  now accepts lists of dependencies for deciding whether a feature is enabled
+  or not.
+
+* The package types accepted by 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.
+
+* 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_source_to_module`` command
+  learned a new ``SWIG_OUTFILE_DIR`` option to control the output
+  file location (``swig -o``).
+
+* 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.
+
+CTest
+-----
+
+* 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 read the location of
+  suppressions files for sanitizers from the
+  :variable:`CTEST_MEMORYCHECK_SUPPRESSIONS_FILE` variable.
+
+* The :command:`ctest_memcheck` command learned to support ``LeakSanitizer``
+  independently from ``AddressSanitizer``.
+
+* The :command:`ctest_update` command ``CDASH_UPLOAD`` signature was taught
+  to honor the ``RETRY_COUNT``, ``RETRY_DELAY``, and ``QUIET`` options.
+
+CPack
+-----
+
+* The :module:`CPackIFWConfigureFile` module was added to define a new
+  :command:`cpack_ifw_configure_file` command to configure file templates
+  prepared in QtIFW/SDK/Creator style.
+
+* 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 packaging 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.
+
+Other
+-----
+
+* CMake functionality using cryptographic hashes now supports SHA-3 algorithms.
+
+* A new generator expression ``$<IF:cond,true-value,false-value>`` was added.
+  It resolves to the true-value if the condition is ``1`` and resolves to
+  the false-value if the condition is ``0``.
+
+Deprecated and Removed Features
+===============================
+
+* The :module:`FeatureSummary` module commands :command:`set_package_info`,
+  :command:`set_feature_info`, :command:`print_enabled_features`, and
+  :command:`print_disabled_features` are now deprecated.
+
+* The :module:`UseSWIG` module ``swig_add_module`` command is now
+  deprecated in favor of ``swig_add_library``.
+
+Other Changes
+=============
+
+* 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 :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 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.
+
+* The :module:`FeatureSummary` module :command:`set_package_properties`
+  command no longer forces the package type to ``OPTIONAL`` when the type
+  is not explicitly set.
+
+* 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.
+
+* 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 :prop_tgt:`AUTOMOC` or :prop_tgt:`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 :generator:`Sublime Text 2` generator no longer runs the native
+  build command (e.g. ``ninja`` or ``make``) with verbose build output
+  enabled.
+
+* The :command:`try_compile` command source file signature now
+  honors the :variable:`CMAKE_WARN_DEPRECATED` variable value
+  in the generated test project.
+
+* 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 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``.

Help/release/dev/CUDA-language-support.rst

@@ -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.

Help/release/dev/ExternalData-multiple-hashes.rst

@@ -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.

Help/release/dev/ExternalProject-GIT_CONFIG.rst

@@ -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.

Help/release/dev/FeatureSummary_enhancement.rst

@@ -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.

Help/release/dev/FindOpenGL-imported-targets.rst

@@ -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.

Help/release/dev/QtAutogen_Contain.rst

@@ -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`.

Help/release/dev/QtAutogen_Skip.rst

@@ -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.

Help/release/dev/SOURCE_DATE_EPOCH.rst

@@ -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.

Help/release/dev/SublimeText-no-VERBOSE.rst

@@ -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.

Help/release/dev/UseSWIG-SWIG_OUTFILE_DIR.rst

@@ -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``).

Help/release/dev/WCDH_allow_unsupported.rst

@@ -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.

Help/release/dev/add-BUILD_RPATH.rst

@@ -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.

Help/release/dev/add-LANG_CPPLINT.rst

@@ -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.

Help/release/dev/add-SHA-3.rst

@@ -1,4 +0,0 @@
-add-SHA-3
----------
-
-* CMake functionality using cryptographic hashes now supports SHA-3 algorithms.

Help/release/dev/allow-fallback-config-mapping.rst

@@ -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`.

Help/release/dev/capture-clang-tidy-errors.rst

@@ -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.

Help/release/dev/cdash_upload_retry.rst

@@ -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.

Help/release/dev/codeblocks-nmake-makefiles-jom.rst

@@ -1,5 +0,0 @@
-codeblocks-nmake-makefiles-jom
-------------------------------
-
-* The :generator:`CodeBlocks` now can generate with
-  :generator:`NMake Makefiles JOM`.

Help/release/dev/codelite-build-and-clean-targets-enhancement.rst

@@ -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.)

Help/release/dev/compile-features-for-language-standards.rst

@@ -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`.

Help/release/dev/cpack-ifw-configure-file.rst

@@ -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.

Help/release/dev/cpack-ifw-options.rst

@@ -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.

Help/release/dev/cpack-ifw-package-options.rst

@@ -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.

Help/release/dev/cpack-productbuild-signing.rst

@@ -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`.

Help/release/dev/cpack-rpm-omit-unsupported-tags.rst

@@ -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.

Help/release/dev/cpack-rpm-single-debuginfo.rst

@@ -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.

Help/release/dev/cpack-rpm-user-file-list-with-multiple-directives.rst

@@ -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.

Help/release/dev/ctest_memcheck-leak_sanitizer.rst

@@ -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.

Help/release/dev/ctest_memcheck_defect_count.rst

@@ -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.

Help/release/dev/execute_process-encoding.rst

@@ -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.

Help/release/dev/expand_custom_commands.rst

@@ -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.

Help/release/dev/external-project-clone-progress.rst

@@ -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.

Help/release/dev/features-c++17.rst

@@ -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.

Help/release/dev/fuchsia-platform.rst

@@ -1,4 +0,0 @@
-fuchsia-platform
-----------------
-
-* A new minimal platform file for Fuchsia was added.

Help/release/dev/gcc-features.rst

@@ -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.

Help/release/dev/if-genex.rst

@@ -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``.

Help/release/dev/imported-interface-libname.rst

@@ -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.

Help/release/dev/imported-interface-no-system.rst

@@ -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`.

Help/release/dev/intel-compile-features-windows.rst

@@ -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.

Help/release/dev/manually-added-dependencies.rst

@@ -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`.

Help/release/dev/math-EXPR-unary.rst

@@ -1,5 +0,0 @@
-math-EXPR-unary
----------------
-
-* The :command:`math(EXPR)` command gained support for unary
-  ``+`` and ``-`` expressions.

Help/release/dev/pkg-config-recheck.rst

@@ -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.

Help/release/dev/source_group-tree.rst

@@ -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.

Help/release/dev/src-COMPILE_FLAGS-genex.rst

@@ -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)>`.

Help/release/dev/st2-env-settings.rst

@@ -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.

Help/release/dev/st2-exclude-patterns-variable.rst

@@ -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.

Help/release/dev/static-frameworks.rst

@@ -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.

Help/release/dev/swig_add_library.rst

@@ -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``.

Help/release/dev/timestamp-percent.rst

@@ -1,5 +0,0 @@
-timestamp-percent
------------------
-
-* The :command:`string(TIMESTAMP)` command learned to treat ``%%``
-  as a way to encode plain ``%``.

Help/release/dev/try_compile-honor-CMAKE_WARN_DEPRECATED.rst

@@ -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.

Help/release/dev/try_compile-lang-std.rst

@@ -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`.

Help/release/dev/vs-advanced-source-properties.rst

@@ -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

Help/release/dev/vs-csharp-support.rst

@@ -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.

Help/release/dev/vs-custom-msbuild-props.rst

@@ -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.

Help/release/dev/vs-debugger-config.rst

@@ -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.

Help/release/dev/vs-default-build-package.rst

@@ -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`.

Help/release/dev/vs-dotnet-references.rst

@@ -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`.

Help/release/dev/vs-flag-order.rst

@@ -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).

Help/release/dev/vs-host-x64-tools.rst

@@ -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.

Help/release/dev/vs_targets_file_as_library.rst

@@ -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.

Help/release/dev/wix-reg-install-dir.rst

@@ -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``.

Help/release/dev/xcode-effective-platform-name.rst

@@ -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.

Help/release/dev/xcode-message-extension.rst

@@ -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.

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>