summaryrefslogtreecommitdiffstats
path: root/Help/command/OPTIONS_SHELL.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Help/command/OPTIONS_SHELL.txt')
-rw-r--r--Help/command/OPTIONS_SHELL.txt13
1 files changed, 7 insertions, 6 deletions
diff --git a/Help/command/OPTIONS_SHELL.txt b/Help/command/OPTIONS_SHELL.txt
index 4051ffe..7f03f4e 100644
--- a/Help/command/OPTIONS_SHELL.txt
+++ b/Help/command/OPTIONS_SHELL.txt
@@ -1,11 +1,12 @@
-The final set of compile or link options used for a target is constructed by
+The final set of 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.
.. versionadded:: 3.12
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``.
+ up option groups. For example, ``-option A -option B`` becomes
+ ``-option 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:-option A" "SHELL:-option B"`` becomes ``-option A -option B``.