[Cmake-commits] CMake branch, next, updated. v3.1.0-rc3-1136-g5dc677f

[Brad King]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "CMake".

The branch, next has been updated
       via  5dc677feb2df6c3c79e060bf939b8bf10159b429 (commit)
       via  f2f1c95dd9a1e1b3dc6652ef2afb7ca74c0c986f (commit)
      from  1ba345dcbfa22e7404acc82238fed14757255fe4 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=5dc677feb2df6c3c79e060bf939b8bf10159b429
commit 5dc677feb2df6c3c79e060bf939b8bf10159b429
Merge: 1ba345d f2f1c95
Author:     Brad King <brad.king at kitware.com>
AuthorDate: Fri Dec 12 11:13:17 2014 -0500
Commit:     CMake Topic Stage <kwrobot at kitware.com>
CommitDate: Fri Dec 12 11:13:17 2014 -0500

    Merge topic 'doc-CMP0054-example' into next
    
    f2f1c95d Help: Extend policy CMP0054 documentation with an example


http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=f2f1c95dd9a1e1b3dc6652ef2afb7ca74c0c986f
commit f2f1c95dd9a1e1b3dc6652ef2afb7ca74c0c986f
Author:     Nils Gladitz <nilsgladitz at gmail.com>
AuthorDate: Tue Dec 9 21:52:23 2014 +0100
Commit:     Brad King <brad.king at kitware.com>
CommitDate: Fri Dec 12 11:12:46 2014 -0500

    Help: Extend policy CMP0054 documentation with an example

diff --git a/Help/policy/CMP0054.rst b/Help/policy/CMP0054.rst
index dffee5e..39f0c40 100644
--- a/Help/policy/CMP0054.rst
+++ b/Help/policy/CMP0054.rst
@@ -3,15 +3,43 @@ CMP0054
 
 Only interpret :command:`if` arguments as variables or keywords when unquoted.
 
-CMake 3.1 and above no longer dereference variables or interpret keywords
-in an :command:`if` command argument when it is a :ref:`Quoted Argument`
-or a :ref:`Bracket Argument`.
+CMake 3.1 and above no longer implicitly dereference variables or
+interpret keywords in an :command:`if` command argument when
+it is a :ref:`Quoted Argument` or a :ref:`Bracket Argument`.
 
 The ``OLD`` behavior for this policy is to dereference variables and
 interpret keywords even if they are quoted or bracketed.
 The ``NEW`` behavior is to not dereference variables or interpret keywords
 that have been quoted or bracketed.
 
+Given the following partial example:
+
+::
+
+  set(MONKEY 1)
+  set(ANIMAL MONKEY)
+
+  if("${ANIMAL}" STREQUAL "MONKEY")
+
+After explicit expansion of variables this gives:
+
+::
+
+  if("MONKEY" STREQUAL "MONKEY")
+
+With the policy set to ``OLD`` implicit expansion reduces this semantically to:
+
+::
+
+  if("1" STREQUAL "1")
+
+With the policy set to ``NEW`` the quoted arguments will not be
+further dereferenced:
+
+::
+
+  if("MONKEY" STREQUAL "MONKEY")
+
 This policy was introduced in CMake version 3.1.
 CMake version |release| warns when the policy is not set and uses
 ``OLD`` behavior.  Use the :command:`cmake_policy` command to set

-----------------------------------------------------------------------

Summary of changes:


hooks/post-receive
-- 
CMake