diff options
author | Brad King <brad.king@kitware.com> | 2017-02-22 21:50:18 (GMT) |
---|---|---|
committer | Brad King <brad.king@kitware.com> | 2017-02-22 21:50:18 (GMT) |
commit | 970fe6ec2fa5c195f157338bb8b9b3c8766e00a3 (patch) | |
tree | 84cddf7c1af8b6ac04a3601dba7eb4ef9486ba98 /Help | |
parent | 4734c3e6dbf5cdabcfedb449e92a61471f7664b7 (diff) | |
parent | 1dc13019259bd62d63b9295011227029283c2ef7 (diff) | |
download | CMake-970fe6ec2fa5c195f157338bb8b9b3c8766e00a3.zip CMake-970fe6ec2fa5c195f157338bb8b9b3c8766e00a3.tar.gz CMake-970fe6ec2fa5c195f157338bb8b9b3c8766e00a3.tar.bz2 |
Merge branch 'doc-cmake-language-makefile-vars' into release
Diffstat (limited to 'Help')
-rw-r--r-- | Help/manual/cmake-language.7.rst | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/Help/manual/cmake-language.7.rst b/Help/manual/cmake-language.7.rst index ba0b30f..27b5d30 100644 --- a/Help/manual/cmake-language.7.rst +++ b/Help/manual/cmake-language.7.rst @@ -329,11 +329,17 @@ For example: To support legacy CMake code, unquoted arguments may also contain double-quoted strings (``"..."``, possibly enclosing horizontal whitespace), and make-style variable references (``$(MAKEVAR)``). + Unescaped double-quotes must balance, may not appear at the beginning of an unquoted argument, and are treated as part of the content. For example, the unquoted arguments ``-Da="b c"``, ``-Da=$(v)``, and ``a" "b"c"d`` are each interpreted literally. + Make-style references are treated literally as part of the content + and do not undergo variable expansion. They are treated as part + of a single argument (rather than as separate ``$``, ``(``, + ``MAKEVAR``, and ``)`` arguments). + The above "unquoted_legacy" production represents such arguments. We do not recommend using legacy unquoted arguments in new code. Instead use a `Quoted Argument`_ or a `Bracket Argument`_ to |