OPTIONS_SHELL.txt 706 B

1234567891011
  1. The final set of compile or link options used for a target is constructed by
  2. accumulating options from the current target and the usage requirements of
  3. its dependencies. The set of options is de-duplicated to avoid repetition.
  4. .. versionadded:: 3.12
  5. While beneficial for individual options, the de-duplication step can break
  6. up option groups. For example, ``-D A -D B`` becomes ``-D A B``. One may
  7. specify a group of options using shell-like quoting along with a ``SHELL:``
  8. prefix. The ``SHELL:`` prefix is dropped, and the rest of the option string
  9. is parsed using the :command:`separate_arguments` ``UNIX_COMMAND`` mode.
  10. For example, ``"SHELL:-D A" "SHELL:-D B"`` becomes ``-D A -D B``.