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.sc...@crascit.com> AuthorDate: Thu Aug 23 11:53:08 2018 +0000 Commit: Kitware Robot <kwro...@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 <kwro...@kitware.com> Merge-request: !2300 https://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=1a0f1a25a44005613e21591470aafecaec306202 commit 1a0f1a25a44005613e21591470aafecaec306202 Author: Robert Maynard <robert.mayn...@kitware.com> AuthorDate: Fri Aug 17 08:29:37 2018 -0400 Commit: Robert Maynard <robert.mayn...@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 _______________________________________________ Cmake-commits mailing list Cmake-commits@cmake.org https://cmake.org/mailman/listinfo/cmake-commits