diff options
| author | Brad King <brad.king@kitware.com> | 2018-03-15 11:55:09 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2018-03-15 11:55:14 (GMT) |
| commit | 2ab900c71b21a0faae46573c2720d867a896bb29 (patch) | |
| tree | 44b1045a1eb430159d7c97a1d0c599c95cf37a17 /Help/command | |
| parent | 67232619319dfa3ebfaa5f1cda141bfec6b3ee9b (diff) | |
| parent | ce0b9832163624291db04d38984c6aa7ea8ca7d7 (diff) | |
| download | CMake-2ab900c71b21a0faae46573c2720d867a896bb29.zip CMake-2ab900c71b21a0faae46573c2720d867a896bb29.tar.gz CMake-2ab900c71b21a0faae46573c2720d867a896bb29.tar.bz2 | |
Merge topic 'compile-options-shell'
ce0b983216 target_compile_options: Add syntax to specify shell strings
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !1841
Diffstat (limited to 'Help/command')
| -rw-r--r-- | Help/command/COMPILE_OPTIONS_SHELL.txt | 9 | ||||
| -rw-r--r-- | Help/command/add_compile_options.rst | 2 | ||||
| -rw-r--r-- | Help/command/target_compile_options.rst | 2 |
3 files changed, 13 insertions, 0 deletions
diff --git a/Help/command/COMPILE_OPTIONS_SHELL.txt b/Help/command/COMPILE_OPTIONS_SHELL.txt new file mode 100644 index 0000000..a1316c8 --- /dev/null +++ b/Help/command/COMPILE_OPTIONS_SHELL.txt @@ -0,0 +1,9 @@ +The final set of compile options used for a target is constructed by +accumulating options from the current target and the usage requirements of +it dependencies. The set of options is de-duplicated to avoid repetition. +While beneficial for individual options, the de-duplication step can break +up option groups. For example, ``-D A -D B`` becomes ``-D A B``. One may +specify a group of options using shell-like quoting along with a ``SHELL:`` +prefix. The ``SHELL:`` prefix is dropped and the rest of the option string +is parsed using the :command:`separate_arguments` ``UNIX_COMMAND`` mode. +For example, ``"SHELL:-D A" "SHELL:-D B"`` becomes ``-D A -D B``. diff --git a/Help/command/add_compile_options.rst b/Help/command/add_compile_options.rst index 3fe2a33..44924e6 100644 --- a/Help/command/add_compile_options.rst +++ b/Help/command/add_compile_options.rst @@ -21,3 +21,5 @@ Arguments to ``add_compile_options`` may use "generator expressions" with the syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)` manual for available expressions. See the :manual:`cmake-buildsystem(7)` manual for more on defining buildsystem properties. + +.. include:: COMPILE_OPTIONS_SHELL.txt diff --git a/Help/command/target_compile_options.rst b/Help/command/target_compile_options.rst index 3e7dc47..b7b4dc1 100644 --- a/Help/command/target_compile_options.rst +++ b/Help/command/target_compile_options.rst @@ -38,3 +38,5 @@ Arguments to ``target_compile_options`` may use "generator expressions" with the syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)` manual for available expressions. See the :manual:`cmake-buildsystem(7)` manual for more on defining buildsystem properties. + +.. include:: COMPILE_OPTIONS_SHELL.txt |