OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	04/04/2023 07:10:48 PM	rwxr-xr-x
📄 3.0.html	83.45 KB	04/04/2023 07:05:27 PM	rw-r--r--
📄 3.1.html	70.92 KB	04/04/2023 07:05:27 PM	rw-r--r--
📄 3.10.html	48.32 KB	04/04/2023 07:05:27 PM	rw-r--r--
📄 3.11.html	60.09 KB	04/04/2023 07:05:27 PM	rw-r--r--
📄 3.12.html	55.96 KB	04/04/2023 07:05:27 PM	rw-r--r--
📄 3.13.html	46.76 KB	04/04/2023 07:05:28 PM	rw-r--r--
📄 3.14.html	76.84 KB	04/04/2023 07:05:28 PM	rw-r--r--
📄 3.15.html	68.25 KB	04/04/2023 07:05:28 PM	rw-r--r--
📄 3.16.html	60.81 KB	04/04/2023 07:05:28 PM	rw-r--r--
📄 3.17.html	65.15 KB	04/04/2023 07:05:28 PM	rw-r--r--
📄 3.18.html	64.02 KB	04/04/2023 07:05:28 PM	rw-r--r--
📄 3.19.html	74.24 KB	04/04/2023 07:05:28 PM	rw-r--r--
📄 3.2.html	44.62 KB	04/04/2023 07:05:29 PM	rw-r--r--
📄 3.20.html	63.14 KB	04/04/2023 07:05:29 PM	rw-r--r--
📄 3.21.html	62.32 KB	04/04/2023 07:05:29 PM	rw-r--r--
📄 3.22.html	34.04 KB	04/04/2023 07:05:29 PM	rw-r--r--
📄 3.23.html	58.94 KB	04/04/2023 07:05:29 PM	rw-r--r--
📄 3.24.html	71.01 KB	04/04/2023 07:05:29 PM	rw-r--r--
📄 3.25.html	49.46 KB	04/04/2023 07:05:29 PM	rw-r--r--
📄 3.26.html	34.8 KB	04/04/2023 07:05:29 PM	rw-r--r--
📄 3.3.html	49.11 KB	04/04/2023 07:05:29 PM	rw-r--r--
📄 3.4.html	53.38 KB	04/04/2023 07:05:30 PM	rw-r--r--
📄 3.5.html	33.65 KB	04/04/2023 07:05:30 PM	rw-r--r--
📄 3.6.html	56.32 KB	04/04/2023 07:05:30 PM	rw-r--r--
📄 3.7.html	59.04 KB	04/04/2023 07:05:30 PM	rw-r--r--
📄 3.8.html	80.81 KB	04/04/2023 07:05:30 PM	rw-r--r--
📄 3.9.html	64.52 KB	04/04/2023 07:05:30 PM	rw-r--r--
📄 index.html	7.43 KB	04/04/2023 07:05:30 PM	rw-r--r--

Editing: 3.14.html

<!DOCTYPE html>

<title>CMake 3.14 Release Notes &mdash; CMake 3.26.3 Documentation</title>

</head><body>

<div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 accesskey="I">index</a></li>
 <li class="right" >
 <a href="3.13.html" title="CMake 3.13 Release Notes"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="3.15.html" title="CMake 3.15 Release Notes"
 accesskey="P">previous</a> |</li>
 <li>
 <img src="../_static/cmake-logo-16.png" alt=""
 style="vertical-align: middle; margin-top: -2px" />
 </li>
 <li>
 <a href="https://cmake.org/">CMake</a> &#187;
 </li>
 <li>
 <a href="../index.html">3.26.3 Documentation</a> &#187;
 </li>

