echo/CMake
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Help: Add SHELL, LINKER and host/device discussions to property docs

Browse Source 
Section headings are also added for each common block to help guide
the reader and improve navigation.

Fixes: #21640
This commit is contained in:
Craig Scott 2021-05-15 16:12:22 +10:00
parent b20c1f4880
commit 2eba7d7524
6 changed files with 18 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
Help/command/DEVICE_LINK_OPTIONS.txt
View File

@ -1,3 +1,5 @@
Host And Device Specific Link Options
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. versionadded:: 3.18 .. versionadded:: 3.18
When a device link step is involved, which is controlled by When a device link step is involved, which is controlled by

3
Help/command/LINK_OPTIONS_LINKER.txt
View File

@ -1,3 +1,6 @@
Handling Compiler Driver Differences
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
To pass options to the linker tool, each compiler driver has its own syntax. To pass options to the linker tool, each compiler driver has its own syntax.
The ``LINKER:`` prefix and ``,`` separator can be used to specify, in a portable The ``LINKER:`` prefix and ``,`` separator can be used to specify, in a portable
way, options to pass to the linker tool. ``LINKER:`` is replaced by the way, options to pass to the linker tool. ``LINKER:`` is replaced by the

3
Help/command/OPTIONS_SHELL.txt
View File

@ -1,3 +1,6 @@
Option De-duplication
^^^^^^^^^^^^^^^^^^^^^
The final set of 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 accumulating options from the current target and the usage requirements of
its dependencies. The set of options is de-duplicated to avoid repetition. its dependencies. The set of options is de-duplicated to avoid repetition.

2
Help/prop_tgt/COMPILE_OPTIONS.rst
View File

@ -15,3 +15,5 @@ Contents of ``COMPILE_OPTIONS`` may use "generator expressions" with the
syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)` manual syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)` manual
for available expressions. See the :manual:`cmake-buildsystem(7)` manual for available expressions. See the :manual:`cmake-buildsystem(7)` manual
for more on defining buildsystem properties. for more on defining buildsystem properties.
.. include:: ../command/OPTIONS_SHELL.txt

6
Help/prop_tgt/LINK_OPTIONS.rst
View File

@ -28,3 +28,9 @@ for more on defining buildsystem properties.
.. note:: .. note::
This property must be used in preference to :prop_tgt:`LINK_FLAGS` property. This property must be used in preference to :prop_tgt:`LINK_FLAGS` property.
.. include:: ../command/DEVICE_LINK_OPTIONS.txt
.. include:: ../command/OPTIONS_SHELL.txt
.. include:: ../command/LINK_OPTIONS_LINKER.txt

2
Help/prop_tgt/STATIC_LIBRARY_OPTIONS.rst
View File

@ -20,3 +20,5 @@ for more on defining buildsystem properties.
This property must be used in preference to :prop_tgt:`STATIC_LIBRARY_FLAGS` This property must be used in preference to :prop_tgt:`STATIC_LIBRARY_FLAGS`
property. property.
.. include:: ../command/OPTIONS_SHELL.txt