diff options
| author | Ben Boeckel <ben.boeckel@kitware.com> | 2018-10-11 22:08:03 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2018-10-15 17:59:39 (GMT) |
| commit | 82a48226107e2ee0d073eaf521750c8354b67e41 (patch) | |
| tree | 14408171e839f774b71c302f12d9af4f9c28ec46 /Help/policy | |
| parent | fd02538974dd952a8639d371c2c0067d30d5469a (diff) | |
| download | CMake-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/policy')
| -rw-r--r-- | Help/policy/CMP0053.rst | 4 |
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. |