1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243

CMake 3.13 Release Notes ************************ Changes made since CMake 3.12 include the following. New Features ============ Generators ---------- * The Visual Studio Generators for VS 2010 and above learned to support the "INTERPROCEDURAL_OPTIMIZATION" target property and supporting "CheckIPOSupported" module. * The "Xcode" generator learned to configure more Xcode Scheme fields. See the "CMAKE_XCODE_GENERATE_SCHEME" variable. * The "Green Hills MULTI" generator has been updated: * Added support for architecture selection through "CMAKE_GENERATOR_PLATFORM": e.g. "arm", "ppc", and "86". * Added support for toolset selection through "CMAKE_GENERATOR_TOOLSET", e.g. "comp_201205", "comp_201510", "comp_201722_beta". * Added support for platform selection through "GHS_TARGET_PLATFORM", e.g. "integrity", "linux", "standalone", etc. * No longer checks that "arm" based compilers are installed but ensures that the correct "gbuild.exe" exists. * No longer hard-codes ARM files, BSP, toolset, or OS locations. Command-Line ------------ * The "cmake(1)" command gained the "-S " command line option to specify the location of the source directory. This option can be used independently of "-B". * The "cmake(1)" command gained the "-B " command line option to specify the location of the build directory. This option can be used independently of "-S". * The "cmake(1)" "-E create_symlink" command can now be used on Windows. Commands -------- * The "add_custom_command()" and "add_custom_target()" commands learned to support generator expressions in "WORKING_DIRECTORY" options. * The "add_link_options()" command was created to add link options in the current directory. * The "install(CODE)" and "install(SCRIPT)" commands learned to support generator expressions. * The "install(TARGETS)" command learned to install targets created outside the current directory. * The "link_directories()" command gained options to control insertion position. * The "list(SORT)" command gained options to control the comparison operation used to order the entries. * The "math()" command gained options for hexadecimal. * The "target_link_directories()" command was created to specify link directories for targets and their dependents. * The "target_link_options()" command was created to specify link options for targets and their dependents. * The "target_link_libraries()" command may now be called to modify targets created outside the current directory. See policy "CMP0079". Variables --------- * A "CMAKE_AUTOGEN_VERBOSE" variable was added to optionally increase the verbosity of "AUTOMOC", "AUTOUIC" and "AUTORCC" from within CMake project code. * A "CMAKE_VS_GLOBALS" variable was added to initialize "VS_GLOBAL_" target properties on targets as they are created. Properties ---------- * The "DEPLOYMENT_ADDITIONAL_FILES" target property was added to tell the "Visual Studio 9 2008" generator to specify additional files for deployment to WinCE devices for remote debugging. * The "INTERFACE_LINK_DEPENDS" target property was created to specify transitive link dependencies on files. * The "LINK_DEPENDS" target property learned to support "generator expressions". * "LINK_DIRECTORIES" and "INTERFACE_LINK_DIRECTORIES" target properties were added to collect link directories for a target and its dependents. Use the "target_link_directories()" command to set them. * "LINK_OPTIONS" and "INTERFACE_LINK_OPTIONS" target properties were added to collect link options for a target and its dependents. Use the "target_link_options()" command to set them. * A "LINK_OPTIONS" directory property was added to collect link options for targets created under the current directory. Use the "add_link_options()" command to set it. * A "STATIC_LIBRARY_OPTIONS" target property was created to specify archiver options to use when creating static libraries. * A "VS_DEBUGGER_COMMAND_ARGUMENTS" target property was created to set the debugging command line arguments with Visual Studio Generators for VS 2010 and above. * A "VS_DEBUGGER_ENVIRONMENT" target property was created to set the debugging environment with Visual Studio Generators for VS 2010 and above. * The "VS_DEBUGGER_COMMAND" and "VS_DEBUGGER_WORKING_DIRECTORY" target properties now support generator expressions. Modules ------- * The "FindCURL" module learned to find debug and release variants separately. * The "FindMatlab" module gained new components "ENGINE_LIBRARY" and "DATAARRAY_LIBRARY" to request finding the Matlab C++ Engine and DataArray libraries respectively. * The "FindMatlab" module now explicitly exports mexFunction in Visual Studio. * The "FindMatlab" module gained a new "MCC_COMPILER" component to request finding the Matlab Compiler add-on. * The "FindPkgConfig" module gained an option to create imported targets in global scope. * The "FindPkgConfig" module gained support for "" operators for version checks in addition to the already supported operators ">=", "<=", and "=". * Modules "FindPython3", "FindPython2" and "FindPython" gain capability to control order of resource lookup on macOS (Framework) and Windows (Registry). * The "FindSubversion" module "Subversion_WC_INFO" command gained an "IGNORE_SVN_FAILURE" option to suppress failures, e.g. when the source tree is not under Subversion control. * The "UseSWIG" module learned to manage target property "INCLUDE_DIRECTORIES" for "SWIG" compilation. CTest ----- * "ctest(1)" gained a "--progress" option to enable a live test progress summary when output goes to a terminal. CPack ----- * The "CPack Deb Generator" learned to split debug symbols into a corresponding .ddeb package when "CPACK_DEBIAN_DEBUGINFO_PACKAGE" is set. * The "CPack Deb Generator" learned to honor the "SOURCE_DATE_EPOCH" environment variable when packaging files. This is useful for generating reproducible packages. * CPack gained a new "CPack External Generator" which is used to export the CPack metadata in a format that other software can understand. The intention of this generator is to allow external packaging software to take advantage of CPack's features when it may not be possible to use CPack for the entire packaging process. Deprecated and Removed Features =============================== * An explicit deprecation diagnostic was added for policies "CMP0055" through "CMP0063" ("CMP0054" 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. Other Changes ============= * The "option()" command now honors an existing normal variable of the same name and does nothing instead of possibly creating a cache entry (or setting its type) and removing the normal variable. See policy "CMP0077". * The Makefile Generators learned to remove custom command and custom target byproducts during "make clean". * The "target_sources()" command now interprets relative source file paths as relative to the current source directory. This simplifies incrementally building up a target's sources from subdirectories. The "CMP0076" policy was added to provide backward compatibility with the old behavior where required. * The "BundleUtilities" module may no longer be included at configure time. This was always a bug anyway. See policy "CMP0080". * The "UseSWIG" module has changed strategy for target naming. See policy "CMP0078". * The "LINK_DIRECTORIES" target property now expects absolute paths. See policy "CMP0081". * The CPack generators have been moved into their own separate section in the documentation, rather than having the documentation in their internal implementation modules. These internal implementation modules are also no longer available to scripts that may have been incorrectly including them, because they should never have been available in the first place.