[CMake] [ANNOUNCE] CMake 3.11.0-rc3 is now ready for testing
Robert Maynard
robert.maynard at kitware.com
Sat Mar 10 13:55:41 EST 2018
You are correct the buildsystem documentation is out of date and now
incorrect. So please submit patch.
On Sat, Mar 10, 2018 at 4:03 AM, Kai Wolf <kai.wolf at gmail.com> wrote:
> Hey,
>
> it’s nice to see that we’re now able to set include directories and compiler
> flags for imported targets as well apparently.
> This means, no more
>
> add_library(foo UNKNOWN IMPORTED)
> set_target_properties(foo PROPERTIES
> INTERFACE_INCLUDE_DIRECTORIES …
> IMPORTED_LOCATION ..)
>
> but using target_* just like for any other target as well
>
> add_library(foo UNKNOWN IMPORTED)
> target_include_directories(foo PUBLIC …)
>
> However, reading through the 3.11 documentation [1] I think I’ve found a bug
> unfortunately:
>
> "It is not possible to use an IMPORTED target in the left-hand-side of the
> target_compile_definitions(), target_include_directories(),
> target_compile_options() or target_link_libraries() commands, as that would
> be an attempt to modify it. IMPORTED targets are designed to be used only in
> the right-hand-side of those commands."
>
> If that’s really the case, I will submit a patch for it right away. I just
> want to make sure, I’m not misunderstanding something here?
>
> Greetings,
>
> Kai Wolf
> http://kai-wolf.me/
>
> [1]
> https://cmake.org/cmake/help/v3.11/manual/cmake-buildsystem.7.html?highlight=right%20hand%20side#imported-targets
>
> Am 09.03.2018 um 20:00 schrieb Robert Maynard <robert.maynard at kitware.com>:
>
> I am proud to announce the third CMake 3.11 release candidate.
> https://cmake.org/download/
>
> Documentation is available at:
> https://cmake.org/cmake/help/v3.11
>
> Release notes appear below and are also published at
> https://cmake.org/cmake/help/v3.11/release/3.11.html
>
> Some of the more significant changes in CMake 3.11 are:
>
> * The Makefile Generators and the "Ninja" generator learned to add
> compiler launcher tools along with the compiler for the "Fortran"
> language ("C", "CXX", and "CUDA" were supported previously). See the
> "CMAKE_<LANG>_COMPILER_LAUNCHER" variable and
> "<LANG>_COMPILER_LAUNCHER" target property for details.
>
> * Visual Studio Generators learned to support the "COMPILE_LANGUAGE"
> "generator expression" in target-wide "COMPILE_DEFINITIONS",
> "INCLUDE_DIRECTORIES", "COMPILE_OPTIONS", and "file(GENERATE)". See
> generator expression documentation for caveats.
>
> * The "Xcode" Generator learned to support the "COMPILE_LANGUAGE"
> "generator expression" in target-wide "COMPILE_DEFINITIONS" and
> "INCLUDE_DIRECTORIES". It previously supported only
> "COMPILE_OPTIONS" and "file(GENERATE)". See generator expression
> documentation for caveats.
>
> * "add_library()" and "add_executable()" commands can now be called
> without any sources and will not complain as long as sources are
> added later via the "target_sources()" command.
>
> * The "target_compile_definitions()" command learned to set the
> "INTERFACE_COMPILE_DEFINITIONS" property on Imported Targets.
>
> * The "target_compile_features()" command learned to set the
> "INTERFACE_COMPILE_FEATURES" property on Imported Targets.
>
> * The "target_compile_options()" command learned to set the
> "INTERFACE_COMPILE_OPTIONS" property on Imported Targets.
>
> * The "target_include_directories()" command learned to set the
> "INTERFACE_INCLUDE_DIRECTORIES" property on Imported Targets.
>
> * The "target_sources()" command learned to set the
> "INTERFACE_SOURCES" property on Imported Targets.
>
> * The "target_link_libraries()" command learned to set the
> "INTERFACE_LINK_LIBRARIES" property on Imported Targets.
>
> * The "COMPILE_DEFINITIONS" source file property learned to support
> "generator expressions".
>
> * A "COMPILE_OPTIONS" source file property was added to manage list
> of options to pass to the compiler.
>
> * When using "AUTOMOC" or "AUTOUIC", CMake now starts multiple
> parallel "moc" or "uic" processes to reduce the build time. A new
> "CMAKE_AUTOGEN_PARALLEL" variable and "AUTOGEN_PARALLEL" target
> property may be set to specify the number of parallel "moc" or "uic"
> processes to start. The default is derived from the number of CPUs
> on the host.
>
>
> CMake 3.11 Release Notes
> ************************
>
> Changes made since CMake 3.10 include the following.
>
>
> New Features
> ============
>
>
> Platforms
> ---------
>
> * TI C/C++ compilers are now supported by the "Ninja" generator.
>
>
> Generators
> ----------
>
> * The "CodeBlocks" extra generator learned to check a
> "CMAKE_CODEBLOCKS_COMPILER_ID" variable for a custom compiler
> identification value to place in the project file.
>
> * The Makefile Generators and the "Ninja" generator learned to add
> compiler launcher tools along with the compiler for the "Fortran"
> language ("C", "CXX", and "CUDA" were supported previously). See the
> "CMAKE_<LANG>_COMPILER_LAUNCHER" variable and
> "<LANG>_COMPILER_LAUNCHER" target property for details.
>
> * Visual Studio Generators learned to support the "COMPILE_LANGUAGE"
> "generator expression" in target-wide "COMPILE_DEFINITIONS",
> "INCLUDE_DIRECTORIES", "COMPILE_OPTIONS", and "file(GENERATE)". See
> generator expression documentation for caveats.
>
> * The "Xcode" generator learned to support the "COMPILE_LANGUAGE"
> "generator expression" in target-wide "COMPILE_DEFINITIONS" and
> "INCLUDE_DIRECTORIES". It previously supported only
> "COMPILE_OPTIONS" and "file(GENERATE)". See generator expression
> documentation for caveats.
>
>
> Commands
> --------
>
> * "add_library()" and "add_executable()" commands can now be called
> without any sources and will not complain as long as sources are
> added later via the "target_sources()" command.
>
> * The "file(DOWNLOAD)" and "file(UPLOAD)" commands gained "NETRC"
> and "NETRC_FILE" options to specify use of a ".netrc" file.
>
> * The "target_compile_definitions()" command learned to set the
> "INTERFACE_COMPILE_DEFINITIONS" property on Imported Targets.
>
> * The "target_compile_features()" command learned to set the
> "INTERFACE_COMPILE_FEATURES" property on Imported Targets.
>
> * The "target_compile_options()" command learned to set the
> "INTERFACE_COMPILE_OPTIONS" property on Imported Targets.
>
> * The "target_include_directories()" command learned to set the
> "INTERFACE_INCLUDE_DIRECTORIES" property on Imported Targets.
>
> * The "target_sources()" command learned to set the
> "INTERFACE_SOURCES" property on Imported Targets.
>
> * The "target_link_libraries()" command learned to set the
> "INTERFACE_LINK_LIBRARIES" property on Imported Targets.
>
>
> Variables
> ---------
>
> * A "CMAKE_GENERATOR_INSTANCE" variable was introduced to hold the
> selected instance of the generator's corresponding native tools if
> multiple are available. This is used by the "Visual Studio 15 2017"
> generator to hold the selected instance of Visual Studio
> persistently.
>
> * A "CMAKE_INSTALL_DEFAULT_DIRECTORY_PERMISSIONS" variable was added
> to enable setting of default permissions for directories created
> implicitly during installation of files by "install()" and
> "file(INSTALL)", e.g. during "make install".
>
> * A "CMAKE_JOB_POOLS" variable was added specify a value to use for
> the "JOB_POOLS" property. This enables control over build
> parallelism with command line configuration parameters when using
> the Ninja generator.
>
> * The "CMAKE_NETRC" and "CMAKE_NETRC_FILE" variables were added to
> specify use of a ".netrc" file by the "file(DOWNLOAD)" and
> "file(UPLOAD)" commands and the "ExternalProject" module.
>
> * A "CMAKE_CUDA_SEPARABLE_COMPILATION" variable was added to
> initialize the "CUDA_SEPARABLE_COMPILATION" target property on
> targets when they are created.
>
>
> Properties
> ----------
>
> * The "COMPILE_DEFINITIONS" source file property learned to support
> "generator expressions".
>
> * A "COMPILE_OPTIONS" source file property was added to manage list
> of options to pass to the compiler.
>
> * An "IMPORTED_GLOBAL" target property was added to indicate whether
> an IMPORTED target is globally visible. It is automatically set to a
> true value for targets created with the "GLOBAL" option to
> "add_library()" or "add_executable()". Additionally, project code
> may now *promote* a local imported target to be globally visible by
> setting this property to "TRUE".
>
> * An "INCLUDE_DIRECTORIES" source file property was added to specify
> list of preprocessor include file search directories.
>
> * Source file properties "VS_SHADER_DISABLE_OPTIMIZATIONS" and
> "VS_SHADER_ENABLE_DEBUG" have been added to specify more details of
> ".hlsl" sources with Visual Studio Generators.
>
>
> Modules
> -------
>
> * The "CheckIncludeFile" module "check_include_file" macro learned
> to honor the "CMAKE_REQUIRED_LIBRARIES" variable.
>
> * The "CheckIncludeFileCXX" module "check_include_file_cxx" macro
> learned to honor the "CMAKE_REQUIRED_LIBRARIES" variable.
>
> * The "CheckIncludeFiles" module "check_include_files" macro learned
> to honor the "CMAKE_REQUIRED_LIBRARIES" variable.
>
> * The "CheckIncludeFiles" module "CHECK_INCLUDE_FILES()" command
> gained a "LANGUAGE" option to specify whether to check using the "C"
> or "CXX" compiler.
>
> * The "CMakePackageConfigHelpers" module
> "write_basic_package_version_file()" command learned a new
> "SameMinorVersion" mode for the "COMPATIBILITY" argument.
>
> * The "ExternalProject" module learned to substitute
> "<DOWNLOAD_DIR>" in comments, commands, working directory and
> byproducts.
>
> * The "ExternalProject" module gained "NETRC" and "NETRC_FILE"
> options to specify use of a ".netrc" file.
>
> * A new "FetchContent" module was added which supports populating
> content at configure time using any of the download/update methods
> supported by "ExternalProject_Add()". This allows the content to be
> used immediately during the configure stage, such as with
> "add_subdirectory()", etc. Hierarchical project structures are well
> supported, allowing parent projects to override the content details
> of child projects and ensuring content is not populated multiple
> times throughout the whole project tree.
>
> * The "FindBLAS" and "FindLAPACK" modules learned to support FLAME
> "blis" and "libflame".
>
> * The "FindDoxygen" module "doxygen_add_docs()" function now
> supports a new "DOXYGEN_VERBATIM_VARS" list variable. Any
> "DOXYGEN_..." variable contained in that list will bypass the
> automatic quoting logic, leaving its contents untouched when
> transferring them to the output "Doxyfile".
>
> * A "FindIconv" module was added to locate iconv support.
>
> * The "GenerateExportHeader" module "GENERATE_EXPORT_HEADER" command
> gained an "INCLUDE_GUARD_NAME" option to change the name of the
> include guard symbol written to the generated export header.
> Additionally, it now adds a comment after the closing "#endif" on
> the generated export header's include guard.
>
> * The "UseJava" module "add_jar" command gained a
> "GENERATE_NATIVE_HEADERS" option to generate native header files
> using "javac -h" for "javac" 1.8 or above. This supersedes
> "create_javah", which no longer works with JDK 1.10 and above due to
> removal of the "javah" tool by JEP 313.
>
>
> Autogen
> -------
>
> * When using "AUTOMOC" or "AUTOUIC", CMake now starts multiple
> parallel "moc" or "uic" processes to reduce the build time. A new
> "CMAKE_AUTOGEN_PARALLEL" variable and "AUTOGEN_PARALLEL" target
> property may be set to specify the number of parallel "moc" or "uic"
> processes to start. The default is derived from the number of CPUs
> on the host.
>
>
> CTest
> -----
>
> * The "ctest_start()" command no longer sets
> "CTEST_RUN_CURRENT_SCRIPT" due to issues with scoping if it is
> called from inside a function. Instead, it sets an internal variable
> in CTest. However, setting "CTEST_RUN_CURRENT_SCRIPT" to 0 at the
> global scope still prevents the script from being re-run at the end.
>
>
> CPack
> -----
>
> * "cpack(1)" gained "--trace" and "--trace-expand" options.
>
> * The "CPackIFW" module gained new
> "CPACK_IFW_PACKAGE_REMOVE_TARGET_DIR" variable to control if the
> target directory should not be deleted when uninstalling.
>
> * The "CPackRPM" module learned to enable enforcing of execute
> privileges on programs and shared libraries. See
> "CPACK_RPM_INSTALL_WITH_EXEC" variable.
>
> * A "CPACK_INSTALL_DEFAULT_DIRECTORY_PERMISSIONS" variable was added
> which serves the same purpose during packaging (e.g. "make package")
> as the "CMAKE_INSTALL_DEFAULT_DIRECTORY_PERMISSIONS" variable serves
> during installation (e.g. "make install").
>
>
> Other
> -----
>
> * Alias Targets may now alias Imported Targets that are created with
> the "GLOBAL" option to "add_library()".
>
> * Interface Libraries may now have custom properties set on them if
> they start with either an underscore ("_") or a lowercase ASCII
> character. The original intention was to only allow properties which
> made sense for "INTERFACE" libraries, but it also blocked usage of
> custom properties.
>
> * The "cmake(1)" "--open <dir>" command-line option was added to
> open generated IDE projects like Visual Studio solutions or Xcode
> projects.
>
>
> Deprecated and Removed Features
> ===============================
>
> * An explicit deprecation diagnostic was added for policies
> "CMP0037" through "CMP0054" ("CMP0036" and below were already
> deprecated). The "cmake-policies(7)" manual explains that the OLD
> behaviors of all policies are deprecated and that projects should
> port to the NEW behaviors.
>
> * The "KDevelop3" generator has been removed.
>
>
> Other Changes
> =============
>
> * Policy "CMP0037" no longer reserves target names associated with
> optional features, such as "test" and "package", unless the
> corresponding feature is enabled.
>
> * The "FindOpenGL" module now prefers GLVND libraries if available.
> See policy "CMP0072".
>
> * The minimum deployment target set in the
> "CMAKE_OSX_DEPLOYMENT_TARGET" variable used to be only applied for
> macOS regardless of the selected SDK. It is now properly set for
> the target platform selected by "CMAKE_OSX_SYSROOT". For example, if
> the sysroot variable specifies an iOS SDK then the value in
> "CMAKE_OSX_DEPLOYMENT_TARGET" is interpreted as minimum iOS version.
>
> * The "Xcode" generator behavior of generating one project file per
> "project()" command may now be controlled with the
> "CMAKE_XCODE_GENERATE_TOP_LEVEL_PROJECT_ONLY" variable. This could
> be useful to speed up the CMake generation step for large projects
> and to work-around a bug in the "ZERO_CHECK" logic.
>
> * Since the "CMakeCache.txt" format does not support newlines in
> values, values containing newlines are now truncated before writing
> to the file. In addition, a warning comment is written to the cache
> file, and a warning message is displayed to the user on the console.
>
> ----------------------------------------------------------------------------
> Changes made since CMake 3.11.0-rc2:
>
> Brad King (3):
> XL: Recognize compilers identified by __ibmxl__
> CUDA: Do not pass unsupported @rspfile arguments to NVCC
> CMake 3.11.0-rc3
>
> KWSys Upstream (1):
> KWSys 2018-03-07 (2ad561e7)
>
> Sebastian Holtermann (1):
> Autogen: Check if a file is empty before reading it
> --
>
> Powered by www.kitware.com
>
> Please keep messages on-topic and check the CMake FAQ at:
> http://www.cmake.org/Wiki/CMake_FAQ
>
> Kitware offers various services to support the CMake community. For more
> information on each offering, please visit:
>
> CMake Support: http://cmake.org/cmake/help/support.html
> CMake Consulting: http://cmake.org/cmake/help/consulting.html
> CMake Training Courses: http://cmake.org/cmake/help/training.html
>
> Visit other Kitware open-source projects at
> http://www.kitware.com/opensource/opensource.html
>
> Follow this link to subscribe/unsubscribe:
> https://cmake.org/mailman/listinfo/cmake
>
>
More information about the CMake
mailing list