summaryrefslogtreecommitdiffstats
path: root/Help/manual/cmake-language.7.rst
diff options
context:
space:
mode:
authorBen Boeckel <ben.boeckel@kitware.com>2018-10-11 22:08:03 (GMT)
committerBrad King <brad.king@kitware.com>2018-10-15 17:59:39 (GMT)
commit82a48226107e2ee0d073eaf521750c8354b67e41 (patch)
tree14408171e839f774b71c302f12d9af4f9c28ec46 /Help/manual/cmake-language.7.rst
parentfd02538974dd952a8639d371c2c0067d30d5469a (diff)
downloadCMake-82a48226107e2ee0d073eaf521750c8354b67e41.zip
CMake-82a48226107e2ee0d073eaf521750c8354b67e41.tar.gz
CMake-82a48226107e2ee0d073eaf521750c8354b67e41.tar.bz2
CMP0053: document that `$` is a valid literal variable character
This was overlooked in the initial implementation of CMP0053. However, an additional policy to reject it again is not worth it. Instead, add tests and document the behavior. Fixes: #17883
Diffstat (limited to 'Help/manual/cmake-language.7.rst')
-rw-r--r--Help/manual/cmake-language.7.rst5
1 files changed, 3 insertions, 2 deletions
diff --git a/Help/manual/cmake-language.7.rst b/Help/manual/cmake-language.7.rst
index 591f73d..71649ba 100644
--- a/Help/manual/cmake-language.7.rst
+++ b/Help/manual/cmake-language.7.rst
@@ -391,8 +391,9 @@ inside out, e.g. ``${outer_${inner_variable}_variable}``.
Literal variable references may consist of alphanumeric characters,
the characters ``/_.+-``, and `Escape Sequences`_. Nested references
-may be used to evaluate variables of any name. (See also policy
-:policy:`CMP0053` documentation for historical considerations.)
+may be used to evaluate variables of any name. See also policy
+:policy:`CMP0053` documentation for historical considerations and reasons why
+the ``$`` is also technically permitted but is discouraged.
The `Variables`_ section documents the scope of variable names
and how their values are set.