summaryrefslogtreecommitdiff
path: root/share/cmake-3.18/Help/command/OPTIONS_SHELL.txt
diff options
context:
space:
mode:
Diffstat (limited to 'share/cmake-3.18/Help/command/OPTIONS_SHELL.txt')
-rw-r--r--share/cmake-3.18/Help/command/OPTIONS_SHELL.txt9
1 files changed, 9 insertions, 0 deletions
diff --git a/share/cmake-3.18/Help/command/OPTIONS_SHELL.txt b/share/cmake-3.18/Help/command/OPTIONS_SHELL.txt
new file mode 100644
index 0000000..0f8ec32
--- /dev/null
+++ b/share/cmake-3.18/Help/command/OPTIONS_SHELL.txt
@@ -0,0 +1,9 @@
+The final set of compile or link options used for a target is constructed by
+accumulating options from the current target and the usage requirements of
+its 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``.