summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorStephen Kelly <steveire@gmail.com>2014-02-11 16:41:24 (GMT)
committerBrad King <brad.king@kitware.com>2014-02-12 16:17:38 (GMT)
commitc248a437c47b4419fd955d4b1f406f7c8b9dcd74 (patch)
tree37a953da5b8130fdde1e36e9c731930c161fd896 /Help
parent418a155be7e44117297c072b6aa0f21f4407c052 (diff)
downloadCMake-c248a437c47b4419fd955d4b1f406f7c8b9dcd74.zip
CMake-c248a437c47b4419fd955d4b1f406f7c8b9dcd74.tar.gz
CMake-c248a437c47b4419fd955d4b1f406f7c8b9dcd74.tar.bz2
Add policy CMP0049 to avoid variable expansion in source lists
Diffstat (limited to 'Help')
-rw-r--r--Help/manual/cmake-policies.7.rst1
-rw-r--r--Help/policy/CMP0049.rst23
-rw-r--r--Help/release/3.0.rst5
3 files changed, 29 insertions, 0 deletions
diff --git a/Help/manual/cmake-policies.7.rst b/Help/manual/cmake-policies.7.rst
index 972a9f8..c097697 100644
--- a/Help/manual/cmake-policies.7.rst
+++ b/Help/manual/cmake-policies.7.rst
@@ -100,3 +100,4 @@ All Policies
/policy/CMP0046
/policy/CMP0047
/policy/CMP0048
+ /policy/CMP0049
diff --git a/Help/policy/CMP0049.rst b/Help/policy/CMP0049.rst
new file mode 100644
index 0000000..5c8d4a8
--- /dev/null
+++ b/Help/policy/CMP0049.rst
@@ -0,0 +1,23 @@
+CMP0049
+-------
+
+Do not expand variables in target source entries.
+
+CMake 2.8.12 and lower performed and extra layer of variable expansion
+when evaluating source file names:
+
+.. code-block:: cmake
+
+ set(a_source foo.c)
+ add_executable(foo \${a_source})
+
+This was undocumented behavior.
+
+The OLD behavior for this policy is to expand such variables when processing
+the target sources. The NEW behavior for this policy is to issue an error
+if such variables need to be expanded.
+
+This policy was introduced in CMake version 3.0.
+CMake version |release| warns when the policy is not set and uses
+OLD behavior. Use the cmake_policy command to set it to OLD or
+NEW explicitly.
diff --git a/Help/release/3.0.rst b/Help/release/3.0.rst
index bef7715..39f906a 100644
--- a/Help/release/3.0.rst
+++ b/Help/release/3.0.rst
@@ -322,6 +322,11 @@ New Diagnostics
messages up front and stops processing when no working compiler
is known to be available.
+* Target sources specified with the :command:`add_library` or
+ :command:`add_executable` command learned to reject items which
+ require an undocumented extra layer of variable expansion.
+ See policy :policy:`CMP0049`.
+
Deprecated and Removed Features
===============================