kolan/CMake
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Help: Replace CMP0054 example to show when it makes a difference

Browse Source 
The previous example for CMP0054 did not show how critical the policy is
since the result is the same in both cases (NEW and OLD behavior).
Instead show an example when the policy does make a difference.
This commit is contained in:
Tamás Kenéz 2015-04-29 15:46:16 +02:00 committed by Brad King
parent 036e449c66
commit 9535b86d3c
1 changed files with 10 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
Help/policy/CMP0054.rst
View File

@ -16,29 +16,33 @@ Given the following partial example:
::
set(MONKEY 1)
set(ANIMAL MONKEY)
set(A E)
set(E "")
if("${ANIMAL}" STREQUAL "MONKEY")
if("${A}" STREQUAL "")
message("Result is TRUE before CMake 3.1 or when CMP0054 is OLD")
else()
message("Result is FALSE in CMake 3.1 and above if CMP0054 is NEW")
endif()
After explicit expansion of variables this gives:
::
if("MONKEY" STREQUAL "MONKEY")
if("E" STREQUAL "")
With the policy set to ``OLD`` implicit expansion reduces this semantically to:
::
if("1" STREQUAL "1")
if("" STREQUAL "")
With the policy set to ``NEW`` the quoted arguments will not be
further dereferenced:
::
if("MONKEY" STREQUAL "MONKEY")
if("E" STREQUAL "")
This policy was introduced in CMake version 3.1.
CMake version |release| warns when the policy is not set and uses