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

<!DOCTYPE html>

<title>CMake 3.0 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.1.html" title="CMake 3.1 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.0 Release Notes</a></li> 
 </ul>
 </div>

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="cmake-3-0-release-notes">
<h1><a class="toc-backref" href="#id1" role="doc-backlink">CMake 3.0 Release Notes</a><a class="headerlink" href="#cmake-3-0-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-0-release-notes" id="id1">CMake 3.0 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="#syntax" id="id4">Syntax</a></li>
<li><a class="reference internal" href="#generators" id="id5">Generators</a></li>
<li><a class="reference internal" href="#commands" id="id6">Commands</a></li>
<li><a class="reference internal" href="#variables" id="id7">Variables</a></li>
<li><a class="reference internal" href="#properties" id="id8">Properties</a></li>
<li><a class="reference internal" href="#modules" id="id9">Modules</a></li>
<li><a class="reference internal" href="#generator-expressions" id="id10">Generator Expressions</a></li>
<li><a class="reference internal" href="#other" id="id11">Other</a></li>
</ul>
</li>
<li><a class="reference internal" href="#new-diagnostics" id="id12">New Diagnostics</a></li>
<li><a class="reference internal" href="#deprecated-and-removed-features" id="id13">Deprecated and Removed Features</a></li>
<li><a class="reference internal" href="#other-changes" id="id14">Other Changes</a></li>
</ul>
</li>
</ul>
</nav>
Changes made since CMake 2.8.12 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>
<li>The CMake documentation has been converted to reStructuredText and
now transforms via Sphinx (<a class="reference external" href="https://www.sphinx-doc.org">https://www.sphinx-doc.org</a>) into man and
html pages. This allows the documentation to be properly indexed
and to contain cross-references.
Conversion from the old internal documentation format was done by
an automatic process so some documents may still contain artifacts.
They will be updated incrementally over time.
A basic reStructuredText processor has been implemented to support
<code class="docutils literal notranslate">cmake --help-command</code> and similar command-line options.
</li>
<li>New manuals were added:
<ul class="simple">
<li><a class="reference internal" href="../manual/cmake-buildsystem.7.html#manual:cmake-buildsystem(7)" title="cmake-buildsystem(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-buildsystem(7)</code></a></li>
<li><a class="reference internal" href="../manual/cmake-commands.7.html#manual:cmake-commands(7)" title="cmake-commands(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-commands(7)</code></a>, replacing <code class="docutils literal notranslate">cmakecommands(1)</code>
and <code class="docutils literal notranslate">cmakecompat(1)</code></li>
<li><a class="reference internal" href="../manual/cmake-developer.7.html#manual:cmake-developer(7)" title="cmake-developer(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-developer(7)</code></a></li>
<li><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></li>
<li><a class="reference internal" href="../manual/cmake-generators.7.html#manual:cmake-generators(7)" title="cmake-generators(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-generators(7)</code></a></li>
<li><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></li>
<li><a class="reference internal" href="../manual/cmake-modules.7.html#manual:cmake-modules(7)" title="cmake-modules(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-modules(7)</code></a>, replacing <code class="docutils literal notranslate">cmakemodules(1)</code></li>
<li><a class="reference internal" href="../manual/cmake-packages.7.html#manual:cmake-packages(7)" title="cmake-packages(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-packages(7)</code></a></li>
<li><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>, replacing <code class="docutils literal notranslate">cmakepolicies(1)</code></li>
<li><a class="reference internal" href="../manual/cmake-properties.7.html#manual:cmake-properties(7)" title="cmake-properties(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-properties(7)</code></a>, replacing <code class="docutils literal notranslate">cmakeprops(1)</code></li>
<li><a class="reference internal" href="../manual/cmake-qt.7.html#manual:cmake-qt(7)" title="cmake-qt(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-qt(7)</code></a></li>
<li><a class="reference internal" href="../manual/cmake-toolchains.7.html#manual:cmake-toolchains(7)" title="cmake-toolchains(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-toolchains(7)</code></a></li>
<li><a class="reference internal" href="../manual/cmake-variables.7.html#manual:cmake-variables(7)" title="cmake-variables(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-variables(7)</code></a>, replacing <code class="docutils literal notranslate">cmakevars(1)</code></li>
</ul>
</li>
<li>Release notes for CMake 3.0.0 and above will now be included with
the html documentation.</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="syntax">
<h3><a class="toc-backref" href="#id4" role="doc-backlink">Syntax</a><a class="headerlink" href="#syntax" title="Permalink to this heading">¶</a></h3>
<ul>
<li>The CMake language has been extended with
<a class="reference internal" href="../manual/cmake-language.7.html#bracket-argument">Bracket Argument</a> and <a class="reference internal" href="../manual/cmake-language.7.html#bracket-comment">Bracket Comment</a>
syntax inspired by Lua long brackets:
<div class="highlight-none notranslate"><div class="highlight"><pre>set(x [===[bracket argument]===] #[[bracket comment]])
</pre></div>
</div>
Content between equal-length open- and close-brackets is taken
literally with no variable replacements.
<div class="admonition warning">
Warning
This syntax change could not be made in a fully compatible
way. No policy is possible because syntax parsing occurs before
any chance to set a policy. Existing code using an unquoted
argument that starts with an open bracket will be interpreted
differently without any diagnostic. Fortunately the syntax is
obscure enough that this problem is unlikely in practice.
</div>
</li>
</ul>
</section>
<section id="generators">
<h3><a class="toc-backref" href="#id5" role="doc-backlink">Generators</a><a class="headerlink" href="#generators" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>A new <a class="reference internal" href="../generator/CodeLite.html#generator:CodeLite" title="CodeLite"><code class="xref cmake cmake-generator docutils literal notranslate">CodeLite</code></a> extra generator is available
for use with the Makefile or Ninja generators.</li>
<li>A new <a class="reference internal" href="../generator/Kate.html#generator:Kate" title="Kate"><code class="xref cmake cmake-generator docutils literal notranslate">Kate</code></a> extra generator is available
for use with the Makefile or Ninja generators.</li>
<li>The <a class="reference internal" href="../generator/Ninja.html#generator:Ninja" title="Ninja"><code class="xref cmake cmake-generator docutils literal notranslate">Ninja</code></a> generator learned to use <code class="docutils literal notranslate">ninja</code> job pools
when specified by a new <a class="reference internal" href="../prop_gbl/JOB_POOLS.html#prop_gbl:JOB_POOLS" title="JOB_POOLS"><code class="xref cmake cmake-prop_gbl docutils literal notranslate">JOB_POOLS</code></a> global property.</li>
</ul>
</section>
<section id="commands">
<h3><a class="toc-backref" href="#id6" 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_library.html#command:add_library" title="add_library"><code class="xref cmake cmake-command docutils literal notranslate">add_library()</code></a> command learned a new <code class="docutils literal notranslate">INTERFACE</code>
library type. Interface libraries have no build rules but may
have properties defining
<a class="reference internal" href="../manual/cmake-buildsystem.7.html#manual:cmake-buildsystem(7)" title="cmake-buildsystem(7)"><code class="xref cmake cmake-manual docutils literal notranslate">usage requirements</code></a>
and may be installed, exported, and imported. This is useful to
create header-only libraries that have concrete link dependencies
on other libraries.</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()</code></a> command learned a new <code class="docutils literal notranslate">EXPORT</code> mode that
retrieves the list of targets to export from an export set configured
by 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 <code class="docutils literal notranslate">EXPORT</code> option. This
makes it easy to export from the build tree the same targets that
are exported from the install tree.</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()</code></a> command learned to work with multiple dependent
export sets, thus allowing multiple packages to be built and exported
from a single tree. The feature requires CMake to wait until the
generation step to write the output file. This means one should not
<a class="reference internal" href="../command/include.html#command:include" title="include"><code class="xref cmake cmake-command docutils literal notranslate">include()</code></a> the generated targets file later during project
configuration because it will not be available.
Use <a class="reference internal" href="../manual/cmake-buildsystem.7.html#alias-targets">Alias Targets</a> instead. See policy <a class="reference internal" href="../policy/CMP0024.html#policy:CMP0024" title="CMP0024"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0024</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(FILES)</code></a> command learned to support
<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>
in the list of files.</li>
<li>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 learned to set some version variables
to values specified by the new <code class="docutils literal notranslate">VERSION</code> option or to empty strings.
See policy <a class="reference internal" href="../policy/CMP0048.html#policy:CMP0048" title="CMP0048"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0048</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">CONCAT</code> mode.
It is particularly useful in combination with the new
<a class="reference internal" href="../manual/cmake-language.7.html#bracket-argument">Bracket Argument</a> syntax.</li>
<li>The <a class="reference internal" href="../command/unset.html#command:unset" title="unset"><code class="xref cmake cmake-command docutils literal notranslate">unset()</code></a> command learned a <code class="docutils literal notranslate">PARENT_SCOPE</code> option
matching that of the <a class="reference internal" href="../command/set.html#command:set" title="set"><code class="xref cmake cmake-command docutils literal notranslate">set()</code></a> command.</li>
<li>The <a class="reference internal" href="../command/include_external_msproject.html#command:include_external_msproject" title="include_external_msproject"><code class="xref cmake cmake-command docutils literal notranslate">include_external_msproject()</code></a> command learned
to handle non-C++ projects like <code class="docutils literal notranslate">.vbproj</code> or <code class="docutils literal notranslate">.csproj</code>.</li>
<li>The <a class="reference internal" href="../command/ctest_update.html#command:ctest_update" title="ctest_update"><code class="xref cmake cmake-command docutils literal notranslate">ctest_update()</code></a> command learned to update work trees
managed by the Perforce (p4) version control tool.</li>
<li>The <a class="reference internal" href="../command/message.html#command:message" title="message"><code class="xref cmake cmake-command docutils literal notranslate">message()</code></a> command learned a <code class="docutils literal notranslate">DEPRECATION</code> mode. Such
messages are not issued by default, but may be issued as a warning if
<a class="reference internal" href="../variable/CMAKE_WARN_DEPRECATED.html#variable:CMAKE_WARN_DEPRECATED" title="CMAKE_WARN_DEPRECATED"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_WARN_DEPRECATED</code></a> is enabled, or as an error if
<a class="reference internal" href="../variable/CMAKE_ERROR_DEPRECATED.html#variable:CMAKE_ERROR_DEPRECATED" title="CMAKE_ERROR_DEPRECATED"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_ERROR_DEPRECATED</code></a> is enabled.</li>
<li>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 now allows repeated use of
the <code class="docutils literal notranslate">LINK_PUBLIC</code> and <code class="docutils literal notranslate">LINK_PRIVATE</code> keywords.</li>
</ul>
</section>
<section id="variables">
<h3><a class="toc-backref" href="#id7" role="doc-backlink">Variables</a><a class="headerlink" href="#variables" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>Variable <a class="reference internal" href="../variable/CMAKE_FIND_NO_INSTALL_PREFIX.html#variable:CMAKE_FIND_NO_INSTALL_PREFIX" title="CMAKE_FIND_NO_INSTALL_PREFIX"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_FIND_NO_INSTALL_PREFIX</code></a> has been
introduced to tell CMake not to add the value of
<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> to the
<a class="reference internal" href="../variable/CMAKE_SYSTEM_PREFIX_PATH.html#variable:CMAKE_SYSTEM_PREFIX_PATH" title="CMAKE_SYSTEM_PREFIX_PATH"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_PREFIX_PATH</code></a> variable by default.
This is useful when building a project that installs some
of its own dependencies to avoid finding files it is about
to replace.</li>
<li>Variable <a class="reference internal" href="../variable/CMAKE_STAGING_PREFIX.html#variable:CMAKE_STAGING_PREFIX" title="CMAKE_STAGING_PREFIX"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_STAGING_PREFIX</code></a> was introduced for use
when cross-compiling to specify an installation prefix on the
host system that differs from a <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>
value meant for the target system.</li>
<li>Variable <a class="reference internal" href="../variable/CMAKE_SYSROOT.html#variable:CMAKE_SYSROOT" title="CMAKE_SYSROOT"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSROOT</code></a> was introduced to specify the
toolchain SDK installation prefix, typically for cross-compiling.
This is used to pass a <code class="docutils literal notranslate">--sysroot</code> option to the compiler and
as a prefix searched by <code class="docutils literal notranslate">find_*</code> commands.</li>
<li>Variable <a class="reference internal" href="../variable/CMAKE_LANG_COMPILER_TARGET.html#variable:CMAKE_&lt;LANG&gt;_COMPILER_TARGET" title="CMAKE_&lt;LANG&gt;_COMPILER_TARGET"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_COMPILER_TARGET</code></a> was introduced
for use when cross-compiling to specify the target platform in the
<a class="reference internal" href="../manual/cmake-toolchains.7.html#cross-compiling-toolchain">toolchain file</a> 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 used to pass an option such as <code class="docutils literal notranslate">--target=&lt;triple&gt;</code> to some
cross-compiling compiler drivers.</li>
<li>Variable <a class="reference internal" href="../variable/CMAKE_MAP_IMPORTED_CONFIG_CONFIG.html#variable:CMAKE_MAP_IMPORTED_CONFIG_&lt;CONFIG&gt;" title="CMAKE_MAP_IMPORTED_CONFIG_&lt;CONFIG&gt;"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_MAP_IMPORTED_CONFIG_&lt;CONFIG&gt;</code></a> has been
introduced to optionally initialize the
<a class="reference internal" href="../prop_tgt/MAP_IMPORTED_CONFIG_CONFIG.html#prop_tgt:MAP_IMPORTED_CONFIG_&lt;CONFIG&gt;" title="MAP_IMPORTED_CONFIG_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">MAP_IMPORTED_CONFIG_&lt;CONFIG&gt;</code></a> target property.</li>
</ul>
</section>
<section id="properties">
<h3><a class="toc-backref" href="#id8" role="doc-backlink">Properties</a><a class="headerlink" href="#properties" title="Permalink to this heading">¶</a></h3>
<ul class="simple">
<li>The <a class="reference internal" href="../prop_dir/ADDITIONAL_MAKE_CLEAN_FILES.html#prop_dir:ADDITIONAL_MAKE_CLEAN_FILES" title="ADDITIONAL_MAKE_CLEAN_FILES"><code class="xref cmake cmake-prop_dir docutils literal notranslate">ADDITIONAL_MAKE_CLEAN_FILES</code></a> directory property
learned to support
<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>
<li>A new directory property <a class="reference internal" href="../prop_dir/CMAKE_CONFIGURE_DEPENDS.html#prop_dir:CMAKE_CONFIGURE_DEPENDS" title="CMAKE_CONFIGURE_DEPENDS"><code class="xref cmake cmake-prop_dir docutils literal notranslate">CMAKE_CONFIGURE_DEPENDS</code></a>
was introduced to allow projects to specify additional
files on which the configuration process depends. CMake will
re-run at build time when one of these files is modified.
Previously this was only possible to achieve by specifying
such files as the input to a <a class="reference internal" href="../command/configure_file.html#command:configure_file" title="configure_file"><code class="xref cmake cmake-command docutils literal notranslate">configure_file()</code></a> command.</li>
<li>A new <a class="reference internal" href="../manual/cmake-qt.7.html#qt-autorcc">AUTORCC</a> feature replaces the need to
invoke <code class="docutils literal notranslate">qt4_add_resources()</code> by allowing <code class="docutils literal notranslate">.qrc</code> files to
be listed as target sources.</li>
<li>A new <a class="reference internal" href="../manual/cmake-qt.7.html#qt-autouic">AUTOUIC</a> feature replaces the need to
invoke <code class="docutils literal notranslate">qt4_wrap_ui()</code>.</li>
<li>Test properties learned to support
<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>.
This is useful to specify per-configuration values for test
properties like <a class="reference internal" href="../prop_test/REQUIRED_FILES.html#prop_test:REQUIRED_FILES" title="REQUIRED_FILES"><code class="xref cmake cmake-prop_test docutils literal notranslate">REQUIRED_FILES</code></a> and
<a class="reference internal" href="../prop_test/WORKING_DIRECTORY.html#prop_test:WORKING_DIRECTORY" title="WORKING_DIRECTORY"><code class="xref cmake cmake-prop_test docutils literal notranslate">WORKING_DIRECTORY</code></a>.</li>
<li>A new <a class="reference internal" href="../prop_test/SKIP_RETURN_CODE.html#prop_test:SKIP_RETURN_CODE" title="SKIP_RETURN_CODE"><code class="xref cmake cmake-prop_test docutils literal notranslate">SKIP_RETURN_CODE</code></a> test property was introduced
to tell <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> to treat a particular test return code as
if the test were not run. This is useful for test drivers to report
that certain test requirements were not available.</li>
<li>New types of <a class="reference internal" href="../manual/cmake-buildsystem.7.html#compatible-interface-properties">Compatible Interface Properties</a> were introduced,
namely the <a class="reference internal" href="../prop_tgt/COMPATIBLE_INTERFACE_NUMBER_MAX.html#prop_tgt:COMPATIBLE_INTERFACE_NUMBER_MAX" title="COMPATIBLE_INTERFACE_NUMBER_MAX"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">COMPATIBLE_INTERFACE_NUMBER_MAX</code></a> and
<a class="reference internal" href="../prop_tgt/COMPATIBLE_INTERFACE_NUMBER_MIN.html#prop_tgt:COMPATIBLE_INTERFACE_NUMBER_MIN" title="COMPATIBLE_INTERFACE_NUMBER_MIN"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">COMPATIBLE_INTERFACE_NUMBER_MIN</code></a> for calculating numeric
maximum and minimum values respectively.</li>
</ul>
</section>
<section id="modules">
<h3><a class="toc-backref" href="#id9" 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/CheckTypeSize.html#module:CheckTypeSize" title="CheckTypeSize"><code class="xref cmake cmake-module docutils literal notranslate">CheckTypeSize</code></a> module <code class="docutils literal notranslate">check_type_size</code> macro and
the <a class="reference internal" href="../module/CheckStructHasMember.html#module:CheckStructHasMember" title="CheckStructHasMember"><code class="xref cmake cmake-module docutils literal notranslate">CheckStructHasMember</code></a> module <code class="docutils literal notranslate">check_struct_has_member</code>
macro learned a new <code class="docutils literal notranslate">LANGUAGE</code> option to optionally check C++ types.</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 work with no
URL templates if a local store is available.</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> function <code class="docutils literal notranslate">ExternalProject_Add</code>
learned a new <code class="docutils literal notranslate">GIT_SUBMODULES</code> option to specify a subset
of available submodules to checkout.</li>
<li>A new <a class="reference internal" href="../module/FindBacktrace.html#module:FindBacktrace" title="FindBacktrace"><code class="xref cmake cmake-module docutils literal notranslate">FindBacktrace</code></a> module has been added to support
<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(Backtrace)</code></a> calls.</li>
<li>A new <a class="reference internal" href="../module/FindLua.html#module:FindLua" title="FindLua"><code class="xref cmake cmake-module docutils literal notranslate">FindLua</code></a> module has been added to support
<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(Lua)</code></a> calls.</li>
<li>The <a class="reference internal" href="../module/FindBoost.html#module:FindBoost" title="FindBoost"><code class="xref cmake cmake-module docutils literal notranslate">FindBoost</code></a> module learned a new <code class="docutils literal notranslate">Boost_NAMESPACE</code>
option to change the <code class="docutils literal notranslate">boost</code> prefix on library names.</li>
<li>The <a class="reference internal" href="../module/FindBoost.html#module:FindBoost" title="FindBoost"><code class="xref cmake cmake-module docutils literal notranslate">FindBoost</code></a> module learned to control search
for libraries with the <code class="docutils literal notranslate">g</code> tag (for MS debug runtime) with
a new <code class="docutils literal notranslate">Boost_USE_DEBUG_RUNTIME</code> option. It is <code class="docutils literal notranslate">ON</code> by
default to preserve existing behavior.</li>
<li>The <a class="reference internal" href="../module/FindJava.html#module:FindJava" title="FindJava"><code class="xref cmake cmake-module docutils literal notranslate">FindJava</code></a> and <a class="reference internal" href="../module/FindJNI.html#module:FindJNI" title="FindJNI"><code class="xref cmake cmake-module docutils literal notranslate">FindJNI</code></a> modules learned
to use a <code class="docutils literal notranslate">JAVA_HOME</code> CMake variable or environment variable,
and then try <code class="docutils literal notranslate">/usr/libexec/java_home</code> on OS X.</li>
<li>The <a class="reference internal" href="../module/UseJava.html#module:UseJava" title="UseJava"><code class="xref cmake cmake-module docutils literal notranslate">UseJava</code></a> module <code class="docutils literal notranslate">add_jar</code> function learned a new
<code class="docutils literal notranslate">MANIFEST</code> option to pass the <code class="docutils literal notranslate">-m</code> option to <code class="docutils literal notranslate">jar</code>.</li>
<li>A new <a class="reference internal" href="../module/CMakeFindDependencyMacro.html#module:CMakeFindDependencyMacro" title="CMakeFindDependencyMacro"><code class="xref cmake cmake-module docutils literal notranslate">CMakeFindDependencyMacro</code></a> module was introduced with
a <code class="docutils literal notranslate">find_dependency</code> macro to find transitive dependencies in
a <a class="reference internal" href="../manual/cmake-packages.7.html#manual:cmake-packages(7)" title="cmake-packages(7)"><code class="xref cmake cmake-manual docutils literal notranslate">package configuration file</code></a>. Such
dependencies are omitted by the listing of 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.</li>
<li>The <a class="reference internal" href="../module/FindQt4.html#module:FindQt4" title="FindQt4"><code class="xref cmake cmake-module docutils literal notranslate">FindQt4</code></a> module learned to create <a class="reference internal" href="../manual/cmake-buildsystem.7.html#imported-targets">Imported Targets</a>
for Qt executables. This helps disambiguate when using multiple
<a class="reference internal" href="../manual/cmake-qt.7.html#manual:cmake-qt(7)" title="cmake-qt(7)"><code class="xref cmake cmake-manual docutils literal notranslate">Qt versions</code></a> in the same buildsystem.</li>
<li>The <a class="reference internal" href="../module/FindRuby.html#module:FindRuby" title="FindRuby"><code class="xref cmake cmake-module docutils literal notranslate">FindRuby</code></a> module learned to search for Ruby 2.0 and 2.1.</li>
</ul>
</section>
<section id="generator-expressions">
<h3><a class="toc-backref" href="#id10" 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">$&lt;PLATFORM_ID&gt;</code> and <code class="docutils literal notranslate">$&lt;PLATFORM_ID:...&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>
have been added.</li>
<li>The <code class="docutils literal notranslate">$&lt;CONFIG&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> now has
a variant which takes no argument. This is equivalent to the
<code class="docutils literal notranslate">$&lt;CONFIGURATION&gt;</code> expression.</li>
<li>New <code class="docutils literal notranslate">$&lt;UPPER_CASE:...&gt;</code> and <code class="docutils literal notranslate">$&lt;LOWER_CASE:...&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>
generator expressions have been added.</li>
<li>A new <code class="docutils literal notranslate">$&lt;MAKE_C_IDENTIFIER:...&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> has
been added.</li>
</ul>
</section>
<section id="other">
<h3><a class="toc-backref" href="#id11" 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">sleep</code> command.</li>
<li>The <a class="reference internal" href="../manual/ccmake.1.html#manual:ccmake(1)" title="ccmake(1)"><code class="xref cmake cmake-manual docutils literal notranslate">ccmake(1)</code></a> dialog learned to honor the
<a class="reference internal" href="../prop_cache/STRINGS.html#prop_cache:STRINGS" title="STRINGS"><code class="xref cmake cmake-prop_cache docutils literal notranslate">STRINGS</code></a> cache entry property to cycle through
the enumerated list of possible values.</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 learned to remember window
settings between sessions.</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 learned to remember the type
of a cache entry for completion in the <code class="docutils literal notranslate">Add Entry</code> dialog.</li>
</ul>
</section>
</section>
<section id="new-diagnostics">
<h2><a class="toc-backref" href="#id12" role="doc-backlink">New Diagnostics</a><a class="headerlink" href="#new-diagnostics" title="Permalink to this heading">¶</a></h2>
<ul class="simple">
<li>Directories named 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>
target property of imported targets linked conditionally by a
<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>
were not checked for existence. Now they are checked.
See policy <a class="reference internal" href="../policy/CMP0027.html#policy:CMP0027" title="CMP0027"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0027</code></a>.</li>
<li>Build target names must now match a validity pattern and may no longer
conflict with CMake-defined targets. See policy <a class="reference internal" href="../policy/CMP0037.html#policy:CMP0037" title="CMP0037"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0037</code></a>.</li>
<li>Build targets that specify themselves as a link dependency were
silently accepted but are now diagnosed. See <a class="reference internal" href="../policy/CMP0038.html#policy:CMP0038" title="CMP0038"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0038</code></a>.</li>
<li>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 used to silently ignore
calls specifying as their first argument build targets created by
<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> but now diagnoses this mistake.
See policy <a class="reference internal" href="../policy/CMP0039.html#policy:CMP0039" title="CMP0039"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0039</code></a>.</li>
<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 used to silently ignore
calls specifying the <code class="docutils literal notranslate">TARGET</code> option with a non-existent target
but now diagnoses this mistake. See policy <a class="reference internal" href="../policy/CMP0040.html#policy:CMP0040" title="CMP0040"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0040</code></a>.</li>
<li>Relative paths 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>
target property used to be silently accepted if they contained a
<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>
but are now rejected. See policy <a class="reference internal" href="../policy/CMP0041.html#policy:CMP0041" title="CMP0041"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0041</code></a>.</li>
<li>The <a class="reference internal" href="../command/get_target_property.html#command:get_target_property" title="get_target_property"><code class="xref cmake cmake-command docutils literal notranslate">get_target_property()</code></a> command learned to reject calls
specifying a non-existent target. See policy <a class="reference internal" href="../policy/CMP0045.html#policy:CMP0045" title="CMP0045"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0045</code></a>.</li>
<li>The <a class="reference internal" href="../command/add_dependencies.html#command:add_dependencies" title="add_dependencies"><code class="xref cmake cmake-command docutils literal notranslate">add_dependencies()</code></a> command learned to reject calls
specifying a dependency on a non-existent target.
See policy <a class="reference internal" href="../policy/CMP0046.html#policy:CMP0046" title="CMP0046"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0046</code></a>.</li>
<li>Link dependency analysis learned to assume names containing <code class="docutils literal notranslate">::</code>
refer to <a class="reference internal" href="../manual/cmake-buildsystem.7.html#alias-targets">Alias Targets</a> or <a class="reference internal" href="../manual/cmake-buildsystem.7.html#imported-targets">Imported Targets</a>. It will
now produce an error if such a linked target is missing. Previously
in this case CMake generated a link line that failed at build time.
See policy <a class="reference internal" href="../policy/CMP0028.html#policy:CMP0028" title="CMP0028"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0028</code></a>.</li>
<li>When 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> or <a class="reference internal" href="../command/enable_language.html#command:enable_language" title="enable_language"><code class="xref cmake cmake-command docutils literal notranslate">enable_language()</code></a> commands
initialize support for a language, it is now an error if the full
path to the compiler cannot be found and stored in the corresponding
<a class="reference internal" href="../variable/CMAKE_LANG_COMPILER.html#variable:CMAKE_&lt;LANG&gt;_COMPILER" title="CMAKE_&lt;LANG&gt;_COMPILER"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_COMPILER</code></a> variable. This produces nicer error
messages up front and stops processing when no working compiler
is known to be available.</li>
<li>Target sources specified with 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> or
<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> command learned to reject items which
require an undocumented extra layer of variable expansion.
See policy <a class="reference internal" href="../policy/CMP0049.html#policy:CMP0049" title="CMP0049"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0049</code></a>.</li>
<li>Use of <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> undocumented <code class="docutils literal notranslate">SOURCE</code>
signatures now results in an error. See policy <a class="reference internal" href="../policy/CMP0050.html#policy:CMP0050" title="CMP0050"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0050</code></a>.</li>
</ul>
</section>
<section id="deprecated-and-removed-features">
<h2><a class="toc-backref" href="#id13" 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>Compatibility options supporting code written for CMake versions
prior to 2.4 have been removed.</li>
<li>Several long-outdated commands that should no longer be called
have been disallowed in new code by policies:
<ul>
<li>Policy <a class="reference internal" href="../policy/CMP0029.html#policy:CMP0029" title="CMP0029"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0029</code></a> disallows <a class="reference internal" href="../command/subdir_depends.html#command:subdir_depends" title="subdir_depends"><code class="xref cmake cmake-command docutils literal notranslate">subdir_depends()</code></a></li>
<li>Policy <a class="reference internal" href="../policy/CMP0030.html#policy:CMP0030" title="CMP0030"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0030</code></a> disallows <a class="reference internal" href="../command/use_mangled_mesa.html#command:use_mangled_mesa" title="use_mangled_mesa"><code class="xref cmake cmake-command docutils literal notranslate">use_mangled_mesa()</code></a></li>
<li>Policy <a class="reference internal" href="../policy/CMP0031.html#policy:CMP0031" title="CMP0031"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0031</code></a> disallows <a class="reference internal" href="../command/load_command.html#command:load_command" title="load_command"><code class="xref cmake cmake-command docutils literal notranslate">load_command()</code></a></li>
<li>Policy <a class="reference internal" href="../policy/CMP0032.html#policy:CMP0032" title="CMP0032"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0032</code></a> disallows <a class="reference internal" href="../command/output_required_files.html#command:output_required_files" title="output_required_files"><code class="xref cmake cmake-command docutils literal notranslate">output_required_files()</code></a></li>
<li>Policy <a class="reference internal" href="../policy/CMP0033.html#policy:CMP0033" title="CMP0033"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0033</code></a> disallows <a class="reference internal" href="../command/export_library_dependencies.html#command:export_library_dependencies" title="export_library_dependencies"><code class="xref cmake cmake-command docutils literal notranslate">export_library_dependencies()</code></a></li>
<li>Policy <a class="reference internal" href="../policy/CMP0034.html#policy:CMP0034" title="CMP0034"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0034</code></a> disallows <a class="reference internal" href="../command/utility_source.html#command:utility_source" title="utility_source"><code class="xref cmake cmake-command docutils literal notranslate">utility_source()</code></a></li>
<li>Policy <a class="reference internal" href="../policy/CMP0035.html#policy:CMP0035" title="CMP0035"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0035</code></a> disallows <a class="reference internal" href="../command/variable_requires.html#command:variable_requires" title="variable_requires"><code class="xref cmake cmake-command docutils literal notranslate">variable_requires()</code></a></li>
<li>Policy <a class="reference internal" href="../policy/CMP0036.html#policy:CMP0036" title="CMP0036"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0036</code></a> disallows <a class="reference internal" href="../command/build_name.html#command:build_name" title="build_name"><code class="xref cmake cmake-command docutils literal notranslate">build_name()</code></a></li>
</ul>
</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">-i</code> wizard mode has been removed.
Instead use an interactive dialog such as <a class="reference internal" href="../manual/ccmake.1.html#manual:ccmake(1)" title="ccmake(1)"><code class="xref cmake cmake-manual docutils literal notranslate">ccmake(1)</code></a>
or use the <code class="docutils literal notranslate">-D</code> option to set cache values from the command line.</li>
<li>The builtin documentation formatters that supported command-line
options such as <code class="docutils literal notranslate">--help-man</code> and <code class="docutils literal notranslate">--help-html</code> have been removed
in favor of the above-mentioned new documentation system. These and
other command-line options that used to generate man- and html-
formatted pages no longer work. 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">--help-custom-modules</code> option now produces a warning at runtime
and generates a minimal document that reports the limitation.</li>
<li>The <a class="reference internal" href="../prop_dir/COMPILE_DEFINITIONS_CONFIG.html#prop_dir:COMPILE_DEFINITIONS_&lt;CONFIG&gt;" title="COMPILE_DEFINITIONS_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_dir docutils literal notranslate">COMPILE_DEFINITIONS_&lt;CONFIG&gt;</code></a> directory properties and the
<a class="reference internal" href="../prop_tgt/COMPILE_DEFINITIONS_CONFIG.html#prop_tgt:COMPILE_DEFINITIONS_&lt;CONFIG&gt;" title="COMPILE_DEFINITIONS_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">COMPILE_DEFINITIONS_&lt;CONFIG&gt;</code></a> target properties have been
deprecated. Instead set the corresponding <a class="reference internal" href="../prop_dir/COMPILE_DEFINITIONS.html#prop_dir:COMPILE_DEFINITIONS" title="COMPILE_DEFINITIONS"><code class="xref cmake cmake-prop_dir docutils literal notranslate">COMPILE_DEFINITIONS</code></a>
directory property or <a class="reference internal" href="../prop_tgt/COMPILE_DEFINITIONS.html#prop_tgt:COMPILE_DEFINITIONS" title="COMPILE_DEFINITIONS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">COMPILE_DEFINITIONS</code></a> target property and
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> like
<code class="docutils literal notranslate">$&lt;CONFIG:...&gt;</code> to specify per-configuration definitions.
See policy <a class="reference internal" href="../policy/CMP0043.html#policy:CMP0043" title="CMP0043"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0043</code></a>.</li>
<li>The <a class="reference internal" href="../prop_tgt/LOCATION.html#prop_tgt:LOCATION" title="LOCATION"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">LOCATION</code></a> target property should no longer be read from
non-IMPORTED targets. It does not make sense in multi-configuration
generators since the build configuration is not known while configuring
the project. It has been superseded by the <code class="docutils literal notranslate">$&lt;TARGET_FILE&gt;</code> generator
expression. See policy <a class="reference internal" href="../policy/CMP0026.html#policy:CMP0026" title="CMP0026"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0026</code></a>.</li>
<li>The <a class="reference internal" href="../prop_tgt/COMPILE_FLAGS.html#prop_tgt:COMPILE_FLAGS" title="COMPILE_FLAGS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">COMPILE_FLAGS</code></a> target property is now documented
as deprecated, though no warning is issued. Use the
<a class="reference internal" href="../prop_tgt/COMPILE_OPTIONS.html#prop_tgt:COMPILE_OPTIONS" title="COMPILE_OPTIONS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">COMPILE_OPTIONS</code></a> target property or the
<a class="reference internal" href="../command/target_compile_options.html#command:target_compile_options" title="target_compile_options"><code class="xref cmake cmake-command docutils literal notranslate">target_compile_options()</code></a> command instead.</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">add_compiler_export_flags</code>
function is now deprecated. It has been superseded by the
<a class="reference internal" href="../prop_tgt/LANG_VISIBILITY_PRESET.html#prop_tgt:&lt;LANG&gt;_VISIBILITY_PRESET" title="&lt;LANG&gt;_VISIBILITY_PRESET"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">&lt;LANG&gt;_VISIBILITY_PRESET</code></a> and
<a class="reference internal" href="../prop_tgt/VISIBILITY_INLINES_HIDDEN.html#prop_tgt:VISIBILITY_INLINES_HIDDEN" title="VISIBILITY_INLINES_HIDDEN"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">VISIBILITY_INLINES_HIDDEN</code></a> target properties.</li>
</ul>
</section>
<section id="other-changes">
<h2><a class="toc-backref" href="#id14" role="doc-backlink">Other Changes</a><a class="headerlink" href="#other-changes" title="Permalink to this heading">¶</a></h2>
<ul>
<li>The version scheme was changed to use only two components for
the feature level instead of three. The third component will
now be used for bug-fix releases or the date of development versions.
See 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 documentation for details.</li>
<li>The default install locations of CMake itself on Windows and
OS X no longer contain the CMake version number. This allows
for easy replacement without re-generating local build trees
manually.</li>
<li>Generators for Visual Studio 10 (2010) and later were renamed to
include the product year like generators for older VS versions:
<ul class="simple">
<li><code class="docutils literal notranslate">Visual Studio 10</code> -&gt; <a class="reference internal" href="../generator/Visual%20Studio%2010%202010.html#generator:Visual Studio 10 2010" title="Visual Studio 10 2010"><code class="xref cmake cmake-generator docutils literal notranslate">Visual Studio 10 2010</code></a></li>
<li><code class="docutils literal notranslate">Visual Studio 11</code> -&gt; <a class="reference internal" href="../generator/Visual%20Studio%2011%202012.html#generator:Visual Studio 11 2012" title="Visual Studio 11 2012"><code class="xref cmake cmake-generator docutils literal notranslate">Visual Studio 11 2012</code></a></li>
<li><code class="docutils literal notranslate">Visual Studio 12</code> -&gt; <a class="reference internal" href="../generator/Visual%20Studio%2012%202013.html#generator:Visual Studio 12 2013" title="Visual Studio 12 2013"><code class="xref cmake cmake-generator docutils literal notranslate">Visual Studio 12 2013</code></a></li>
</ul>
This clarifies which generator goes with each Visual Studio
version. The old names are recognized for compatibility.
</li>
<li>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> value for Apple-provided
Clang is now <code class="docutils literal notranslate">AppleClang</code>. It must be distinct from upstream
Clang because the version numbers differ.
See policy <a class="reference internal" href="../policy/CMP0025.html#policy:CMP0025" title="CMP0025"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0025</code></a>.</li>
<li>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> value for <code class="docutils literal notranslate">qcc</code> on QNX
is now <code class="docutils literal notranslate">QCC</code>. It must be distinct from <code class="docutils literal notranslate">GNU</code> because the
command-line options differ. See policy <a class="reference internal" href="../policy/CMP0047.html#policy:CMP0047" title="CMP0047"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0047</code></a>.</li>
<li>On 64-bit OS X the <a class="reference internal" href="../variable/CMAKE_HOST_SYSTEM_PROCESSOR.html#variable:CMAKE_HOST_SYSTEM_PROCESSOR" title="CMAKE_HOST_SYSTEM_PROCESSOR"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_HOST_SYSTEM_PROCESSOR</code></a> value
is now correctly detected as <code class="docutils literal notranslate">x86_64</code> instead of <code class="docutils literal notranslate">i386</code>.</li>
<li>On OS X, CMake learned to enable behavior specified by the
<a class="reference internal" href="../prop_tgt/MACOSX_RPATH.html#prop_tgt:MACOSX_RPATH" title="MACOSX_RPATH"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">MACOSX_RPATH</code></a> target property by default. This activates
use of <code class="docutils literal notranslate">&#64;rpath</code> for runtime shared library searches.
See policy <a class="reference internal" href="../policy/CMP0042.html#policy:CMP0042" title="CMP0042"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0042</code></a>.</li>
<li>The <a class="reference internal" href="../command/build_command.html#command:build_command" title="build_command"><code class="xref cmake cmake-command docutils literal notranslate">build_command()</code></a> command now returns a <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">--build</code> command line instead of a direct invocation of the native
build tool. When using <code class="docutils literal notranslate">Visual Studio</code> generators, CMake and CTest
no longer require <a class="reference internal" href="../variable/CMAKE_MAKE_PROGRAM.html#variable:CMAKE_MAKE_PROGRAM" title="CMAKE_MAKE_PROGRAM"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_MAKE_PROGRAM</code></a> to be located up front.
Selection of the proper msbuild or devenv tool is now performed as
late as possible when the solution (<code class="docutils literal notranslate">.sln</code>) file is available so
it can depend on project content.</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">--build</code> command now shares its own stdout
and stderr pipes with the native build tool by default.
The <code class="docutils literal notranslate">--use-stderr</code> option that once activated this is now ignored.</li>
<li>The <code class="docutils literal notranslate">$&lt;C_COMPILER_ID:...&gt;</code> and <code class="docutils literal notranslate">$&lt;CXX_COMPILER_ID:...&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>
used to perform case-insensitive comparison but have now been
corrected to perform case-sensitive comparison.
See policy <a class="reference internal" href="../policy/CMP0044.html#policy:CMP0044" title="CMP0044"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0044</code></a>.</li>
<li>The builtin <code class="docutils literal notranslate">edit_cache</code> target will no longer select
<a class="reference internal" href="../manual/ccmake.1.html#manual:ccmake(1)" title="ccmake(1)"><code class="xref cmake cmake-manual docutils literal notranslate">ccmake(1)</code></a> by default when no interactive terminal will
be available (e.g. with <a class="reference internal" href="../generator/Ninja.html#generator:Ninja" title="Ninja"><code class="xref cmake cmake-generator docutils literal notranslate">Ninja</code></a> or an IDE generator).
Instead <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> will be preferred if available.</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> download step learned to
re-attempt download in certain cases to be more robust to
temporary network failure.</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> no longer lists transitive
dependencies since they were not directly requested by the
current project.</li>
<li>The <code class="docutils literal notranslate">cmake-mode.el</code> major Emacs editing mode has been cleaned
up and enhanced in several ways.</li>
<li>Include directories specified 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 <a class="reference internal" href="../manual/cmake-buildsystem.7.html#imported-targets">Imported Targets</a>
are treated as <code class="docutils literal notranslate">SYSTEM</code> includes by default when handled as
<a class="reference internal" href="../manual/cmake-buildsystem.7.html#include-directories-and-usage-requirements">usage requirements</a>.</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.0 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="#syntax">Syntax</a></li>
<li><a class="reference internal" href="#generators">Generators</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="#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.1.html"
 title="previous chapter">CMake 3.1 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.0.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.1.html" title="CMake 3.1 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.0 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>