diff options
| author | Brad King <brad.king@kitware.com> | 2017-02-23 12:35:36 (GMT) |
|---|---|---|
| committer | CMake Topic Stage <kwrobot@kitware.com> | 2017-02-23 12:35:36 (GMT) |
| commit | 3f8e94f71effc552fd13d4d37a5ae367fe896644 (patch) | |
| tree | f8642d91b833c8323cbf846440eb82064adc902d /Help | |
| parent | d23f4414c44b977abc3f9ff49aa06f709a3d9db1 (diff) | |
| parent | 1dc13019259bd62d63b9295011227029283c2ef7 (diff) | |
| download | CMake-3f8e94f71effc552fd13d4d37a5ae367fe896644.zip CMake-3f8e94f71effc552fd13d4d37a5ae367fe896644.tar.gz CMake-3f8e94f71effc552fd13d4d37a5ae367fe896644.tar.bz2 | |
Merge topic 'doc-cmake-language-makefile-vars'
1dc13019 Help: Clarify 'make-style' variable references in cmake-language(7)
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 |