[Cmake-commits] CMake branch, master, updated. v3.12.1-442-g91c9a52

[Kitware Robot]

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, master has been updated
       via  91c9a5227384b374c80f1e6453bb830e3de68a4a (commit)
       via  1a0f1a25a44005613e21591470aafecaec306202 (commit)
      from  9e68a4279bd03f977fb8516be1b6c97009c5d07b (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 -----------------------------------------------------------------
https://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=91c9a5227384b374c80f1e6453bb830e3de68a4a
commit 91c9a5227384b374c80f1e6453bb830e3de68a4a
Merge: 9e68a42 1a0f1a2
Author:     Craig Scott <craig.scott at crascit.com>
AuthorDate: Thu Aug 23 11:53:08 2018 +0000
Commit:     Kitware Robot <kwrobot at kitware.com>
CommitDate: Thu Aug 23 07:53:19 2018 -0400

    Merge topic 'tweak_unset_docs'
    
    1a0f1a25a4 Help: Clarify the unset command
    
    Acked-by: Kitware Robot <kwrobot at kitware.com>
    Merge-request: !2300


https://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=1a0f1a25a44005613e21591470aafecaec306202
commit 1a0f1a25a44005613e21591470aafecaec306202
Author:     Robert Maynard <robert.maynard at kitware.com>
AuthorDate: Fri Aug 17 08:29:37 2018 -0400
Commit:     Robert Maynard <robert.maynard at kitware.com>
CommitDate: Tue Aug 21 14:16:32 2018 -0400

    Help: Clarify the unset command

diff --git a/Help/command/unset.rst b/Help/command/unset.rst
index a1fc95c..c19dd31 100644
--- a/Help/command/unset.rst
+++ b/Help/command/unset.rst
@@ -7,9 +7,16 @@ Unset a variable, cache variable, or environment variable.
 
   unset(<variable> [CACHE | PARENT_SCOPE])
 
-Removes the specified variable causing it to become undefined.  If
-``CACHE`` is present then the variable is removed from the cache instead
-of the current scope.
+Removes a normal variable from the current scope, causing it
+to become undefined.  If ``CACHE`` is present, then a cache variable
+is removed instead of a normal variable.  Note that when evaluating
+:ref:`Variable References` of the form ``${VAR}``, CMake first searches
+for a normal variable with that name.  If no such normal variable exists,
+CMake will then search for a cache entry with that name.  Because of this
+unsetting a normal variable can expose a cache variable that was previously
+hidden.  To force a variable reference of the form ``${VAR}`` to return an
+empty string, use ``set(<variable> "")``, which clears the normal variable
+but leaves it defined.
 
 If ``PARENT_SCOPE`` is present then the variable is removed from the scope
 above the current scope.  See the same option in the :command:`set` command

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

Summary of changes:
 Help/command/unset.rst | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)


hooks/post-receive
-- 
CMake