summaryrefslogtreecommitdiffstats
path: root/Help/policy
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2018-10-16 15:04:01 (GMT)
committerKitware Robot <kwrobot@kitware.com>2018-10-16 15:04:09 (GMT)
commite5e59a1bc68702395ff63e301cadaee266982fc7 (patch)
tree4ff2089beb3991a63cb14fb227a94d1ba15c3a15 /Help/policy
parent73d9d53ed0333f76e8ded6a91d34fbc43111ab27 (diff)
parent82a48226107e2ee0d073eaf521750c8354b67e41 (diff)
downloadCMake-e5e59a1bc68702395ff63e301cadaee266982fc7.zip
CMake-e5e59a1bc68702395ff63e301cadaee266982fc7.tar.gz
CMake-e5e59a1bc68702395ff63e301cadaee266982fc7.tar.bz2
Merge topic 'document-dollar-in-varnames'
82a4822610 CMP0053: document that `$` is a valid literal variable character Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2479
Diffstat (limited to 'Help/policy')
-rw-r--r--Help/policy/CMP0053.rst4
1 files changed, 4 insertions, 0 deletions
diff --git a/Help/policy/CMP0053.rst b/Help/policy/CMP0053.rst
index 2620a60..032b3e5 100644
--- a/Help/policy/CMP0053.rst
+++ b/Help/policy/CMP0053.rst
@@ -16,6 +16,10 @@ cleaned up to simplify the behavior. Specifically:
* Literal ``${VAR}`` reference syntax may contain only
alphanumeric characters (``A-Z``, ``a-z``, ``0-9``) and
the characters ``_``, ``.``, ``/``, ``-``, and ``+``.
+ Note that ``$`` is technically allowed in the ``NEW`` behavior, but is
+ invalid for ``OLD`` behavior. This is due to an oversight during the
+ implementation of :policy:`CMP0053` and its use as a literal variable
+ reference is discouraged for this reason.
Variables with other characters in their name may still
be referenced indirectly, e.g.