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.1.html

<!DOCTYPE html>

<title>CMake 3.1 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.0.html" title="CMake 3.0 Release Notes"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="3.2.html" title="CMake 3.2 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.1 Release Notes</a></li> 
 </ul>
 </div>

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="cmake-3-1-release-notes">
<h1><a class="toc-backref" href="#id1" role="doc-backlink">CMake 3.1 Release Notes</a><a class="headerlink" href="#cmake-3-1-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-1-release-notes" id="id1">CMake 3.1 Release Notes</a>
<ul>
<li><a class="reference internal" href="#documentation-changes" id="id2">Documentation Changes</a></li>
<li><a class="reference internal" href="#new-features" id="id3">New Features</a>
<ul>
<li><a class="reference internal" href="#generators" id="id4">Generators</a>
<ul>
<li><a class="reference internal" href="#windows-phone-and-windows-store" id="id5">Windows Phone and Windows Store</a></li>
<li><a class="reference internal" href="#nvidia-nsight-tegra" id="id6">NVIDIA Nsight Tegra</a></li>
</ul>
</li>
<li><a class="reference internal" href="#syntax" id="id7">Syntax</a></li>
<li><a class="reference internal" href="#commands" id="id8">Commands</a></li>
<li><a class="reference internal" href="#variables" id="id9">Variables</a></li>
<li><a class="reference internal" href="#properties" id="id10">Properties</a></li>
<li><a class="reference internal" href="#modules" id="id11">Modules</a></li>
<li><a class="reference internal" href="#generator-expressions" id="id12">Generator Expressions</a></li>
<li><a class="reference internal" href="#ctest" id="id13">CTest</a></li>
<li><a class="reference internal" href="#cpack" id="id14">CPack</a></li>
<li><a class="reference internal" href="#other" id="id15">Other</a></li>
</ul>
</li>
<li><a class="reference internal" href="#new-diagnostics" id="id16">New Diagnostics</a></li>
<li><a class="reference internal" href="#deprecated-and-removed-features" id="id17">Deprecated and Removed Features</a></li>
<li><a class="reference internal" href="#other-changes" id="id18">Other Changes</a></li>
</ul>
</li>
</ul>
</nav>
Changes made since CMake 3.0 include the following.
<section id="documentation-changes">
<h2><a class="toc-backref" href="#id2" role="doc-backlink">Documentation Changes</a><a class="headerlink" href="#documentation-changes" title="Permalink to this heading">¶</a></h2>
<ul class="simple">
<li>A new <a class="reference internal" href="../manual/cmake-compile-features.7.html#manual:cmake-compile-features(7)" title="cmake-compile-features(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-compile-features(7)</code></a> manual was added.</li>
</ul>
</section>
<section id="new-features">
<h2><a class="toc-backref" href="#id3" 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="#id4" role="doc-backlink">Generators</a><a class="headerlink" href="#generators" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>The <a class="reference internal" href="../generator/Visual%20Studio%2014%202015.html#generator:Visual Studio 14 2015" title="Visual Studio 14 2015"><code class="xref cmake cmake-generator docutils literal notranslate">Visual Studio 14 2015</code></a> generator was added.</li>
</ul>
<section id="windows-phone-and-windows-store">
<h4><a class="toc-backref" href="#id5" role="doc-backlink">Windows Phone and Windows Store</a><a class="headerlink" href="#windows-phone-and-windows-store" title="Permalink to this heading">¶</a></h4>
<ul class="simple">
<li>Generators for Visual Studio 11 (2012) and above learned to generate
projects for Windows Phone and Windows Store. One may set the
<a class="reference internal" href="../variable/CMAKE_SYSTEM_NAME.html#variable:CMAKE_SYSTEM_NAME" title="CMAKE_SYSTEM_NAME"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_NAME</code></a> variable to <code class="docutils literal notranslate">WindowsPhone</code>
or <code class="docutils literal notranslate">WindowsStore</code> on 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> command-line
or in a <a class="reference internal" href="../variable/CMAKE_TOOLCHAIN_FILE.html#variable:CMAKE_TOOLCHAIN_FILE" title="CMAKE_TOOLCHAIN_FILE"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_TOOLCHAIN_FILE</code></a> to activate these platforms.
Also set <a class="reference internal" href="../variable/CMAKE_SYSTEM_VERSION.html#variable:CMAKE_SYSTEM_VERSION" title="CMAKE_SYSTEM_VERSION"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_VERSION</code></a> to <code class="docutils literal notranslate">8.0</code> or <code class="docutils literal notranslate">8.1</code> to
specify the version of Windows to be targeted.</li>
</ul>
</section>
<section id="nvidia-nsight-tegra">
<h4><a class="toc-backref" href="#id6" role="doc-backlink">NVIDIA Nsight Tegra</a><a class="headerlink" href="#nvidia-nsight-tegra" title="Permalink to this heading">¶</a></h4>
<ul class="simple">
<li>Generators for Visual Studio 10 (2010) and above learned to generate
projects for NVIDIA Nsight Tegra Visual Studio Edition. One may set
the <a class="reference internal" href="../variable/CMAKE_SYSTEM_NAME.html#variable:CMAKE_SYSTEM_NAME" title="CMAKE_SYSTEM_NAME"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_NAME</code></a> variable to <code class="docutils literal notranslate">Android</code> on 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> command-line or in a <a class="reference internal" href="../variable/CMAKE_TOOLCHAIN_FILE.html#variable:CMAKE_TOOLCHAIN_FILE" title="CMAKE_TOOLCHAIN_FILE"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_TOOLCHAIN_FILE</code></a>
to activate this platform.</li>
</ul>
</section>
</section>
<section id="syntax">
<h3><a class="toc-backref" href="#id7" role="doc-backlink">Syntax</a><a class="headerlink" href="#syntax" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>The <a class="reference internal" href="../manual/cmake-language.7.html#manual:cmake-language(7)" title="cmake-language(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-language(7)</code></a> syntax for <a class="reference internal" href="../manual/cmake-language.7.html#variable-references">Variable References</a> and
<a class="reference internal" href="../manual/cmake-language.7.html#escape-sequences">Escape Sequences</a> was simplified in order to allow a much faster
implementation. See policy <a class="reference internal" href="../policy/CMP0053.html#policy:CMP0053" title="CMP0053"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0053</code></a>.</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 no longer automatically dereferences
variables named in quoted or bracket arguments. See policy
<a class="reference internal" href="../policy/CMP0054.html#policy:CMP0054" title="CMP0054"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0054</code></a>.</li>
</ul>
</section>
<section id="commands">
<h3><a class="toc-backref" href="#id8" 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/add_custom_command.html#command:add_custom_command" title="add_custom_command"><code class="xref cmake cmake-command docutils literal notranslate">add_custom_command()</code></a> command learned to interpret
<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">cmake-generator-expressions(7)</code></a> in arguments to <code class="docutils literal notranslate">DEPENDS</code>.</li>
<li>The <a class="reference internal" href="../command/export.html#command:export" title="export"><code class="xref cmake cmake-command docutils literal notranslate">export(PACKAGE)</code></a> command learned to check the
<a class="reference internal" href="../variable/CMAKE_EXPORT_NO_PACKAGE_REGISTRY.html#variable:CMAKE_EXPORT_NO_PACKAGE_REGISTRY" title="CMAKE_EXPORT_NO_PACKAGE_REGISTRY"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_EXPORT_NO_PACKAGE_REGISTRY</code></a> variable to skip
exporting the package.</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(STRINGS)</code></a> command gained a new <code class="docutils literal notranslate">ENCODING</code>
option to enable extraction of <code class="docutils literal notranslate">UTF-8</code> strings.</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 check the
<a class="reference internal" href="../variable/CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY.html#variable:CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY" title="CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY</code></a> and
<a class="reference internal" href="../variable/CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY.html#variable:CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY" title="CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY</code></a>
variables to skip searching the package registries.</li>
<li>The <a class="reference internal" href="../command/get_property.html#command:get_property" title="get_property"><code class="xref cmake cmake-command docutils literal notranslate">get_property()</code></a> command learned a new <code class="docutils literal notranslate">INSTALL</code> scope
for properties.</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></a> command learned a <code class="docutils literal notranslate">MESSAGE_NEVER</code> option
to avoid output during installation.</li>
<li>The <a class="reference internal" href="../command/set_property.html#command:set_property" title="set_property"><code class="xref cmake cmake-command docutils literal notranslate">set_property()</code></a> command learned a new <code class="docutils literal notranslate">INSTALL</code> scope
for properties.</li>
<li>The <a class="reference internal" href="../command/string.html#command:string" title="string"><code class="xref cmake cmake-command docutils literal notranslate">string()</code></a> command learned a new <code class="docutils literal notranslate">GENEX_STRIP</code> subcommand
which removes
<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 expression</code></a>.</li>
<li>The <a class="reference internal" href="../command/string.html#command:string" title="string"><code class="xref cmake cmake-command docutils literal notranslate">string()</code></a> command learned a new <code class="docutils literal notranslate">UUID</code> subcommand
to generate a universally unique identifier.</li>
<li>New <a class="reference internal" href="../command/target_compile_features.html#command:target_compile_features" title="target_compile_features"><code class="xref cmake cmake-command docutils literal notranslate">target_compile_features()</code></a> command allows populating the
<a class="reference internal" href="../prop_tgt/COMPILE_FEATURES.html#prop_tgt:COMPILE_FEATURES" title="COMPILE_FEATURES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">COMPILE_FEATURES</code></a> target property, just like any other
build variable.</li>
<li>The <a class="reference internal" href="../command/target_sources.html#command:target_sources" title="target_sources"><code class="xref cmake cmake-command docutils literal notranslate">target_sources()</code></a> command was added to add to the
<a class="reference internal" href="../prop_tgt/SOURCES.html#prop_tgt:SOURCES" title="SOURCES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">SOURCES</code></a> target property.</li>
</ul>
</section>
<section id="variables">
<h3><a class="toc-backref" href="#id9" role="doc-backlink">Variables</a><a class="headerlink" href="#variables" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>The Visual Studio generators for versions 8 (2005) and above
learned to read the target platform name from a new
<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> variable when it is
not specified as part of the generator name. The platform
name may be specified on 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> command line
with the <code class="docutils literal notranslate">-A</code> option, e.g. <code class="docutils literal notranslate">-G &quot;Visual Studio 12 2013&quot; -A x64</code>.</li>
<li>The <a class="reference internal" href="../variable/CMAKE_GENERATOR_TOOLSET.html#variable:CMAKE_GENERATOR_TOOLSET" title="CMAKE_GENERATOR_TOOLSET"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_GENERATOR_TOOLSET</code></a> variable may now be
initialized in a toolchain file specified by the
<a class="reference internal" href="../variable/CMAKE_TOOLCHAIN_FILE.html#variable:CMAKE_TOOLCHAIN_FILE" title="CMAKE_TOOLCHAIN_FILE"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_TOOLCHAIN_FILE</code></a> variable. This is useful
when cross-compiling with the Xcode or Visual Studio
generators.</li>
<li>The <a class="reference internal" href="../variable/CMAKE_INSTALL_MESSAGE.html#variable:CMAKE_INSTALL_MESSAGE" title="CMAKE_INSTALL_MESSAGE"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_INSTALL_MESSAGE</code></a> variable was introduced to
optionally reduce output installation.</li>
</ul>
</section>
<section id="properties">
<h3><a class="toc-backref" href="#id10" role="doc-backlink">Properties</a><a class="headerlink" href="#properties" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>New <a class="reference internal" href="../prop_tgt/CXX_STANDARD.html#prop_tgt:CXX_STANDARD" title="CXX_STANDARD"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">CXX_STANDARD</code></a> and <a class="reference internal" href="../prop_tgt/CXX_EXTENSIONS.html#prop_tgt:CXX_EXTENSIONS" title="CXX_EXTENSIONS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">CXX_EXTENSIONS</code></a> target
properties may specify values which CMake uses to compute required
compile options such as <code class="docutils literal notranslate">-std=c++11</code> or <code class="docutils literal notranslate">-std=gnu++11</code>. The
<a class="reference internal" href="../variable/CMAKE_CXX_STANDARD.html#variable:CMAKE_CXX_STANDARD" title="CMAKE_CXX_STANDARD"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_CXX_STANDARD</code></a> and <a class="reference internal" href="../variable/CMAKE_CXX_EXTENSIONS.html#variable:CMAKE_CXX_EXTENSIONS" title="CMAKE_CXX_EXTENSIONS"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_CXX_EXTENSIONS</code></a>
variables may be set to initialize the target properties.</li>
<li>New <a class="reference internal" href="../prop_tgt/C_STANDARD.html#prop_tgt:C_STANDARD" title="C_STANDARD"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">C_STANDARD</code></a> and <a class="reference internal" href="../prop_tgt/C_EXTENSIONS.html#prop_tgt:C_EXTENSIONS" title="C_EXTENSIONS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">C_EXTENSIONS</code></a> target
properties may specify values which CMake uses to compute required
compile options such as <code class="docutils literal notranslate">-std=c11</code> or <code class="docutils literal notranslate">-std=gnu11</code>. The
<a class="reference internal" href="../variable/CMAKE_C_STANDARD.html#variable:CMAKE_C_STANDARD" title="CMAKE_C_STANDARD"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_C_STANDARD</code></a> and <a class="reference internal" href="../variable/CMAKE_C_EXTENSIONS.html#variable:CMAKE_C_EXTENSIONS" title="CMAKE_C_EXTENSIONS"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_C_EXTENSIONS</code></a>
variables may be set to initialize the target properties.</li>
<li>New <a class="reference internal" href="../prop_tgt/COMPILE_FEATURES.html#prop_tgt:COMPILE_FEATURES" title="COMPILE_FEATURES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">COMPILE_FEATURES</code></a> target property may contain a list
of features required to compile a target. CMake uses this
information to ensure that the compiler in use is capable of building
the target, and to add any necessary compile flags to support language
features.</li>
<li>New <a class="reference internal" href="../prop_tgt/COMPILE_PDB_NAME.html#prop_tgt:COMPILE_PDB_NAME" title="COMPILE_PDB_NAME"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">COMPILE_PDB_NAME</code></a> and
<a class="reference internal" href="../prop_tgt/COMPILE_PDB_OUTPUT_DIRECTORY.html#prop_tgt:COMPILE_PDB_OUTPUT_DIRECTORY" title="COMPILE_PDB_OUTPUT_DIRECTORY"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">COMPILE_PDB_OUTPUT_DIRECTORY</code></a> target properties
were introduced to specify the MSVC compiler program database
file location (<code class="docutils literal notranslate">cl /Fd</code>). This complements the existing
<a class="reference internal" href="../prop_tgt/PDB_NAME.html#prop_tgt:PDB_NAME" title="PDB_NAME"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">PDB_NAME</code></a> and <a class="reference internal" href="../prop_tgt/PDB_OUTPUT_DIRECTORY.html#prop_tgt:PDB_OUTPUT_DIRECTORY" title="PDB_OUTPUT_DIRECTORY"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">PDB_OUTPUT_DIRECTORY</code></a>
target properties that specify the linker program database
file location (<code class="docutils literal notranslate">link /pdb</code>).</li>
<li>The <a class="reference internal" href="../prop_tgt/INTERFACE_LINK_LIBRARIES.html#prop_tgt:INTERFACE_LINK_LIBRARIES" title="INTERFACE_LINK_LIBRARIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_LINK_LIBRARIES</code></a> target property now supports
a <code class="docutils literal notranslate">$&lt;LINK_ONLY:...&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 expression</code></a>.</li>
<li>A new <a class="reference internal" href="../prop_tgt/INTERFACE_SOURCES.html#prop_tgt:INTERFACE_SOURCES" title="INTERFACE_SOURCES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_SOURCES</code></a> target property was introduced. This is
consumed by dependent targets, which compile and link the listed sources.</li>
<li>The <a class="reference internal" href="../prop_tgt/SOURCES.html#prop_tgt:SOURCES" title="SOURCES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">SOURCES</code></a> target property now contains
<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 expression</code></a>
such as <code class="docutils literal notranslate">TARGET_OBJECTS</code> when read at configure time, if
policy <a class="reference internal" href="../policy/CMP0051.html#policy:CMP0051" title="CMP0051"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0051</code></a> is <code class="docutils literal notranslate">NEW</code>.</li>
<li>The <a class="reference internal" href="../prop_tgt/SOURCES.html#prop_tgt:SOURCES" title="SOURCES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">SOURCES</code></a> target property now generally supports
<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 expression</code></a>. The
generator expressions may be used in the <a class="reference internal" href="../command/add_library.html#command:add_library" title="add_library"><code class="xref cmake cmake-command docutils literal notranslate">add_library()</code></a> and
<a class="reference internal" href="../command/add_executable.html#command:add_executable" title="add_executable"><code class="xref cmake cmake-command docutils literal notranslate">add_executable()</code></a> commands.</li>
<li>It is now possible to write and append to the <a class="reference internal" href="../prop_tgt/SOURCES.html#prop_tgt:SOURCES" title="SOURCES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">SOURCES</code></a> target
property. The <a class="reference internal" href="../variable/CMAKE_DEBUG_TARGET_PROPERTIES.html#variable:CMAKE_DEBUG_TARGET_PROPERTIES" title="CMAKE_DEBUG_TARGET_PROPERTIES"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_DEBUG_TARGET_PROPERTIES</code></a> variable may be
used to trace the origin of sources.</li>
<li>A <a class="reference internal" href="../prop_sf/VS_DEPLOYMENT_CONTENT.html#prop_sf:VS_DEPLOYMENT_CONTENT" title="VS_DEPLOYMENT_CONTENT"><code class="xref cmake cmake-prop_sf docutils literal notranslate">VS_DEPLOYMENT_CONTENT</code></a> source file property was added
to tell the Visual Studio generators to mark content for deployment
in Windows Phone and Windows Store projects.</li>
<li>A <a class="reference internal" href="../prop_sf/VS_DEPLOYMENT_LOCATION.html#prop_sf:VS_DEPLOYMENT_LOCATION" title="VS_DEPLOYMENT_LOCATION"><code class="xref cmake cmake-prop_sf docutils literal notranslate">VS_DEPLOYMENT_LOCATION</code></a> source file property was added
to tell the Visual Studio generators the relative location of content
marked for deployment in Windows Phone and Windows Store projects.</li>
<li>The <a class="reference internal" href="../prop_tgt/VS_WINRT_COMPONENT.html#prop_tgt:VS_WINRT_COMPONENT" title="VS_WINRT_COMPONENT"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">VS_WINRT_COMPONENT</code></a> target property was created to
tell Visual Studio generators to compile a shared library as a
Windows Runtime (WinRT) component.</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 learned to check source
file properties <a class="reference internal" href="../prop_sf/XCODE_EXPLICIT_FILE_TYPE.html#prop_sf:XCODE_EXPLICIT_FILE_TYPE" title="XCODE_EXPLICIT_FILE_TYPE"><code class="xref cmake cmake-prop_sf docutils literal notranslate">XCODE_EXPLICIT_FILE_TYPE</code></a> and
<a class="reference internal" href="../prop_sf/XCODE_LAST_KNOWN_FILE_TYPE.html#prop_sf:XCODE_LAST_KNOWN_FILE_TYPE" title="XCODE_LAST_KNOWN_FILE_TYPE"><code class="xref cmake cmake-prop_sf docutils literal notranslate">XCODE_LAST_KNOWN_FILE_TYPE</code></a> for a custom Xcode
file reference type.</li>
</ul>
</section>
<section id="modules">
<h3><a class="toc-backref" href="#id11" role="doc-backlink">Modules</a><a class="headerlink" href="#modules" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>The <a class="reference internal" href="../module/BundleUtilities.html#module:BundleUtilities" title="BundleUtilities"><code class="xref cmake cmake-module docutils literal notranslate">BundleUtilities</code></a> module learned to resolve and replace
<code class="docutils literal notranslate">&#64;rpath</code> placeholders on OS X to correctly bundle applications
using them.</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
<a class="reference internal" href="../module/CMakePackageConfigHelpers.html#command:configure_package_config_file" title="configure_package_config_file"><code class="xref cmake cmake-command docutils literal notranslate">configure_package_config_file()</code></a> command learned a new
<code class="docutils literal notranslate">INSTALL_PREFIX</code> option to generate package configuration files
meant for a prefix other than <a class="reference internal" href="../variable/CMAKE_INSTALL_PREFIX.html#variable:CMAKE_INSTALL_PREFIX" title="CMAKE_INSTALL_PREFIX"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_INSTALL_PREFIX</code></a>.</li>
<li>The <a class="reference internal" href="../module/CheckFortranSourceCompiles.html#module:CheckFortranSourceCompiles" title="CheckFortranSourceCompiles"><code class="xref cmake cmake-module docutils literal notranslate">CheckFortranSourceCompiles</code></a> module was added to
provide a <code class="docutils literal notranslate">CHECK_Fortran_SOURCE_COMPILES</code> macro.</li>
<li>The <a class="reference internal" href="../module/ExternalData.html#module:ExternalData" title="ExternalData"><code class="xref cmake cmake-module docutils literal notranslate">ExternalData</code></a> module learned to tolerate a <code class="docutils literal notranslate">DATA{}</code>
reference to a missing source file with a warning instead of
rejecting it with an error. This helps developers write new
<code class="docutils literal notranslate">DATA{}</code> references to test reference outputs that have not
yet been created.</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 learned to support lzma-compressed
source tarballs with <code class="docutils literal notranslate">.7z</code>, <code class="docutils literal notranslate">.tar.xz</code>, and <code class="docutils literal notranslate">.txz</code> extensions.</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 <code class="docutils literal notranslate">ExternalProject_Add</code> command
learned a new <code class="docutils literal notranslate">BUILD_ALWAYS</code> option to cause the external project
build step to run every time the host project is built.</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 <code class="docutils literal notranslate">ExternalProject_Add</code> command
learned a new <code class="docutils literal notranslate">EXCLUDE_FROM_ALL</code> option to cause the external
project target to have 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 set.</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 <code class="docutils literal notranslate">ExternalProject_Add_Step</code> command
learned a new <code class="docutils literal notranslate">EXCLUDE_FROM_MAIN</code> option to cause the step to not be
a direct dependency of the main external project target.</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 <code class="docutils literal notranslate">ExternalProject_Add</code> command
learned a new <code class="docutils literal notranslate">DOWNLOAD_NO_PROGRESS</code> option to disable progress
output while downloading the source tarball.</li>
<li>The <a class="reference internal" href="../module/FeatureSummary.html#module:FeatureSummary" title="FeatureSummary"><code class="xref cmake cmake-module docutils literal notranslate">FeatureSummary</code></a> module <code class="docutils literal notranslate">feature_summary</code> API
learned to accept multiple values for the <code class="docutils literal notranslate">WHAT</code> option and
combine them appropriately.</li>
<li>The <a class="reference internal" href="../module/FindCUDA.html#module:FindCUDA" title="FindCUDA"><code class="xref cmake cmake-module docutils literal notranslate">FindCUDA</code></a> module learned to support <code class="docutils literal notranslate">fatbin</code> and <code class="docutils literal notranslate">cubin</code>
modules.</li>
<li>The <a class="reference internal" href="../module/FindGTest.html#module:FindGTest" title="FindGTest"><code class="xref cmake cmake-module docutils literal notranslate">FindGTest</code></a> module <code class="docutils literal notranslate">gtest_add_tests</code> macro learned
a new <code class="docutils literal notranslate">AUTO</code> option to automatically read the <a class="reference internal" href="../prop_tgt/SOURCES.html#prop_tgt:SOURCES" title="SOURCES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">SOURCES</code></a>
target property of the test executable and scan the source files
for tests to be added.</li>
<li>The <a class="reference internal" href="../module/FindGLEW.html#module:FindGLEW" title="FindGLEW"><code class="xref cmake cmake-module docutils literal notranslate">FindGLEW</code></a> module now provides imported targets.</li>
<li>The <a class="reference internal" href="../module/FindGLUT.html#module:FindGLUT" title="FindGLUT"><code class="xref cmake cmake-module docutils literal notranslate">FindGLUT</code></a> module now provides imported targets.</li>
<li>The <a class="reference internal" href="../module/FindHg.html#module:FindHg" title="FindHg"><code class="xref cmake cmake-module docutils literal notranslate">FindHg</code></a> module gained a new <code class="docutils literal notranslate">Hg_WC_INFO</code> macro to
help run <code class="docutils literal notranslate">hg</code> to extract information about a Mercurial work copy.</li>
<li>The <a class="reference internal" href="../module/FindOpenCL.html#module:FindOpenCL" title="FindOpenCL"><code class="xref cmake cmake-module docutils literal notranslate">FindOpenCL</code></a> module was introduced.</li>
<li>The <a class="reference internal" href="../module/FindOpenMP.html#module:FindOpenMP" title="FindOpenMP"><code class="xref cmake cmake-module docutils literal notranslate">FindOpenMP</code></a> module learned to support Fortran.</li>
<li>The <a class="reference internal" href="../module/FindPkgConfig.html#module:FindPkgConfig" title="FindPkgConfig"><code class="xref cmake cmake-module docutils literal notranslate">FindPkgConfig</code></a> module learned to use the <code class="docutils literal notranslate">PKG_CONFIG</code>
environment variable value as the <code class="docutils literal notranslate">pkg-config</code> executable, if set.</li>
<li>The <a class="reference internal" href="../module/FindXercesC.html#module:FindXercesC" title="FindXercesC"><code class="xref cmake cmake-module docutils literal notranslate">FindXercesC</code></a> module was introduced.</li>
<li>The <a class="reference internal" href="../module/FindZLIB.html#module:FindZLIB" title="FindZLIB"><code class="xref cmake cmake-module docutils literal notranslate">FindZLIB</code></a> module now provides imported targets.</li>
<li>The <a class="reference internal" href="../module/GenerateExportHeader.html#module:GenerateExportHeader" title="GenerateExportHeader"><code class="xref cmake cmake-module docutils literal notranslate">GenerateExportHeader</code></a> module <code class="docutils literal notranslate">generate_export_header</code>
function learned to allow use with <a class="reference internal" href="../manual/cmake-buildsystem.7.html#object-libraries">Object Libraries</a>.</li>
<li>The <a class="reference internal" href="../module/InstallRequiredSystemLibraries.html#module:InstallRequiredSystemLibraries" title="InstallRequiredSystemLibraries"><code class="xref cmake cmake-module docutils literal notranslate">InstallRequiredSystemLibraries</code></a> module gained a new
<code class="docutils literal notranslate">CMAKE_INSTALL_OPENMP_LIBRARIES</code> option to install MSVC OpenMP
runtime libraries.</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 detect the module name
from <code class="docutils literal notranslate">.i</code> source files if possible to avoid the need to set
the <code class="docutils literal notranslate">SWIG_MODULE_NAME</code> source file property explicitly.</li>
<li>The <a class="reference internal" href="../module/WriteCompilerDetectionHeader.html#module:WriteCompilerDetectionHeader" title="WriteCompilerDetectionHeader"><code class="xref cmake cmake-module docutils literal notranslate">WriteCompilerDetectionHeader</code></a> module was added to allow
creation of a portable header file for compiler optional feature detection.</li>
</ul>
</section>
<section id="generator-expressions">
<h3><a class="toc-backref" href="#id12" role="doc-backlink">Generator Expressions</a><a class="headerlink" href="#generator-expressions" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>New <code class="docutils literal notranslate">COMPILE_FEATURES</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 expression</code></a> allows
setting build properties based on available compiler features.</li>
</ul>
</section>
<section id="ctest">
<h3><a class="toc-backref" href="#id13" role="doc-backlink">CTest</a><a class="headerlink" href="#ctest" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>The <a class="reference internal" href="../command/ctest_coverage.html#command:ctest_coverage" title="ctest_coverage"><code class="xref cmake cmake-command docutils literal notranslate">ctest_coverage()</code></a> command learned to read variable
<code class="docutils literal notranslate">CTEST_COVERAGE_EXTRA_FLAGS</code> to set <code class="docutils literal notranslate">CoverageExtraFlags</code>.</li>
<li>The <a class="reference internal" href="../command/ctest_coverage.html#command:ctest_coverage" title="ctest_coverage"><code class="xref cmake cmake-command docutils literal notranslate">ctest_coverage()</code></a> command learned to support
Intel coverage files with the <code class="docutils literal notranslate">codecov</code> tool.</li>
<li>The <a class="reference internal" href="../command/ctest_memcheck.html#command:ctest_memcheck" title="ctest_memcheck"><code class="xref cmake cmake-command docutils literal notranslate">ctest_memcheck()</code></a> command learned to support sanitizer
modes, including <code class="docutils literal notranslate">AddressSanitizer</code>, <code class="docutils literal notranslate">MemorySanitizer</code>,
<code class="docutils literal notranslate">ThreadSanitizer</code>, and <code class="docutils literal notranslate">UndefinedBehaviorSanitizer</code>.
Options may be set using the new
<a class="reference internal" href="../variable/CTEST_MEMORYCHECK_SANITIZER_OPTIONS.html#variable:CTEST_MEMORYCHECK_SANITIZER_OPTIONS" title="CTEST_MEMORYCHECK_SANITIZER_OPTIONS"><code class="xref cmake cmake-variable docutils literal notranslate">CTEST_MEMORYCHECK_SANITIZER_OPTIONS</code></a> variable.</li>
</ul>
</section>
<section id="cpack">
<h3><a class="toc-backref" href="#id14" role="doc-backlink">CPack</a><a class="headerlink" href="#cpack" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li><a class="reference internal" href="../manual/cpack.1.html#manual:cpack(1)" title="cpack(1)"><code class="xref cmake cmake-manual docutils literal notranslate">cpack(1)</code></a> gained an <code class="docutils literal notranslate">IFW</code> generator to package using
Qt Framework Installer tools. See the <a class="reference internal" href="../cpack_gen/ifw.html#cpack_gen:CPack IFW Generator" title="CPack IFW Generator"><code class="xref cmake cmake-cpack_gen docutils literal notranslate">CPack IFW Generator</code></a>.</li>
<li><a class="reference internal" href="../manual/cpack.1.html#manual:cpack(1)" title="cpack(1)"><code class="xref cmake cmake-manual docutils literal notranslate">cpack(1)</code></a> gained <code class="docutils literal notranslate">7Z</code> and <code class="docutils literal notranslate">TXZ</code> generators supporting
lzma-compressed archives.</li>
<li>The <a class="reference internal" href="../cpack_gen/deb.html#cpack_gen:CPack DEB Generator" title="CPack DEB Generator"><code class="xref cmake cmake-cpack_gen docutils literal notranslate">CPack DEB Generator</code></a> learned a new
<a class="reference internal" href="../cpack_gen/deb.html#variable:CPACK_DEBIAN_COMPRESSION_TYPE" title="CPACK_DEBIAN_COMPRESSION_TYPE"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_COMPRESSION_TYPE</code></a> variable to set the
tarball compression type.</li>
<li>The <a class="reference internal" href="../cpack_gen/wix.html#cpack_gen:CPack WIX Generator" title="CPack WIX Generator"><code class="xref cmake cmake-cpack_gen docutils literal notranslate">CPack WIX Generator</code></a> learned to support
a <a class="reference internal" href="../prop_inst/CPACK_WIX_ACL.html#prop_inst:CPACK_WIX_ACL" title="CPACK_WIX_ACL"><code class="xref cmake cmake-prop_inst docutils literal notranslate">CPACK_WIX_ACL</code></a> installed file property to
specify an Access Control List.</li>
</ul>
</section>
<section id="other">
<h3><a class="toc-backref" href="#id15" role="doc-backlink">Other</a><a class="headerlink" href="#other" 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> <code class="docutils literal notranslate">-E</code> option learned a new <code class="docutils literal notranslate">env</code> command.</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 tar</code> command learned to support
lzma-compressed files.</li>
<li><a class="reference internal" href="../manual/cmake-buildsystem.7.html#object-libraries">Object Libraries</a> may now have extra sources that do not
compile to object files so long as they would not affect linking
of a normal library (e.g. <code class="docutils literal notranslate">.dat</code> is okay but not <code class="docutils literal notranslate">.def</code>).</li>
<li>Visual Studio generators for VS 8 and later learned to support
the <code class="docutils literal notranslate">ASM_MASM</code> language.</li>
<li>The Visual Studio generators learned to treat <code class="docutils literal notranslate">.hlsl</code> source
files as High Level Shading Language sources (using <code class="docutils literal notranslate">FXCompile</code>
in <code class="docutils literal notranslate">.vcxproj</code> files). Source file properties
<a class="reference internal" href="../prop_sf/VS_SHADER_TYPE.html#prop_sf:VS_SHADER_TYPE" title="VS_SHADER_TYPE"><code class="xref cmake cmake-prop_sf docutils literal notranslate">VS_SHADER_TYPE</code></a>, <a class="reference internal" href="../prop_sf/VS_SHADER_MODEL.html#prop_sf:VS_SHADER_MODEL" title="VS_SHADER_MODEL"><code class="xref cmake cmake-prop_sf docutils literal notranslate">VS_SHADER_MODEL</code></a>, and
<a class="reference internal" href="../prop_sf/VS_SHADER_ENTRYPOINT.html#prop_sf:VS_SHADER_ENTRYPOINT" title="VS_SHADER_ENTRYPOINT"><code class="xref cmake cmake-prop_sf docutils literal notranslate">VS_SHADER_ENTRYPOINT</code></a> were added added to specify the
shader type, model, and entry point name.</li>
</ul>
</section>
</section>
<section id="new-diagnostics">
<h2><a class="toc-backref" href="#id16" role="doc-backlink">New Diagnostics</a><a class="headerlink" href="#new-diagnostics" title="Permalink to this heading">¶</a></h2>
<ul class="simple">
<li>Policy <a class="reference internal" href="../policy/CMP0052.html#policy:CMP0052" title="CMP0052"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0052</code></a> introduced to control directories in the
<a class="reference internal" href="../prop_tgt/INTERFACE_INCLUDE_DIRECTORIES.html#prop_tgt:INTERFACE_INCLUDE_DIRECTORIES" title="INTERFACE_INCLUDE_DIRECTORIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_INCLUDE_DIRECTORIES</code></a> of exported targets.</li>
</ul>
</section>
<section id="deprecated-and-removed-features">
<h2><a class="toc-backref" href="#id17" role="doc-backlink">Deprecated and Removed Features</a><a class="headerlink" href="#deprecated-and-removed-features" title="Permalink to this heading">¶</a></h2>
<ul>
<li>In CMake 3.0 the <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> command
accidentally began allowing unquoted arguments to use
<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>
containing a (<code class="docutils literal notranslate">;</code> separated) list within them. For example:
<div class="highlight-none notranslate"><div class="highlight"><pre>set(libs B C)
target_link_libraries(A PUBLIC $&lt;BUILD_INTERFACE:${libs}&gt;)
</pre></div>
</div>
This is equivalent to writing:
<div class="highlight-none notranslate"><div class="highlight"><pre>target_link_libraries(A PUBLIC $&lt;BUILD_INTERFACE:B C&gt;)
</pre></div>
</div>
and was never intended to work. It did not work in CMake 2.8.12.
Such generator expressions should be in quoted arguments:
<div class="highlight-none notranslate"><div class="highlight"><pre>set(libs B C)
target_link_libraries(A PUBLIC &quot;$&lt;BUILD_INTERFACE:${libs}&gt;&quot;)
</pre></div>
</div>
CMake 3.1 again requires the quotes for this to work correctly.
</li>
<li>Prior to CMake 3.1 the Makefile generators did not escape <code class="docutils literal notranslate">#</code>
correctly inside make variable assignments used in generated
makefiles, causing them to be treated as comments. This made
code like:
<div class="highlight-none notranslate"><div class="highlight"><pre>add_compile_options(-Wno-#pragma-messages)
</pre></div>
</div>
not work in Makefile generators, but work in other generators.
Now it is escaped correctly, making the behavior consistent
across generators. However, some projects may have tried to
workaround the original bug with code like:
<div class="highlight-none notranslate"><div class="highlight"><pre>set(CMAKE_C_FLAGS &quot;${CMAKE_C_FLAGS} -Wno-\\#pragma-messages&quot;)
</pre></div>
</div>
This added the needed escape for Makefile generators but also
caused other generators to pass <code class="docutils literal notranslate">-Wno-\#pragma-messages</code> to
the shell, which would work only in POSIX shells.
Unfortunately the escaping fix could not be made in a compatible
way so this platform- and generator-specific workaround no
longer works. Project code may test the <a class="reference internal" href="../variable/CMAKE_VERSION.html#variable:CMAKE_VERSION" title="CMAKE_VERSION"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_VERSION</code></a>
variable value to make the workaround version-specific too.
</li>
<li>Callbacks established by the <a class="reference internal" href="../command/variable_watch.html#command:variable_watch" title="variable_watch"><code class="xref cmake cmake-command docutils literal notranslate">variable_watch()</code></a> command will no
longer receive the <code class="docutils literal notranslate">ALLOWED_UNKNOWN_READ_ACCESS</code> access type when
the undocumented <code class="docutils literal notranslate">CMAKE_ALLOW_UNKNOWN_VARIABLE_READ_ACCESS</code> variable is
set. Uninitialized variable accesses will always be reported as
<code class="docutils literal notranslate">UNKNOWN_READ_ACCESS</code>.</li>
<li>The <a class="reference internal" href="../module/CMakeDetermineVSServicePack.html#module:CMakeDetermineVSServicePack" title="CMakeDetermineVSServicePack"><code class="xref cmake cmake-module docutils literal notranslate">CMakeDetermineVSServicePack</code></a> module now warns that
it is deprecated and should not longer be used. Use the
<a class="reference internal" href="../variable/CMAKE_LANG_COMPILER_VERSION.html#variable:CMAKE_&lt;LANG&gt;_COMPILER_VERSION" title="CMAKE_&lt;LANG&gt;_COMPILER_VERSION"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_COMPILER_VERSION</code></a> variable instead.</li>
<li>The <a class="reference internal" href="../module/FindITK.html#module:FindITK" title="FindITK"><code class="xref cmake cmake-module docutils literal notranslate">FindITK</code></a> module has been removed altogether.
It was a thin-wrapper around <code class="docutils literal notranslate">find_package(ITK ... NO_MODULE)</code>.
This produces much clearer error messages when ITK is not found.</li>
<li>The <a class="reference internal" href="../module/FindVTK.html#module:FindVTK" title="FindVTK"><code class="xref cmake cmake-module docutils literal notranslate">FindVTK</code></a> module has been removed altogether.
It was a thin-wrapper around <code class="docutils literal notranslate">find_package(VTK ... NO_MODULE)</code>.
This produces much clearer error messages when VTK is not found.
The module also provided compatibility support for finding VTK 4.0.
This capability has been dropped.
</li>
</ul>
</section>
<section id="other-changes">
<h2><a class="toc-backref" href="#id18" role="doc-backlink">Other Changes</a><a class="headerlink" href="#other-changes" title="Permalink to this heading">¶</a></h2>
<ul class="simple">
<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> learned to capture output from child
processes started by the <a class="reference internal" href="../command/execute_process.html#command:execute_process" title="execute_process"><code class="xref cmake cmake-command docutils literal notranslate">execute_process()</code></a> command
and display it in the output window.</li>
<li>The <a class="reference internal" href="../manual/cmake-language.7.html#manual:cmake-language(7)" title="cmake-language(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-language(7)</code></a> internal implementation of generator
expression and list expansion parsers have been optimized and shows
non-trivial speedup on large projects.</li>
<li>The Makefile generators learned to use response files with GNU tools
on Windows to pass library directories and names to the linker.</li>
<li>When generating linker command-lines, CMake now avoids repeating
items corresponding to SHARED library targets.</li>
<li>Support for the Open Watcom compiler has been overhauled.
The <a class="reference internal" href="../variable/CMAKE_LANG_COMPILER_ID.html#variable:CMAKE_&lt;LANG&gt;_COMPILER_ID" title="CMAKE_&lt;LANG&gt;_COMPILER_ID"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_COMPILER_ID</code></a> is now <code class="docutils literal notranslate">OpenWatcom</code>,
and the <a class="reference internal" href="../variable/CMAKE_LANG_COMPILER_VERSION.html#variable:CMAKE_&lt;LANG&gt;_COMPILER_VERSION" title="CMAKE_&lt;LANG&gt;_COMPILER_VERSION"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_COMPILER_VERSION</code></a> now uses
the Open Watcom external version numbering. The external
version numbers are lower than the internal version number
by 11.</li>
<li>The <code class="docutils literal notranslate">cmake-mode.el</code> major Emacs editing mode no longer
treats <code class="docutils literal notranslate">_</code> as part of words, making it more consistent
with other major modes.</li>
</ul>
</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.1 Release Notes</a><ul>
<li><a class="reference internal" href="#documentation-changes">Documentation Changes</a></li>
<li><a class="reference internal" href="#new-features">New Features</a><ul>
<li><a class="reference internal" href="#generators">Generators</a><ul>
<li><a class="reference internal" href="#windows-phone-and-windows-store">Windows Phone and Windows Store</a></li>
<li><a class="reference internal" href="#nvidia-nsight-tegra">NVIDIA Nsight Tegra</a></li>
</ul>
</li>
<li><a class="reference internal" href="#syntax">Syntax</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="#ctest">CTest</a></li>
<li><a class="reference internal" href="#cpack">CPack</a></li>
<li><a class="reference internal" href="#other">Other</a></li>
</ul>
</li>
<li><a class="reference internal" href="#new-diagnostics">New Diagnostics</a></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>
</ul>
</li>
</ul>

</div>
 <div>
 <h4>Previous topic</h4>
 <a href="3.2.html"
 title="previous chapter">CMake 3.2 Release Notes</a>
 </div>
 <div>
 <h4>Next topic</h4>
 <a href="3.0.html"
 title="next chapter">CMake 3.0 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.1.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.0.html" title="CMake 3.0 Release Notes"
 >next</a> |</li>
 <li class="right" >
 <a href="3.2.html" title="CMake 3.2 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.1 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>