From 3f5e4f1957c33335d792f6edde62ca59d3b158fb Mon Sep 17 00:00:00 2001 From: Brad King Date: Wed, 1 Feb 2017 10:13:03 -0500 Subject: 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. --- Help/release/3.8.rst | 381 +++++++++++++++++++++ Help/release/dev/CUDA-language-support.rst | 6 - Help/release/dev/ExternalData-multiple-hashes.rst | 7 - Help/release/dev/ExternalProject-GIT_CONFIG.rst | 5 - Help/release/dev/FeatureSummary_enhancement.rst | 22 -- Help/release/dev/FindOpenGL-imported-targets.rst | 5 - Help/release/dev/QtAutogen_Contain.rst | 10 - Help/release/dev/QtAutogen_Skip.rst | 12 - Help/release/dev/SOURCE_DATE_EPOCH.rst | 5 - Help/release/dev/SublimeText-no-VERBOSE.rst | 6 - Help/release/dev/UseSWIG-SWIG_OUTFILE_DIR.rst | 6 - Help/release/dev/WCDH_allow_unsupported.rst | 8 - Help/release/dev/add-BUILD_RPATH.rst | 6 - Help/release/dev/add-LANG_CPPLINT.rst | 8 - Help/release/dev/add-SHA-3.rst | 4 - Help/release/dev/allow-fallback-config-mapping.rst | 6 - Help/release/dev/capture-clang-tidy-errors.rst | 6 - Help/release/dev/cdash_upload_retry.rst | 5 - .../release/dev/codeblocks-nmake-makefiles-jom.rst | 5 - ...odelite-build-and-clean-targets-enhancement.rst | 10 - .../compile-features-for-language-standards.rst | 7 - Help/release/dev/cpack-ifw-configure-file.rst | 9 - Help/release/dev/cpack-ifw-options.rst | 21 -- Help/release/dev/cpack-ifw-package-options.rst | 7 - Help/release/dev/cpack-productbuild-signing.rst | 8 - .../dev/cpack-rpm-omit-unsupported-tags.rst | 8 - Help/release/dev/cpack-rpm-single-debuginfo.rst | 11 - ...rpm-user-file-list-with-multiple-directives.rst | 6 - Help/release/dev/ctest_memcheck-leak_sanitizer.rst | 19 - Help/release/dev/ctest_memcheck_defect_count.rst | 5 - Help/release/dev/execute_process-encoding.rst | 5 - Help/release/dev/expand_custom_commands.rst | 7 - .../dev/external-project-clone-progress.rst | 5 - Help/release/dev/features-c++17.rst | 6 - Help/release/dev/fuchsia-platform.rst | 4 - Help/release/dev/gcc-features.rst | 5 - Help/release/dev/if-genex.rst | 7 - Help/release/dev/imported-interface-libname.rst | 7 - Help/release/dev/imported-interface-no-system.rst | 5 - .../release/dev/intel-compile-features-windows.rst | 6 - Help/release/dev/manually-added-dependencies.rst | 6 - Help/release/dev/math-EXPR-unary.rst | 5 - Help/release/dev/pkg-config-recheck.rst | 7 - Help/release/dev/source_group-tree.rst | 5 - Help/release/dev/src-COMPILE_FLAGS-genex.rst | 5 - Help/release/dev/st2-env-settings.rst | 6 - Help/release/dev/st2-exclude-patterns-variable.rst | 7 - Help/release/dev/static-frameworks.rst | 6 - Help/release/dev/swig_add_library.rst | 8 - Help/release/dev/timestamp-percent.rst | 5 - .../try_compile-honor-CMAKE_WARN_DEPRECATED.rst | 6 - Help/release/dev/try_compile-lang-std.rst | 9 - Help/release/dev/vs-advanced-source-properties.rst | 12 - Help/release/dev/vs-csharp-support.rst | 34 -- Help/release/dev/vs-custom-msbuild-props.rst | 9 - Help/release/dev/vs-debugger-config.rst | 6 - Help/release/dev/vs-default-build-package.rst | 7 - Help/release/dev/vs-dotnet-references.rst | 13 - Help/release/dev/vs-flag-order.rst | 9 - Help/release/dev/vs-host-x64-tools.rst | 7 - Help/release/dev/vs_targets_file_as_library.rst | 6 - Help/release/dev/wix-reg-install-dir.rst | 6 - Help/release/dev/xcode-effective-platform-name.rst | 8 - Help/release/dev/xcode-message-extension.rst | 7 - Help/release/index.rst | 1 + 65 files changed, 382 insertions(+), 499 deletions(-) create mode 100644 Help/release/3.8.rst delete mode 100644 Help/release/dev/CUDA-language-support.rst delete mode 100644 Help/release/dev/ExternalData-multiple-hashes.rst delete mode 100644 Help/release/dev/ExternalProject-GIT_CONFIG.rst delete mode 100644 Help/release/dev/FeatureSummary_enhancement.rst delete mode 100644 Help/release/dev/FindOpenGL-imported-targets.rst delete mode 100644 Help/release/dev/QtAutogen_Contain.rst delete mode 100644 Help/release/dev/QtAutogen_Skip.rst delete mode 100644 Help/release/dev/SOURCE_DATE_EPOCH.rst delete mode 100644 Help/release/dev/SublimeText-no-VERBOSE.rst delete mode 100644 Help/release/dev/UseSWIG-SWIG_OUTFILE_DIR.rst delete mode 100644 Help/release/dev/WCDH_allow_unsupported.rst delete mode 100644 Help/release/dev/add-BUILD_RPATH.rst delete mode 100644 Help/release/dev/add-LANG_CPPLINT.rst delete mode 100644 Help/release/dev/add-SHA-3.rst delete mode 100644 Help/release/dev/allow-fallback-config-mapping.rst delete mode 100644 Help/release/dev/capture-clang-tidy-errors.rst delete mode 100644 Help/release/dev/cdash_upload_retry.rst delete mode 100644 Help/release/dev/codeblocks-nmake-makefiles-jom.rst delete mode 100644 Help/release/dev/codelite-build-and-clean-targets-enhancement.rst delete mode 100644 Help/release/dev/compile-features-for-language-standards.rst delete mode 100644 Help/release/dev/cpack-ifw-configure-file.rst delete mode 100644 Help/release/dev/cpack-ifw-options.rst delete mode 100644 Help/release/dev/cpack-ifw-package-options.rst delete mode 100644 Help/release/dev/cpack-productbuild-signing.rst delete mode 100644 Help/release/dev/cpack-rpm-omit-unsupported-tags.rst delete mode 100644 Help/release/dev/cpack-rpm-single-debuginfo.rst delete mode 100644 Help/release/dev/cpack-rpm-user-file-list-with-multiple-directives.rst delete mode 100644 Help/release/dev/ctest_memcheck-leak_sanitizer.rst delete mode 100644 Help/release/dev/ctest_memcheck_defect_count.rst delete mode 100644 Help/release/dev/execute_process-encoding.rst delete mode 100644 Help/release/dev/expand_custom_commands.rst delete mode 100644 Help/release/dev/external-project-clone-progress.rst delete mode 100644 Help/release/dev/features-c++17.rst delete mode 100644 Help/release/dev/fuchsia-platform.rst delete mode 100644 Help/release/dev/gcc-features.rst delete mode 100644 Help/release/dev/if-genex.rst delete mode 100644 Help/release/dev/imported-interface-libname.rst delete mode 100644 Help/release/dev/imported-interface-no-system.rst delete mode 100644 Help/release/dev/intel-compile-features-windows.rst delete mode 100644 Help/release/dev/manually-added-dependencies.rst delete mode 100644 Help/release/dev/math-EXPR-unary.rst delete mode 100644 Help/release/dev/pkg-config-recheck.rst delete mode 100644 Help/release/dev/source_group-tree.rst delete mode 100644 Help/release/dev/src-COMPILE_FLAGS-genex.rst delete mode 100644 Help/release/dev/st2-env-settings.rst delete mode 100644 Help/release/dev/st2-exclude-patterns-variable.rst delete mode 100644 Help/release/dev/static-frameworks.rst delete mode 100644 Help/release/dev/swig_add_library.rst delete mode 100644 Help/release/dev/timestamp-percent.rst delete mode 100644 Help/release/dev/try_compile-honor-CMAKE_WARN_DEPRECATED.rst delete mode 100644 Help/release/dev/try_compile-lang-std.rst delete mode 100644 Help/release/dev/vs-advanced-source-properties.rst delete mode 100644 Help/release/dev/vs-csharp-support.rst delete mode 100644 Help/release/dev/vs-custom-msbuild-props.rst delete mode 100644 Help/release/dev/vs-debugger-config.rst delete mode 100644 Help/release/dev/vs-default-build-package.rst delete mode 100644 Help/release/dev/vs-dotnet-references.rst delete mode 100644 Help/release/dev/vs-flag-order.rst delete mode 100644 Help/release/dev/vs-host-x64-tools.rst delete mode 100644 Help/release/dev/vs_targets_file_as_library.rst delete mode 100644 Help/release/dev/wix-reg-install-dir.rst delete mode 100644 Help/release/dev/xcode-effective-platform-name.rst delete mode 100644 Help/release/dev/xcode-message-extension.rst 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:`_CPPLINT` target property and supporting + :variable:`CMAKE__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_` 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:`_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 ` 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 `` + 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 ` 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 ` 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: + ``$``. 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 ` :ref:`Interface Libraries` learned new + :prop_tgt:`IMPORTED_LIBNAME` and :prop_tgt:`IMPORTED_LIBNAME_` + 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 ` :ref:`Interface Libraries`. + +* The :manual:`Compile Features ` 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 + ``/_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 `. + +* 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_` + 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 + ```` 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_` + was introduced. The ```` 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 - ``/_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:`_CPPLINT` target property and supporting - :variable:`CMAKE__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_` 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:`_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 ` 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 `` - 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 ` 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 ` 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: - ``$``. 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 ` :ref:`Interface Libraries` learned new - :prop_tgt:`IMPORTED_LIBNAME` and :prop_tgt:`IMPORTED_LIBNAME_` - 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 ` :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 ` 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 `. 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_` - 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 - ```` 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_` - was introduced. The ```` 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> -- cgit v0.12