<li class="nav-item nav-item-1"><a href="index.html" accesskey="U">CMake Release Notes</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">CMake 3.14 Release Notes</a></li> 
 </ul>
 </div>

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="cmake-3-14-release-notes">
<h1><a class="toc-backref" href="#id7" role="doc-backlink">CMake 3.14 Release Notes</a><a class="headerlink" href="#cmake-3-14-release-notes" title="Permalink to this heading">¶</a></h1>
<nav class="contents" id="contents">
Contents
<ul class="simple">
<li><a class="reference internal" href="#cmake-3-14-release-notes" id="id7">CMake 3.14 Release Notes</a>
<ul>
<li><a class="reference internal" href="#new-features" id="id8">New Features</a>
<ul>
<li><a class="reference internal" href="#generators" id="id9">Generators</a></li>
<li><a class="reference internal" href="#file-based-api" id="id10">File-Based API</a></li>
<li><a class="reference internal" href="#platforms" id="id11">Platforms</a></li>
<li><a class="reference internal" href="#command-line" id="id12">Command-Line</a></li>
<li><a class="reference internal" href="#commands" id="id13">Commands</a></li>
<li><a class="reference internal" href="#variables" id="id14">Variables</a></li>
<li><a class="reference internal" href="#properties" id="id15">Properties</a></li>
<li><a class="reference internal" href="#modules" id="id16">Modules</a></li>
<li><a class="reference internal" href="#generator-expressions" id="id17">Generator Expressions</a></li>
<li><a class="reference internal" href="#autogen" id="id18">Autogen</a></li>
<li><a class="reference internal" href="#ctest" id="id19">CTest</a></li>
</ul>
</li>
<li><a class="reference internal" href="#deprecated-and-removed-features" id="id20">Deprecated and Removed Features</a></li>
<li><a class="reference internal" href="#other-changes" id="id21">Other Changes</a></li>
<li><a class="reference internal" href="#updates" id="id22">Updates</a>
<ul>
<li><a class="reference internal" href="#id1" id="id23">3.14.1</a></li>
<li><a class="reference internal" href="#id2" id="id24">3.14.3</a></li>
<li><a class="reference internal" href="#id3" id="id25">3.14.4</a></li>
<li><a class="reference internal" href="#id4" id="id26">3.14.5</a></li>
<li><a class="reference internal" href="#id5" id="id27">3.14.6</a></li>
<li><a class="reference internal" href="#id6" id="id28">3.14.7</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</nav>
Changes made since CMake 3.13 include the following.
<section id="new-features">
<h2><a class="toc-backref" href="#id8" role="doc-backlink">New Features</a><a class="headerlink" href="#new-features" title="Permalink to this heading">¶</a></h2>
<section id="generators">
<h3><a class="toc-backref" href="#id9" role="doc-backlink">Generators</a><a class="headerlink" href="#generators" title="Permalink to this heading">¶</a></h3>
<ul>
<li>The <a class="reference internal" href="../generator/Visual%20Studio%2016%202019.html#generator:Visual Studio 16 2019" title="Visual Studio 16 2019"><code class="xref cmake cmake-generator docutils literal notranslate">Visual Studio 16 2019</code></a> generator was added. This is
experimental and based on &quot;Visual Studio 2019 Preview 4&quot; because this
version of VS has not been released.
The VS 2019 generator differs from generators for earlier versions
in that it does not provide variants that specify the target platform
in the generator name. Instead <a class="reference internal" href="../variable/CMAKE_GENERATOR_PLATFORM.html#variable:CMAKE_GENERATOR_PLATFORM" title="CMAKE_GENERATOR_PLATFORM"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_GENERATOR_PLATFORM</code></a>
must be used, e.g. through the <code class="docutils literal notranslate">-A</code> command-line option. Furthermore,
the default target platform (architecture) is now based on the host
platform. The VS host toolset selection is now based on the host
architecture as well.
</li>
<li>The <a class="reference internal" href="../generator/Green%20Hills%20MULTI.html#generator:Green Hills MULTI" title="Green Hills MULTI"><code class="xref cmake cmake-generator docutils literal notranslate">Green Hills MULTI</code></a> generator has been updated:
<ul class="simple">
<li>Now supports <a class="reference internal" href="../manual/cmake-buildsystem.7.html#object-libraries">Object Libraries</a>.</li>
<li>Now warns on unsupported project types such as shared libraries.</li>
<li>Now generates a top-level <code class="docutils literal notranslate">&lt;PROJECT-NAME&gt;.top.gpj</code> for each directory
calling the <a class="reference internal" href="../command/project.html#command:project" title="project"><code class="xref cmake cmake-command docutils literal notranslate">project()</code></a> command. The top-level project file
<code class="docutils literal notranslate">default.gpj</code> is no longer created.</li>
<li>Now honors target renaming and destination output control properties
such as <a class="reference internal" href="../prop_tgt/RUNTIME_OUTPUT_DIRECTORY.html#prop_tgt:RUNTIME_OUTPUT_DIRECTORY" title="RUNTIME_OUTPUT_DIRECTORY"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">RUNTIME_OUTPUT_DIRECTORY</code></a> and <a class="reference internal" href="../prop_tgt/OUTPUT_NAME.html#prop_tgt:OUTPUT_NAME" title="OUTPUT_NAME"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">OUTPUT_NAME</code></a>.
This also fixes support for installation rules generated by
<a class="reference internal" href="../command/install.html#command:install" title="install"><code class="xref cmake cmake-command docutils literal notranslate">install()</code></a>.</li>
<li>Now honors source file properties <a class="reference internal" href="../prop_sf/INCLUDE_DIRECTORIES.html#prop_sf:INCLUDE_DIRECTORIES" title="INCLUDE_DIRECTORIES"><code class="xref cmake cmake-prop_sf docutils literal notranslate">INCLUDE_DIRECTORIES</code></a>,
<a class="reference internal" href="../prop_sf/COMPILE_DEFINITIONS.html#prop_sf:COMPILE_DEFINITIONS" title="COMPILE_DEFINITIONS"><code class="xref cmake cmake-prop_sf docutils literal notranslate">COMPILE_DEFINITIONS</code></a>, and <a class="reference internal" href="../prop_sf/COMPILE_OPTIONS.html#prop_sf:COMPILE_OPTIONS" title="COMPILE_OPTIONS"><code class="xref cmake cmake-prop_sf docutils literal notranslate">COMPILE_OPTIONS</code></a>.</li>
<li>Now supports Dynamic Download Integrity Applications which did not include
Integrate Files via <a class="reference internal" href="../prop_tgt/GHS_INTEGRITY_APP.html#prop_tgt:GHS_INTEGRITY_APP" title="GHS_INTEGRITY_APP"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">GHS_INTEGRITY_APP</code></a> and setting a target
link flag of <code class="docutils literal notranslate">-dynamic</code>.</li>
<li>The contents of project files now sorts sources groups and files by name.
Set the <a class="reference internal" href="../prop_tgt/GHS_NO_SOURCE_GROUP_FILE.html#prop_tgt:GHS_NO_SOURCE_GROUP_FILE" title="GHS_NO_SOURCE_GROUP_FILE"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">GHS_NO_SOURCE_GROUP_FILE</code></a> target property to <code class="docutils literal notranslate">ON</code> to
generate a single project file for the target instead of a project file for
each source group. Set the <a class="reference internal" href="../variable/CMAKE_GHS_NO_SOURCE_GROUP_FILE.html#variable:CMAKE_GHS_NO_SOURCE_GROUP_FILE" title="CMAKE_GHS_NO_SOURCE_GROUP_FILE"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_GHS_NO_SOURCE_GROUP_FILE</code></a>
variable to enable this for all targets.</li>
</ul>
</li>
</ul>
</section>
<section id="file-based-api">
<h3><a class="toc-backref" href="#id10" role="doc-backlink">File-Based API</a><a class="headerlink" href="#file-based-api" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>A file-based api for clients to get semantic buildsystem information
has been added. See the <a class="reference internal" href="../manual/cmake-file-api.7.html#manual:cmake-file-api(7)" title="cmake-file-api(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-file-api(7)</code></a> manual.
This is intended to replace the <a class="reference internal" href="../manual/cmake-server.7.html#manual:cmake-server(7)" title="cmake-server(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-server(7)</code></a> mode for IDEs.</li>
</ul>
</section>
<section id="platforms">
<h3><a class="toc-backref" href="#id11" role="doc-backlink">Platforms</a><a class="headerlink" href="#platforms" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>CMake now supports <a class="reference internal" href="../manual/cmake-toolchains.7.html#cross-compiling-for-ios-tvos-or-watchos">Cross Compiling for iOS, tvOS, or watchOS</a>
using simple toolchain files.</li>
</ul>
</section>
<section id="command-line">
<h3><a class="toc-backref" href="#id12" role="doc-backlink">Command-Line</a><a class="headerlink" href="#command-line" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>The <a class="reference internal" href="../manual/cmake.1.html#manual:cmake(1)" title="cmake(1)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake(1)</code></a> <a class="reference internal" href="../manual/cmake.1.html#build-tool-mode">Build Tool Mode</a>
(<code class="docutils literal notranslate">cmake --build</code>) gained <code class="docutils literal notranslate">--verbose</code> and <code class="docutils literal notranslate">-v</code> options to
specify verbose build output. Some generators such as Xcode don't
support this option currently.</li>
<li>The <a class="reference internal" href="../manual/cmake.1.html#manual:cmake(1)" title="cmake(1)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake(1)</code></a> <code class="docutils literal notranslate">-E compare_files</code> command learned a new
<code class="docutils literal notranslate">--ignore-eol</code> option to specify that end-of-line differences
(e.g. LF vs CRLF) should be ignored when comparing files.</li>
<li>The <a class="reference internal" href="../manual/cmake-gui.1.html#manual:cmake-gui(1)" title="cmake-gui(1)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-gui(1)</code></a> dialog gained new <code class="docutils literal notranslate">-S</code> and <code class="docutils literal notranslate">-B</code> arguments to
explicitly specify source and build directories.</li>
</ul>
</section>
<section id="commands">
<h3><a class="toc-backref" href="#id13" role="doc-backlink">Commands</a><a class="headerlink" href="#commands" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>The <a class="reference internal" href="../command/file.html#command:file" title="file"><code class="xref cmake cmake-command docutils literal notranslate">file()</code></a> command learned a new sub-command, <code class="docutils literal notranslate">CREATE_LINK</code>,
which can be used to create hard or symbolic links.</li>
<li>The <a class="reference internal" href="../command/file.html#command:file" title="file"><code class="xref cmake cmake-command docutils literal notranslate">file()</code></a> command learned a new sub-command, <code class="docutils literal notranslate">READ_SYMLINK</code>,
which can be used to determine the path that a symlink points to.</li>
<li>The <a class="reference internal" href="../command/file.html#command:file" title="file"><code class="xref cmake cmake-command docutils literal notranslate">file()</code></a> command gained a <code class="docutils literal notranslate">SIZE</code> mode to get the size
of a file on disk.</li>
<li>The <a class="reference internal" href="../command/find_package.html#command:find_package" title="find_package"><code class="xref cmake cmake-command docutils literal notranslate">find_package()</code></a> command learned to optionally resolve
symbolic links in the paths to package configuration files.
See the <a class="reference internal" href="../variable/CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS.html#variable:CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS" title="CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS</code></a> variable.</li>
<li>The <a class="reference internal" href="../command/get_filename_component.html#command:get_filename_component" title="get_filename_component"><code class="xref cmake cmake-command docutils literal notranslate">get_filename_component()</code></a> command gained new
<code class="docutils literal notranslate">LAST_EXT</code> and <code class="docutils literal notranslate">NAME_WLE</code> variants to work with the
extension after the last <code class="docutils literal notranslate">.</code> in the name.</li>
<li>The <a class="reference internal" href="../command/if.html#command:if" title="if"><code class="xref cmake cmake-command docutils literal notranslate">if()</code></a> command gained support for checking if cache variables
are defined with the <code class="docutils literal notranslate">DEFINED CACHE{VAR}</code> syntax.</li>
<li>The <a class="reference internal" href="../command/install.html#command:install" title="install"><code class="xref cmake cmake-command docutils literal notranslate">install(CODE)</code></a> and <a class="reference internal" href="../command/install.html#command:install" title="install"><code class="xref cmake cmake-command docutils literal notranslate">install(SCRIPT)</code></a> commands
learned to support generator expressions. See policy <a class="reference internal" href="../policy/CMP0087.html#policy:CMP0087" title="CMP0087"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0087</code></a>.</li>
<li>The <a class="reference internal" href="../command/install.html#command:install" title="install"><code class="xref cmake cmake-command docutils literal notranslate">install(TARGETS)</code></a> command learned how to install to an
appropriate default directory for a given target type, based on
variables from the <a class="reference internal" href="../module/GNUInstallDirs.html#module:GNUInstallDirs" title="GNUInstallDirs"><code class="xref cmake cmake-module docutils literal notranslate">GNUInstallDirs</code></a> module and built-in defaults,
in lieu of a <code class="docutils literal notranslate">DESTINATION</code> argument.</li>
<li>The <a class="reference internal" href="../command/install.html#command:install" title="install"><code class="xref cmake cmake-command docutils literal notranslate">install(FILES)</code></a> and <a class="reference internal" href="../command/install.html#command:install" title="install"><code class="xref cmake cmake-command docutils literal notranslate">install(DIRECTORY)</code></a> commands
learned a new set of parameters for installing files as a file type,
setting the destination based on the appropriate variables from
<a class="reference internal" href="../module/GNUInstallDirs.html#module:GNUInstallDirs" title="GNUInstallDirs"><code class="xref cmake cmake-module docutils literal notranslate">GNUInstallDirs</code></a> and built-in defaults, in lieu of a
<code class="docutils literal notranslate">DESTINATION</code> argument.</li>
<li>The <a class="reference internal" href="../command/list.html#command:list" title="list"><code class="xref cmake cmake-command docutils literal notranslate">list()</code></a> operations <code class="docutils literal notranslate">REMOVE_ITEM</code>, <code class="docutils literal notranslate">REMOVE_DUPLICATES</code>,
<code class="docutils literal notranslate">SORT</code>, <code class="docutils literal notranslate">REVERSE</code>, and <code class="docutils literal notranslate">FILTER</code> all now accept a non-existent variable
as the list since these operations on empty lists is also the empty list.</li>
<li>The <a class="reference internal" href="../command/list.html#command:list" title="list"><code class="xref cmake cmake-command docutils literal notranslate">list()</code></a> operation <code class="docutils literal notranslate">REMOVE_AT</code> now indicates that the given
indices are invalid for a non-existent variable or empty list.</li>
<li>The <a class="reference internal" href="../command/try_compile.html#command:try_compile" title="try_compile"><code class="xref cmake cmake-command docutils literal notranslate">try_compile()</code></a> and <a class="reference internal" href="../command/try_run.html#command:try_run" title="try_run"><code class="xref cmake cmake-command docutils literal notranslate">try_run()</code></a> commands gained a new
<code class="docutils literal notranslate">LINK_OPTIONS</code> option.</li>
</ul>
</section>
<section id="variables">
<h3><a class="toc-backref" href="#id14" role="doc-backlink">Variables</a><a class="headerlink" href="#variables" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>A <a class="reference internal" href="../variable/CMAKE_BUILD_RPATH_USE_ORIGIN.html#variable:CMAKE_BUILD_RPATH_USE_ORIGIN" title="CMAKE_BUILD_RPATH_USE_ORIGIN"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_BUILD_RPATH_USE_ORIGIN</code></a> variable and corresponding
<a class="reference internal" href="../prop_tgt/BUILD_RPATH_USE_ORIGIN.html#prop_tgt:BUILD_RPATH_USE_ORIGIN" title="BUILD_RPATH_USE_ORIGIN"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">BUILD_RPATH_USE_ORIGIN</code></a> target property were added to
enable use of relative runtime paths (RPATHs). This helps achieving
relocatable and reproducible builds that are invariant of the build
directory.</li>
<li>A <a class="reference internal" href="../variable/CMAKE_VS_PLATFORM_NAME_DEFAULT.html#variable:CMAKE_VS_PLATFORM_NAME_DEFAULT" title="CMAKE_VS_PLATFORM_NAME_DEFAULT"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_VS_PLATFORM_NAME_DEFAULT</code></a> variable was added for
<a class="reference internal" href="../manual/cmake-generators.7.html#visual-studio-generators">Visual Studio Generators</a> to report their default platform used
when <a class="reference internal" href="../variable/CMAKE_GENERATOR_PLATFORM.html#variable:CMAKE_GENERATOR_PLATFORM" title="CMAKE_GENERATOR_PLATFORM"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_GENERATOR_PLATFORM</code></a> is not set explicitly.</li>
</ul>
</section>
<section id="properties">
<h3><a class="toc-backref" href="#id15" role="doc-backlink">Properties</a><a class="headerlink" href="#properties" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>A <a class="reference internal" href="../prop_gbl/CMAKE_ROLE.html#prop_gbl:CMAKE_ROLE" title="CMAKE_ROLE"><code class="xref cmake cmake-prop_gbl docutils literal notranslate">CMAKE_ROLE</code></a> global property was added to allow scripts to
determine whether they're running in project mode, script mode,
find-package mode, CTest, or CPack.</li>
<li>The <a class="reference internal" href="../prop_tgt/CUDA_RESOLVE_DEVICE_SYMBOLS.html#prop_tgt:CUDA_RESOLVE_DEVICE_SYMBOLS" title="CUDA_RESOLVE_DEVICE_SYMBOLS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">CUDA_RESOLVE_DEVICE_SYMBOLS</code></a> target property is now supported
on shared library, module library, and executable targets. Previously it was
only honored on static libraries.</li>
<li>The <a class="reference internal" href="../prop_tgt/EXCLUDE_FROM_ALL.html#prop_tgt:EXCLUDE_FROM_ALL" title="EXCLUDE_FROM_ALL"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">EXCLUDE_FROM_ALL</code></a> target property was created to override
the setting of its directory. A target will now be built as part of &quot;all&quot;
if its <a class="reference internal" href="../prop_tgt/EXCLUDE_FROM_ALL.html#prop_tgt:EXCLUDE_FROM_ALL" title="EXCLUDE_FROM_ALL"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">EXCLUDE_FROM_ALL</code></a> property is set to <code class="docutils literal notranslate">OFF</code>, even if its
containing directory is marked as <a class="reference internal" href="../prop_dir/EXCLUDE_FROM_ALL.html#prop_dir:EXCLUDE_FROM_ALL" title="EXCLUDE_FROM_ALL"><code class="xref cmake cmake-prop_dir docutils literal notranslate">EXCLUDE_FROM_ALL</code></a>.</li>
<li><a class="reference internal" href="../prop_tgt/INTERFACE_POSITION_INDEPENDENT_CODE.html#prop_tgt:INTERFACE_POSITION_INDEPENDENT_CODE" title="INTERFACE_POSITION_INDEPENDENT_CODE"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_POSITION_INDEPENDENT_CODE</code></a> target property gains the
support of <a class="reference internal" href="../manual/cmake-generator-expressions.7.html#manual:cmake-generator-expressions(7)" title="cmake-generator-expressions(7)"><code class="xref cmake cmake-manual docutils literal notranslate">generator expressions</code></a>.</li>
</ul>
</section>
<section id="modules">
<h3><a class="toc-backref" href="#id16" role="doc-backlink">Modules</a><a class="headerlink" href="#modules" title="Permalink to this heading">¶</a></h3>
<ul>
<li>The family of modules to check capabilities (like
<a class="reference internal" href="../module/CheckCSourceCompiles.html#module:CheckCSourceCompiles" title="CheckCSourceCompiles"><code class="xref cmake cmake-module docutils literal notranslate">CheckCSourceCompiles</code></a>) gain capability to manage <code class="docutils literal notranslate">LINK_OPTIONS</code>.</li>
<li>A <a class="reference internal" href="../module/CheckFortranSourceRuns.html#module:CheckFortranSourceRuns" title="CheckFortranSourceRuns"><code class="xref cmake cmake-module docutils literal notranslate">CheckFortranSourceRuns</code></a> module was added to provide a
<a class="reference internal" href="../module/CheckFortranSourceRuns.html#command:check_fortran_source_runs" title="check_fortran_source_runs"><code class="xref cmake cmake-command docutils literal notranslate">check_fortran_source_runs()</code></a> command to check if a Fortran
source snippet compiles and runs.</li>
<li>The <a class="reference internal" href="../module/CMakePackageConfigHelpers.html#module:CMakePackageConfigHelpers" title="CMakePackageConfigHelpers"><code class="xref cmake cmake-module docutils literal notranslate">CMakePackageConfigHelpers</code></a> module's
<a class="reference internal" href="../module/CMakePackageConfigHelpers.html#command:write_basic_package_version_file" title="write_basic_package_version_file"><code class="xref cmake cmake-command docutils literal notranslate">write_basic_package_version_file()</code></a> command gained a new
<code class="docutils literal notranslate">ARCH_INDEPENDENT</code> option for supporting architecture-independent
packages.</li>
<li>The <a class="reference internal" href="../module/ExternalProject.html#module:ExternalProject" title="ExternalProject"><code class="xref cmake cmake-module docutils literal notranslate">ExternalProject</code></a> module <a class="reference internal" href="../module/ExternalProject.html#command:externalproject_add" title="externalproject_add"><code class="xref cmake cmake-command docutils literal notranslate">ExternalProject_Add()</code></a> command
gained <code class="docutils literal notranslate">LOG_DIR</code> and <code class="docutils literal notranslate">LOG_MERGED_STDOUTERR</code> options to control logging.</li>
<li>The <a class="reference internal" href="../module/ExternalProject.html#module:ExternalProject" title="ExternalProject"><code class="xref cmake cmake-module docutils literal notranslate">ExternalProject</code></a> module <a class="reference internal" href="../module/ExternalProject.html#command:externalproject_add" title="externalproject_add"><code class="xref cmake cmake-command docutils literal notranslate">ExternalProject_Add()</code></a> command
gained <code class="docutils literal notranslate">LOG_PATCH</code> to optionally log the patch step.</li>
<li>The <a class="reference internal" href="../module/ExternalProject.html#module:ExternalProject" title="ExternalProject"><code class="xref cmake cmake-module docutils literal notranslate">ExternalProject</code></a> module <a class="reference internal" href="../module/ExternalProject.html#command:externalproject_add" title="externalproject_add"><code class="xref cmake cmake-command docutils literal notranslate">ExternalProject_Add()</code></a> command
learned to apply <code class="docutils literal notranslate">SOURCE_SUBDIR</code> when <code class="docutils literal notranslate">BUILD_IN_SOURCE</code> is also used.
The <code class="docutils literal notranslate">BUILD_COMMAND</code> is run in the given <code class="docutils literal notranslate">SOURCE_SUBDIR</code> of the
<code class="docutils literal notranslate">SOURCE_DIR</code>.</li>
<li>The <a class="reference internal" href="../module/FetchContent.html#module:FetchContent" title="FetchContent"><code class="xref cmake cmake-module docutils literal notranslate">FetchContent</code></a> module gained a new
<a class="reference internal" href="../module/FetchContent.html#command:fetchcontent_makeavailable" title="fetchcontent_makeavailable"><code class="xref cmake cmake-command docutils literal notranslate">FetchContent_MakeAvailable()</code></a> command. It accepts a list of
dependency names, which it then iterates over, populating and adding
each one to the main build using the canonical pattern. This
significantly reduces the amount of boilerplate needed in a project.</li>
<li>The <a class="reference internal" href="../module/FindBISON.html#module:FindBISON" title="FindBISON"><code class="xref cmake cmake-module docutils literal notranslate">FindBISON</code></a> module's <code class="docutils literal notranslate">BISON_TARGET</code> command now runs <code class="docutils literal notranslate">bison</code>
with <a class="reference internal" href="../variable/CMAKE_CURRENT_BINARY_DIR.html#variable:CMAKE_CURRENT_BINARY_DIR" title="CMAKE_CURRENT_BINARY_DIR"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_CURRENT_BINARY_DIR</code></a> as the working directory.
See policy <a class="reference internal" href="../policy/CMP0088.html#policy:CMP0088" title="CMP0088"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0088</code></a>.</li>
<li>The <a class="reference internal" href="../module/FindCURL.html#module:FindCURL" title="FindCURL"><code class="xref cmake cmake-module docutils literal notranslate">FindCURL</code></a> module gained support for requesting
protocols as package components.</li>
<li>The <a class="reference internal" href="../module/FindFontconfig.html#module:FindFontconfig" title="FindFontconfig"><code class="xref cmake cmake-module docutils literal notranslate">FindFontconfig</code></a> module was added to find <a class="reference external" href="https://www.freedesktop.org/wiki/Software/fontconfig/">fontconfig</a>.</li>
<li>The <a class="reference internal" href="../module/FindGDAL.html#module:FindGDAL" title="FindGDAL"><code class="xref cmake cmake-module docutils literal notranslate">FindGDAL</code></a> module now provides imported targets.</li>
<li>The <a class="reference internal" href="../module/FindGIF.html#module:FindGIF" title="FindGIF"><code class="xref cmake cmake-module docutils literal notranslate">FindGIF</code></a> module now provides imported targets.</li>
<li>The <a class="reference internal" href="../module/FindGit.html#module:FindGit" title="FindGit"><code class="xref cmake cmake-module docutils literal notranslate">FindGit</code></a> module now provides an imported target for the
Git executable.</li>
<li>The <a class="reference internal" href="../module/FindIce.html#module:FindIce" title="FindIce"><code class="xref cmake cmake-module docutils literal notranslate">FindIce</code></a> module learned to find <code class="docutils literal notranslate">slice2confluence</code>
and <code class="docutils literal notranslate">slice2matlab</code>.</li>
<li>The <a class="reference internal" href="../module/FindLibinput.html#module:FindLibinput" title="FindLibinput"><code class="xref cmake cmake-module docutils literal notranslate">FindLibinput</code></a> module was added to find <a class="reference external" href="https://www.freedesktop.org/wiki/Software/libinput/">libinput</a>.</li>
<li>The <a class="reference internal" href="../module/FindLibLZMA.html#module:FindLibLZMA" title="FindLibLZMA"><code class="xref cmake cmake-module docutils literal notranslate">FindLibLZMA</code></a> module now provides imported targets.</li>
<li>The <a class="reference internal" href="../module/FindMatlab.html#module:FindMatlab" title="FindMatlab"><code class="xref cmake cmake-module docutils literal notranslate">FindMatlab</code></a> module gained new options <code class="docutils literal notranslate">R2017b</code> and
<code class="docutils literal notranslate">R2018a</code> to specify the MEX API version to use; these options
mirror the new options to the <code class="docutils literal notranslate">mex</code> command in MATLAB R2018a.
The option <code class="docutils literal notranslate">MX_LIBRARY</code> is no longer needed.</li>
<li>The <a class="reference internal" href="../module/FindPostgreSQL.html#module:FindPostgreSQL" title="FindPostgreSQL"><code class="xref cmake cmake-module docutils literal notranslate">FindPostgreSQL</code></a> module now provides imported targets.</li>
<li>The <a class="reference internal" href="../module/FindPython.html#module:FindPython" title="FindPython"><code class="xref cmake cmake-module docutils literal notranslate">FindPython</code></a>, <a class="reference internal" href="../module/FindPython2.html#module:FindPython2" title="FindPython2"><code class="xref cmake cmake-module docutils literal notranslate">FindPython2</code></a>, and <a class="reference internal" href="../module/FindPython3.html#module:FindPython3" title="FindPython3"><code class="xref cmake cmake-module docutils literal notranslate">FindPython3</code></a>
modules gained support for <code class="docutils literal notranslate">NumPy</code> component.</li>
<li>The <a class="reference internal" href="../module/FindPython2.html#module:FindPython2" title="FindPython2"><code class="xref cmake cmake-module docutils literal notranslate">FindPython2</code></a>, <a class="reference internal" href="../module/FindPython3.html#module:FindPython3" title="FindPython3"><code class="xref cmake cmake-module docutils literal notranslate">FindPython3</code></a>, and <a class="reference internal" href="../module/FindPython.html#module:FindPython" title="FindPython"><code class="xref cmake cmake-module docutils literal notranslate">FindPython</code></a>
modules now support running in script mode by skipping the creation of
imported targets and helper functions.</li>
<li>The <a class="reference internal" href="../module/FindSQLite3.html#module:FindSQLite3" title="FindSQLite3"><code class="xref cmake cmake-module docutils literal notranslate">FindSQLite3</code></a> module was added to find the SQLite v3.x library.</li>
<li>The <a class="reference internal" href="../module/FindX11.html#module:FindX11" title="FindX11"><code class="xref cmake cmake-module docutils literal notranslate">FindX11</code></a> had the following variables renamed in order to match
their library names rather than header names. The old variables are provided
for compatibility:
<blockquote>
<div><ul class="simple">
<li><code class="docutils literal notranslate">X11_Xxf86misc_INCLUDE_PATH</code> instead of <code class="docutils literal notranslate">X11_xf86misc_INCLUDE_PATH</code></li>
<li><code class="docutils literal notranslate">X11_Xxf86misc_LIB</code> instead of <code class="docutils literal notranslate">X11_xf86misc_LIB</code></li>
<li><code class="docutils literal notranslate">X11_Xxf86misc_FOUND</code> instead of <code class="docutils literal notranslate">X11_xf86misc_FOUND</code></li>
<li><code class="docutils literal notranslate">X11_Xxf86vm_INCLUDE_PATH</code> instead of <code class="docutils literal notranslate">X11_xf86vmode_INCLUDE_PATH</code></li>
<li><code class="docutils literal notranslate">X11_Xxf86vm_LIB</code> instead of <code class="docutils literal notranslate">X11_xf86vmode_LIB</code></li>
<li><code class="docutils literal notranslate">X11_Xxf86vm_FOUND</code> instead of <code class="docutils literal notranslate">X11_xf86vmode_FOUND</code></li>
<li><code class="docutils literal notranslate">X11_xkbfile_INCLUDE_PATH</code> instead of <code class="docutils literal notranslate">X11_Xkbfile_INCLUDE_PATH</code></li>
<li><code class="docutils literal notranslate">X11_xkbfile_LIB</code> instead of <code class="docutils literal notranslate">X11_Xkbfile_LIB</code></li>
<li><code class="docutils literal notranslate">X11_xkbfile_FOUND</code> instead of <code class="docutils literal notranslate">X11_Xkbfile_FOUND</code></li>
<li><code class="docutils literal notranslate">X11_Xtst_INCLUDE_PATH</code> instead of <code class="docutils literal notranslate">X11_XTest_INCLUDE_PATH</code></li>
<li><code class="docutils literal notranslate">X11_Xtst_LIB</code> instead of <code class="docutils literal notranslate">X11_XTest_LIB</code></li>
<li><code class="docutils literal notranslate">X11_Xtst_FOUND</code> instead of <code class="docutils literal notranslate">X11_XTest_FOUND</code></li>
<li><code class="docutils literal notranslate">X11_Xss_INCLUDE_PATH</code> instead of <code class="docutils literal notranslate">X11_Xscreensaver_INCLUDE_PATH</code></li>
<li><code class="docutils literal notranslate">X11_Xss_LIB</code> instead of <code class="docutils literal notranslate">X11_Xscreensaver_LIB</code></li>
<li><code class="docutils literal notranslate">X11_Xss_FOUND</code> instead of <code class="docutils literal notranslate">X11_Xscreensaver_FOUND</code></li>
</ul>
</div></blockquote>
The following variables are deprecated completely since they were
essentially duplicates:
<blockquote>
<div><ul class="simple">
<li><code class="docutils literal notranslate">X11_Xinput_INCLUDE_PATH</code> (use <code class="docutils literal notranslate">X11_Xi_INCLUDE_PATH</code>)</li>
<li><code class="docutils literal notranslate">X11_Xinput_LIB</code> (use <code class="docutils literal notranslate">X11_Xi_LIB</code>)</li>
<li><code class="docutils literal notranslate">X11_Xinput_FOUND</code> (use <code class="docutils literal notranslate">X11_Xi_FOUND</code>)</li>
</ul>
</div></blockquote>
</li>
<li>The <a class="reference internal" href="../module/FindX11.html#module:FindX11" title="FindX11"><code class="xref cmake cmake-module docutils literal notranslate">FindX11</code></a> now provides <code class="docutils literal notranslate">X11_Xext_INCLUDE_PATH</code>.</li>
<li>The <a class="reference internal" href="../module/FindX11.html#module:FindX11" title="FindX11"><code class="xref cmake cmake-module docutils literal notranslate">FindX11</code></a> now provides imported targets.</li>
<li>The <a class="reference internal" href="../module/UseSWIG.html#module:UseSWIG" title="UseSWIG"><code class="xref cmake cmake-module docutils literal notranslate">UseSWIG</code></a> module learned to pass <code class="docutils literal notranslate">-module &lt;module_name&gt;</code> to
the <code class="docutils literal notranslate">SWIG</code> compiler if the file property <code class="docutils literal notranslate">SWIG_MODULE_NAME</code> is defined.
See policy <a class="reference internal" href="../policy/CMP0086.html#policy:CMP0086" title="CMP0086"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0086</code></a>.</li>
<li>The <a class="reference internal" href="../module/UseSWIG.html#module:UseSWIG" title="UseSWIG"><code class="xref cmake cmake-module docutils literal notranslate">UseSWIG</code></a> module gained an option to specify
<code class="docutils literal notranslate">SWIG</code> source file extensions.</li>
</ul>
</section>
<section id="generator-expressions">
<h3><a class="toc-backref" href="#id17" role="doc-backlink">Generator Expressions</a><a class="headerlink" href="#generator-expressions" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>The <code class="docutils literal notranslate">$&lt;Fortran_COMPILER_ID:...&gt;</code> and <code class="docutils literal notranslate">$&lt;Fortran_COMPILER_VERSION:...&gt;</code>
<a class="reference internal" href="../manual/cmake-generator-expressions.7.html#manual:cmake-generator-expressions(7)" title="cmake-generator-expressions(7)"><code class="xref cmake cmake-manual docutils literal notranslate">generator expressions</code></a> were added.</li>
<li>The <code class="docutils literal notranslate">$&lt;IN_LIST:...&gt;</code> generator expression now correctly handles an
empty argument. See <a class="reference internal" href="../policy/CMP0085.html#policy:CMP0085" title="CMP0085"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0085</code></a> for details.</li>
</ul>
</section>
<section id="autogen">
<h3><a class="toc-backref" href="#id18" role="doc-backlink">Autogen</a><a class="headerlink" href="#autogen" title="Permalink to this heading">¶</a></h3>
<ul>
<li>The <a class="reference internal" href="../prop_tgt/AUTOMOC_EXECUTABLE.html#prop_tgt:AUTOMOC_EXECUTABLE" title="AUTOMOC_EXECUTABLE"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOMOC_EXECUTABLE</code></a>, <a class="reference internal" href="../prop_tgt/AUTORCC_EXECUTABLE.html#prop_tgt:AUTORCC_EXECUTABLE" title="AUTORCC_EXECUTABLE"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTORCC_EXECUTABLE</code></a>, and
<a class="reference internal" href="../prop_tgt/AUTOUIC_EXECUTABLE.html#prop_tgt:AUTOUIC_EXECUTABLE" title="AUTOUIC_EXECUTABLE"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOUIC_EXECUTABLE</code></a> target properties were added. They all
take a path to an executable and force automoc/autorcc/autouic to use
this executable.
Setting these will also prevent the configure time testing for these
executables. This is mainly useful when you build these tools yourself.
</li>
<li>The new variables <a class="reference internal" href="../variable/CMAKE_GLOBAL_AUTOGEN_TARGET.html#variable:CMAKE_GLOBAL_AUTOGEN_TARGET" title="CMAKE_GLOBAL_AUTOGEN_TARGET"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_GLOBAL_AUTOGEN_TARGET</code></a>,
<a class="reference internal" href="../variable/CMAKE_GLOBAL_AUTOGEN_TARGET_NAME.html#variable:CMAKE_GLOBAL_AUTOGEN_TARGET_NAME" title="CMAKE_GLOBAL_AUTOGEN_TARGET_NAME"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_GLOBAL_AUTOGEN_TARGET_NAME</code></a>,
<a class="reference internal" href="../variable/CMAKE_GLOBAL_AUTORCC_TARGET.html#variable:CMAKE_GLOBAL_AUTORCC_TARGET" title="CMAKE_GLOBAL_AUTORCC_TARGET"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_GLOBAL_AUTORCC_TARGET</code></a> and
<a class="reference internal" href="../variable/CMAKE_GLOBAL_AUTORCC_TARGET_NAME.html#variable:CMAKE_GLOBAL_AUTORCC_TARGET_NAME" title="CMAKE_GLOBAL_AUTORCC_TARGET_NAME"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_GLOBAL_AUTORCC_TARGET_NAME</code></a> control the generation
of global <code class="docutils literal notranslate">autogen</code> and <code class="docutils literal notranslate">autorcc</code> targets.</li>
<li>A new <a class="reference internal" href="../variable/CMAKE_AUTOGEN_ORIGIN_DEPENDS.html#variable:CMAKE_AUTOGEN_ORIGIN_DEPENDS" title="CMAKE_AUTOGEN_ORIGIN_DEPENDS"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_AUTOGEN_ORIGIN_DEPENDS</code></a> variable and
<a class="reference internal" href="../prop_tgt/AUTOGEN_ORIGIN_DEPENDS.html#prop_tgt:AUTOGEN_ORIGIN_DEPENDS" title="AUTOGEN_ORIGIN_DEPENDS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">AUTOGEN_ORIGIN_DEPENDS</code></a> target property may be set to enable or
disable forwarding of the origin target dependencies to the corresponding
<code class="docutils literal notranslate">_autogen</code> target.</li>
</ul>
</section>
<section id="ctest">
<h3><a class="toc-backref" href="#id19" role="doc-backlink">CTest</a><a class="headerlink" href="#ctest" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li><a class="reference internal" href="../manual/ctest.1.html#manual:ctest(1)" title="ctest(1)"><code class="xref cmake cmake-manual docutils literal notranslate">ctest(1)</code></a> gained a <code class="docutils literal notranslate">--show-only=json-v1</code> option to show the
list of tests in a machine-readable JSON format.
See the <a class="reference internal" href="../manual/ctest.1.html#show-as-json-object-model">Show as JSON Object Model</a> section of the manual.</li>
<li>The <a class="reference internal" href="../command/ctest_submit.html#command:ctest_submit" title="ctest_submit"><code class="xref cmake cmake-command docutils literal notranslate">ctest_submit()</code></a> command learned a new <code class="docutils literal notranslate">Done</code> part that can be used
to inform CDash that a build is complete and that no more parts will be uploaded.</li>
<li>CTest learned to accept the dashboard server submission URL from a single
variable. See the <code class="docutils literal notranslate">SubmitURL</code> setting in <a class="reference internal" href="../manual/ctest.1.html#manual:ctest(1)" title="ctest(1)"><code class="xref cmake cmake-manual docutils literal notranslate">ctest(1)</code></a>,
the <a class="reference internal" href="../variable/CTEST_SUBMIT_URL.html#variable:CTEST_SUBMIT_URL" title="CTEST_SUBMIT_URL"><code class="xref cmake cmake-variable docutils literal notranslate">CTEST_SUBMIT_URL</code></a> variable, and the <code class="docutils literal notranslate">SUBMIT_URL</code>
argument of the <a class="reference internal" href="../command/ctest_submit.html#command:ctest_submit" title="ctest_submit"><code class="xref cmake cmake-command docutils literal notranslate">ctest_submit()</code></a> command.</li>
</ul>
</section>
</section>
<section id="deprecated-and-removed-features">
<h2><a class="toc-backref" href="#id20" role="doc-backlink">Deprecated and Removed Features</a><a class="headerlink" href="#deprecated-and-removed-features" title="Permalink to this heading">¶</a></h2>
<ul class="simple">
<li>An explicit deprecation diagnostic was added for policies <code class="docutils literal notranslate">CMP0064</code>
and <code class="docutils literal notranslate">CMP0065</code> (<code class="docutils literal notranslate">CMP0063</code> and below were already deprecated).
The <a class="reference internal" href="../manual/cmake-policies.7.html#manual:cmake-policies(7)" title="cmake-policies(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-policies(7)</code></a> manual explains that the OLD behaviors
of all policies are deprecated and that projects should port to the
NEW behaviors.</li>
<li>The <a class="reference internal" href="../generator/Xcode.html#generator:Xcode" title="Xcode"><code class="xref cmake cmake-generator docutils literal notranslate">Xcode</code></a> generator deprecated support for Xcode
versions prior to Xcode 5. Support for those will be dropped in a
future version of CMake.</li>
<li>The <a class="reference internal" href="../module/FindQt.html#module:FindQt" title="FindQt"><code class="xref cmake cmake-module docutils literal notranslate">FindQt</code></a> module is no longer used by the <a class="reference internal" href="../command/find_package.html#command:find_package" title="find_package"><code class="xref cmake cmake-command docutils literal notranslate">find_package()</code></a>
command as a find module. This allows the Qt Project upstream to optionally
provide its own <code class="docutils literal notranslate">QtConfig.cmake</code> package configuration file and have
applications use it via <code class="docutils literal notranslate">find_package(Qt)</code> rather than
<code class="docutils literal notranslate">find_package(Qt CONFIG)</code>. See policy <a class="reference internal" href="../policy/CMP0084.html#policy:CMP0084" title="CMP0084"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0084</code></a>.</li>
<li>Support for running CMake on Windows XP and Windows Vista has been dropped.
The precompiled Windows binaries provided on <code class="docutils literal notranslate">cmake.org</code> now require
Windows 7 or higher.</li>
<li>CTest no longer supports submissions via <code class="docutils literal notranslate">ftp</code>, <code class="docutils literal notranslate">scp</code>, <code class="docutils literal notranslate">cp</code>, and
<code class="docutils literal notranslate">xmlrpc</code>. CDash is the only maintained testing dashboard for CTest,
and it only supports submissions over <code class="docutils literal notranslate">http</code> and <code class="docutils literal notranslate">https</code>.</li>
</ul>
</section>
<section id="other-changes">
<h2><a class="toc-backref" href="#id21" role="doc-backlink">Other Changes</a><a class="headerlink" href="#other-changes" title="Permalink to this heading">¶</a></h2>
<ul class="simple">
<li>Object library linking has been fixed to propagate private link libraries
of object libraries to consuming targets.</li>
<li>Install rules under <a class="reference internal" href="../command/add_subdirectory.html#command:add_subdirectory" title="add_subdirectory"><code class="xref cmake cmake-command docutils literal notranslate">add_subdirectory()</code></a> now interleave with those in
the calling directory. See policy <a class="reference internal" href="../policy/CMP0082.html#policy:CMP0082" title="CMP0082"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0082</code></a> for details.</li>
<li>CMake now imposes a maximum recursion limit to prevent a stack overflow on
scripts that recurse infinitely. The limit can be adjusted at runtime with
<a class="reference internal" href="../variable/CMAKE_MAXIMUM_RECURSION_DEPTH.html#variable:CMAKE_MAXIMUM_RECURSION_DEPTH" title="CMAKE_MAXIMUM_RECURSION_DEPTH"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_MAXIMUM_RECURSION_DEPTH</code></a>.</li>
<li>When using cppcheck via the <a class="reference internal" href="../variable/CMAKE_LANG_CPPCHECK.html#variable:CMAKE_&lt;LANG&gt;_CPPCHECK" title="CMAKE_&lt;LANG&gt;_CPPCHECK"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_CPPCHECK</code></a> variable
or <a class="reference internal" href="../prop_tgt/LANG_CPPCHECK.html#prop_tgt:&lt;LANG&gt;_CPPCHECK" title="&lt;LANG&gt;_CPPCHECK"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">&lt;LANG&gt;_CPPCHECK</code></a> property, the build will now fail if
<code class="docutils literal notranslate">cppcheck</code> returns non-zero as configured by its command-line options.</li>
<li>Required link options to manage Position Independent Executable are now
added when <a class="reference internal" href="../prop_tgt/POSITION_INDEPENDENT_CODE.html#prop_tgt:POSITION_INDEPENDENT_CODE" title="POSITION_INDEPENDENT_CODE"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">POSITION_INDEPENDENT_CODE</code></a> is set. The project is
responsible for using the <a class="reference internal" href="../module/CheckPIESupported.html#module:CheckPIESupported" title="CheckPIESupported"><code class="xref cmake cmake-module docutils literal notranslate">CheckPIESupported</code></a> module to check for
<code class="docutils literal notranslate">PIE</code> support to ensure that the <a class="reference internal" href="../prop_tgt/POSITION_INDEPENDENT_CODE.html#prop_tgt:POSITION_INDEPENDENT_CODE" title="POSITION_INDEPENDENT_CODE"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">POSITION_INDEPENDENT_CODE</code></a>
target property will be honored at link time for executables. This behavior
is controlled by policy <a class="reference internal" href="../policy/CMP0083.html#policy:CMP0083" title="CMP0083"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0083</code></a>.</li>
<li><a class="reference internal" href="../manual/cmake-generators.7.html#visual-studio-generators">Visual Studio Generators</a> for VS 2010 and above learned
to support the <code class="docutils literal notranslate">VS_DEBUGGER_*</code> properties on targets created
via <a class="reference internal" href="../command/add_custom_target.html#command:add_custom_target" title="add_custom_target"><code class="xref cmake cmake-command docutils literal notranslate">add_custom_target()</code></a>.</li>
<li>The <a class="reference internal" href="../module/CPack.html#module:CPack" title="CPack"><code class="xref cmake cmake-module docutils literal notranslate">CPack</code></a> module no longer defaults to the <code class="docutils literal notranslate">paxr</code> value in the
<a class="reference internal" href="../cpack_gen/deb.html#variable:CPACK_DEBIAN_ARCHIVE_TYPE" title="CPACK_DEBIAN_ARCHIVE_TYPE"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_ARCHIVE_TYPE</code></a> variable, because <code class="docutils literal notranslate">dpkg</code> has
never supported the PAX tar format. The <code class="docutils literal notranslate">paxr</code> value will be mapped
to <code class="docutils literal notranslate">gnutar</code> and a deprecation message emitted.</li>
<li>CMake no longer issues a warning if a target listed in an
<a class="reference internal" href="../command/install.html#command:install" title="install"><code class="xref cmake cmake-command docutils literal notranslate">install(TARGETS)</code></a> command has its <a class="reference internal" href="../prop_tgt/EXCLUDE_FROM_ALL.html#prop_tgt:EXCLUDE_FROM_ALL" title="EXCLUDE_FROM_ALL"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">EXCLUDE_FROM_ALL</code></a>
property set to true.</li>
</ul>
</section>
<section id="updates">
<h2><a class="toc-backref" href="#id22" role="doc-backlink">Updates</a><a class="headerlink" href="#updates" title="Permalink to this heading">¶</a></h2>
Changes made since CMake 3.14.0 include the following.
<section id="id1">
<h3><a class="toc-backref" href="#id23" role="doc-backlink">3.14.1</a><a class="headerlink" href="#id1" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>The <a class="reference internal" href="../module/FindFontconfig.html#module:FindFontconfig" title="FindFontconfig"><code class="xref cmake cmake-module docutils literal notranslate">FindFontconfig</code></a> module added by 3.14.0 accidentally
used uppercase <code class="docutils literal notranslate">FONTCONFIG_*</code> variable names that do not match
our conventions. 3.14.1 revises the module to use <code class="docutils literal notranslate">Fontconfig_*</code>
variable names. This is incompatible with 3.14.0 but since the
module is new in the 3.14 series usage should not yet be widespread.</li>
</ul>
</section>
<section id="id2">
<h3><a class="toc-backref" href="#id24" role="doc-backlink">3.14.3</a><a class="headerlink" href="#id2" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>The <a class="reference internal" href="../variable/CMAKE_VS_PLATFORM_NAME_DEFAULT.html#variable:CMAKE_VS_PLATFORM_NAME_DEFAULT" title="CMAKE_VS_PLATFORM_NAME_DEFAULT"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_VS_PLATFORM_NAME_DEFAULT</code></a> variable was added
to help toolchain files work with the <a class="reference internal" href="../generator/Visual%20Studio%2016%202019.html#generator:Visual Studio 16 2019" title="Visual Studio 16 2019"><code class="xref cmake cmake-generator docutils literal notranslate">Visual Studio 16 2019</code></a>
generator where the default platform now depends on the host platform.</li>
</ul>
</section>
<section id="id3">
<h3><a class="toc-backref" href="#id25" role="doc-backlink">3.14.4</a><a class="headerlink" href="#id3" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>In CMake 3.14.0 through 3.14.3, calling <a class="reference internal" href="../command/target_link_libraries.html#command:target_link_libraries" title="target_link_libraries"><code class="xref cmake cmake-command docutils literal notranslate">target_link_libraries()</code></a>
to add <code class="docutils literal notranslate">PRIVATE</code> dependencies to a static library created in another
directory (under policy <a class="reference internal" href="../policy/CMP0079.html#policy:CMP0079" title="CMP0079"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0079</code></a> <code class="docutils literal notranslate">NEW</code> behavior) would
incorrectly propagate usage requirements of those dependencies to
dependents that link the static library. This has been fixed.
The bug also existed in 3.13.0 through 3.13.4 and is fixed in 3.13.5.</li>
</ul>
</section>
<section id="id4">
<h3><a class="toc-backref" href="#id26" role="doc-backlink">3.14.5</a><a class="headerlink" href="#id4" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>Entries of the <code class="docutils literal notranslate">CPATH</code> environment variable are no longer excluded
from explicit use via <a class="reference internal" href="../command/include_directories.html#command:include_directories" title="include_directories"><code class="xref cmake cmake-command docutils literal notranslate">include_directories()</code></a> and
<a class="reference internal" href="../command/target_include_directories.html#command:target_include_directories" title="target_include_directories"><code class="xref cmake cmake-command docutils literal notranslate">target_include_directories()</code></a> as they were in CMake 3.14.0
through 3.14.4.</li>
</ul>
</section>
<section id="id5">
<h3><a class="toc-backref" href="#id27" role="doc-backlink">3.14.6</a><a class="headerlink" href="#id5" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>In CMake 3.14.0 through 3.14.5, the <a class="reference internal" href="../module/FindBISON.html#module:FindBISON" title="FindBISON"><code class="xref cmake cmake-module docutils literal notranslate">FindBISON</code></a> module
policy <a class="reference internal" href="../policy/CMP0088.html#policy:CMP0088" title="CMP0088"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0088</code></a> <code class="docutils literal notranslate">NEW</code> behavior accidentally interpreted
a relative path to the <code class="docutils literal notranslate">.y</code> input as relative to the build tree
directory instead of the source tree directory. This has been fixed.</li>
</ul>
</section>
<section id="id6">
<h3><a class="toc-backref" href="#id28" role="doc-backlink">3.14.7</a><a class="headerlink" href="#id6" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>In CMake 3.14.0 through 3.14.6, the <a class="reference internal" href="../prop_dir/EXCLUDE_FROM_ALL.html#prop_dir:EXCLUDE_FROM_ALL" title="EXCLUDE_FROM_ALL"><code class="xref cmake cmake-prop_dir docutils literal notranslate">EXCLUDE_FROM_ALL</code></a>
directory property was regressed from pre-3.14 behavior and caused
targets within the directory to be excluded even from its own &quot;all&quot;.
This has been fixed.</li>
</ul>
</section>
</section>
</section>

