summaryrefslogtreecommitdiffstats
path: root/Help/command/LINK_OPTIONS_LINKER.txt
diff options
context:
space:
mode:
authorMarc Chevrier <marc.chevrier@gmail.com>2018-10-25 17:21:11 (GMT)
committerBrad King <brad.king@kitware.com>2018-10-26 13:36:53 (GMT)
commit2f9c2539614c744092cd46149787440639ce9579 (patch)
treea63cc3d801f92c73d4f916e3ab34e3ef0cd79898 /Help/command/LINK_OPTIONS_LINKER.txt
parentfd02538974dd952a8639d371c2c0067d30d5469a (diff)
downloadCMake-2f9c2539614c744092cd46149787440639ce9579.zip
CMake-2f9c2539614c744092cd46149787440639ce9579.tar.gz
CMake-2f9c2539614c744092cd46149787440639ce9579.tar.bz2
Help: clarify "LINKER:" prefix usage
Fixes: #18503
Diffstat (limited to 'Help/command/LINK_OPTIONS_LINKER.txt')
-rw-r--r--Help/command/LINK_OPTIONS_LINKER.txt12
1 files changed, 12 insertions, 0 deletions
diff --git a/Help/command/LINK_OPTIONS_LINKER.txt b/Help/command/LINK_OPTIONS_LINKER.txt
index 76927be..a723375 100644
--- a/Help/command/LINK_OPTIONS_LINKER.txt
+++ b/Help/command/LINK_OPTIONS_LINKER.txt
@@ -8,3 +8,15 @@ driver option and the rest of the option string defines linker arguments using
For example, ``"LINKER:-z,defs"`` becomes ``-Xlinker -z -Xlinker defs`` for
``Clang`` and ``-Wl,-z,defs`` for ``GNU GCC``.
+
+The ``LINKER:`` prefix can be specified as part of a ``SHELL:`` prefix
+expression.
+
+The ``LINKER:`` prefix supports, as alternate syntax, specification of
+arguments using ``SHELL:`` prefix and space as separator. Previous example
+becomes ``"LINKER:SHELL:-z defs"``.
+
+.. note::
+
+ Specifying ``SHELL:`` prefix elsewhere than at the beginning of the
+ ``LINKER:`` prefix is not supported.