summaryrefslogtreecommitdiffstats
path: root/Help/command
diff options
context:
space:
mode:
authorCraig Scott <craig.scott@crascit.com>2021-05-15 06:12:22 (GMT)
committerCraig Scott <craig.scott@crascit.com>2021-05-15 06:31:16 (GMT)
commit2eba7d75248142483107ca0194c718f4a9f1796d (patch)
tree8bdb090ee5e4558044f091034cc83ec9d0728e92 /Help/command
parentb20c1f4880aa7fb764f4e2a47b92fca846e84941 (diff)
downloadCMake-2eba7d75248142483107ca0194c718f4a9f1796d.zip
CMake-2eba7d75248142483107ca0194c718f4a9f1796d.tar.gz
CMake-2eba7d75248142483107ca0194c718f4a9f1796d.tar.bz2
Help: Add SHELL, LINKER and host/device discussions to property docs
Section headings are also added for each common block to help guide the reader and improve navigation. Fixes: #21640
Diffstat (limited to 'Help/command')
-rw-r--r--Help/command/DEVICE_LINK_OPTIONS.txt2
-rw-r--r--Help/command/LINK_OPTIONS_LINKER.txt3
-rw-r--r--Help/command/OPTIONS_SHELL.txt3
3 files changed, 8 insertions, 0 deletions
diff --git a/Help/command/DEVICE_LINK_OPTIONS.txt b/Help/command/DEVICE_LINK_OPTIONS.txt
index 1297cd0..3d50208 100644
--- a/Help/command/DEVICE_LINK_OPTIONS.txt
+++ b/Help/command/DEVICE_LINK_OPTIONS.txt
@@ -1,3 +1,5 @@
+Host And Device Specific Link Options
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. versionadded:: 3.18
When a device link step is involved, which is controlled by
diff --git a/Help/command/LINK_OPTIONS_LINKER.txt b/Help/command/LINK_OPTIONS_LINKER.txt
index 3f66181..e71e5ea 100644
--- a/Help/command/LINK_OPTIONS_LINKER.txt
+++ b/Help/command/LINK_OPTIONS_LINKER.txt
@@ -1,3 +1,6 @@
+Handling Compiler Driver Differences
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
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
way, options to pass to the linker tool. ``LINKER:`` is replaced by the
diff --git a/Help/command/OPTIONS_SHELL.txt b/Help/command/OPTIONS_SHELL.txt
index 7f03f4e..4171f01 100644
--- a/Help/command/OPTIONS_SHELL.txt
+++ b/Help/command/OPTIONS_SHELL.txt
@@ -1,3 +1,6 @@
+Option De-duplication
+^^^^^^^^^^^^^^^^^^^^^
+
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.