<div class="clearer"></div>
 </div>
 </div>
 </div>
 <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 <div class="sphinxsidebarwrapper">
 <div>
 <h3><a href="../index.html">Table of Contents</a></h3>
 <ul>
<li><a class="reference internal" href="#">CMake 3.14 Release Notes</a><ul>
<li><a class="reference internal" href="#new-features">New Features</a><ul>
<li><a class="reference internal" href="#generators">Generators</a></li>
<li><a class="reference internal" href="#file-based-api">File-Based API</a></li>
<li><a class="reference internal" href="#platforms">Platforms</a></li>
<li><a class="reference internal" href="#command-line">Command-Line</a></li>
<li><a class="reference internal" href="#commands">Commands</a></li>
<li><a class="reference internal" href="#variables">Variables</a></li>
<li><a class="reference internal" href="#properties">Properties</a></li>
<li><a class="reference internal" href="#modules">Modules</a></li>
<li><a class="reference internal" href="#generator-expressions">Generator Expressions</a></li>
<li><a class="reference internal" href="#autogen">Autogen</a></li>
<li><a class="reference internal" href="#ctest">CTest</a></li>
</ul>
</li>
<li><a class="reference internal" href="#deprecated-and-removed-features">Deprecated and Removed Features</a></li>
<li><a class="reference internal" href="#other-changes">Other Changes</a></li>
<li><a class="reference internal" href="#updates">Updates</a><ul>
<li><a class="reference internal" href="#id1">3.14.1</a></li>
<li><a class="reference internal" href="#id2">3.14.3</a></li>
<li><a class="reference internal" href="#id3">3.14.4</a></li>
<li><a class="reference internal" href="#id4">3.14.5</a></li>
<li><a class="reference internal" href="#id5">3.14.6</a></li>
<li><a class="reference internal" href="#id6">3.14.7</a></li>
</ul>
</li>
</ul>
</li>
</ul>

