diff options
| author | Marc Chevrier <marc.chevrier@gmail.com> | 2018-10-25 17:21:11 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2018-10-26 13:36:53 (GMT) |
| commit | 2f9c2539614c744092cd46149787440639ce9579 (patch) | |
| tree | a63cc3d801f92c73d4f916e3ab34e3ef0cd79898 /Help/command | |
| parent | fd02538974dd952a8639d371c2c0067d30d5469a (diff) | |
| download | CMake-2f9c2539614c744092cd46149787440639ce9579.zip CMake-2f9c2539614c744092cd46149787440639ce9579.tar.gz CMake-2f9c2539614c744092cd46149787440639ce9579.tar.bz2 | |
Help: clarify "LINKER:" prefix usage
Fixes: #18503
Diffstat (limited to 'Help/command')
| -rw-r--r-- | Help/command/LINK_OPTIONS_LINKER.txt | 12 | ||||
| -rw-r--r-- | Help/command/add_link_options.rst | 4 | ||||
| -rw-r--r-- | Help/command/target_link_options.rst | 4 |
3 files changed, 16 insertions, 4 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. diff --git a/Help/command/add_link_options.rst b/Help/command/add_link_options.rst index 551d440..e5fb878 100644 --- a/Help/command/add_link_options.rst +++ b/Help/command/add_link_options.rst @@ -21,6 +21,6 @@ the syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)` manual for available expressions. See the :manual:`cmake-buildsystem(7)` manual for more on defining buildsystem properties. -.. include:: LINK_OPTIONS_LINKER.txt - .. include:: OPTIONS_SHELL.txt + +.. include:: LINK_OPTIONS_LINKER.txt diff --git a/Help/command/target_link_options.rst b/Help/command/target_link_options.rst index 8f47180..0b45a8b 100644 --- a/Help/command/target_link_options.rst +++ b/Help/command/target_link_options.rst @@ -37,6 +37,6 @@ with the syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)` manual for available expressions. See the :manual:`cmake-buildsystem(7)` manual for more on defining buildsystem properties. -.. include:: LINK_OPTIONS_LINKER.txt - .. include:: OPTIONS_SHELL.txt + +.. include:: LINK_OPTIONS_LINKER.txt |