summaryrefslogtreecommitdiffstats
path: root/Help/release
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2018-03-12 13:10:57 (GMT)
committerBrad King <brad.king@kitware.com>2018-03-14 15:10:25 (GMT)
commitce0b9832163624291db04d38984c6aa7ea8ca7d7 (patch)
tree9e1bf0f74675e752b6582f2f239b953c1271521c /Help/release
parentb340cacde869102b2b548b2e7ebc7341334f1d58 (diff)
downloadCMake-ce0b9832163624291db04d38984c6aa7ea8ca7d7.zip
CMake-ce0b9832163624291db04d38984c6aa7ea8ca7d7.tar.gz
CMake-ce0b9832163624291db04d38984c6aa7ea8ca7d7.tar.bz2
target_compile_options: Add syntax to specify shell strings
Options specified via `COMPILE_OPTIONS` and `INTERFACE_COMPILE_OPTIONS` are deduplicated, but individual options can legitimately be duplicated when grouped with other options, e.g. -D A -D B After deduplication that becomes `-D A B`. Therefore we need a way to treat groups of options as units during deduplication. A simple approach is to specify each group as one option, e.g. "-D A" "-D B" However, that conflicts with options that legitimately have spaces. To break this ambiguity, add a `SHELL:` prefix syntax to specify that an option should be parsed like shell command line arguments after deduplication, e.g. "SHELL:-D A" "SHELL:-D B" These will survive deduplication intact, and then be parsed to produce `-D A -D B` on the final command line. Fixes: #15826
Diffstat (limited to 'Help/release')
-rw-r--r--Help/release/dev/compile-options-shell.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/Help/release/dev/compile-options-shell.rst b/Help/release/dev/compile-options-shell.rst
new file mode 100644
index 0000000..3f83e0c
--- /dev/null
+++ b/Help/release/dev/compile-options-shell.rst
@@ -0,0 +1,6 @@
+compile-options-shell
+---------------------
+
+* :command:`target_compile_options` and :command:`add_compile_options`
+ commands gained a ``SHELL:`` prefix to specify a group of related
+ options using shell-like quoting.