</div>
 <div>
 <h4>Previous topic</h4>
 <a href="3.15.html"
 title="previous chapter">CMake 3.15 Release Notes</a>
 </div>
 <div>
 <h4>Next topic</h4>
 <a href="3.13.html"
 title="next chapter">CMake 3.13 Release Notes</a>
 </div>
 <div role="note" aria-label="source link">
 <h3>This Page</h3>
 <ul class="this-page-menu">
 <li><a href="../_sources/release/3.14.rst.txt"
 rel="nofollow">Show Source</a></li>
 </ul>
 </div>
<div id="searchbox" style="display: none" role="search">
 <h3 id="searchlabel">Quick search</h3>
 <div class="searchformwrapper">
 <form class="search" action="../search.html" method="get">
 <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
 <input type="submit" value="Go" />
 </form>
 </div>
</div>
<script>document.getElementById('searchbox').style.display = "block"</script>
 </div>
 </div>
 <div class="clearer"></div>
 </div>
 <div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 >index</a></li>
 <li class="right" >
 <a href="3.13.html" title="CMake 3.13 Release Notes"
 >next</a> |</li>
 <li class="right" >
 <a href="3.15.html" title="CMake 3.15 Release Notes"
 >previous</a> |</li>
 <li>
 <img src="../_static/cmake-logo-16.png" alt=""
 style="vertical-align: middle; margin-top: -2px" />
 </li>
 <li>
 <a href="https://cmake.org/">CMake</a> &#187;
 </li>
 <li>
 <a href="../index.html">3.26.3 Documentation</a> &#187;
 </li>

<li class="nav-item nav-item-1"><a href="index.html" >CMake Release Notes</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">CMake 3.14 Release Notes</a></li> 
 </ul>
 </div>

<div class="footer" role="contentinfo">
 &#169; Copyright 2000-2023 Kitware, Inc. and Contributors.
 Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 5.0.2.
 </div>
 </body>
</html>