summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2017-02-22 21:50:18 (GMT)
committerBrad King <brad.king@kitware.com>2017-02-22 21:50:18 (GMT)
commit970fe6ec2fa5c195f157338bb8b9b3c8766e00a3 (patch)
tree84cddf7c1af8b6ac04a3601dba7eb4ef9486ba98 /Help
parent4734c3e6dbf5cdabcfedb449e92a61471f7664b7 (diff)
parent1dc13019259bd62d63b9295011227029283c2ef7 (diff)
downloadCMake-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.rst6
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