mirror/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2026-02-18 05:01:50 -06:00
Code Issues Packages Projects Releases Wiki Activity

Help: Fix typos and style in add_link_options documentation

Browse Source
This commit is contained in:
Tom Lankhorst
2019-10-15 21:35:50 +02:00
committed by Brad King
parent 9150c818b7
commit a7ef28b9d8
2 changed files with 11 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
Help/command/LINK_OPTIONS_LINKER.txt
View File

@@ -1,8 +1,8 @@
To pass options to the linker tool, each compiler driver has is own syntax. To pass options to the linker tool, each compiler driver has its own syntax.
The ``LINKER:`` prefix can be used to specify, in a portable way, options The ``LINKER:`` prefix and ``,`` separator can be used to specify, in a portable
to pass to the linker tool. The ``LINKER:`` prefix is replaced by the required way, options to pass to the linker tool. ``LINKER:`` is replaced by the
driver option and the rest of the option string defines linker arguments using appropriate driver option and ``,`` by the appropriate driver separator.
``,`` as separator. These arguments will be formatted according to the The driver prefix and driver separator are given by the values of the
:variable:`CMAKE_<LANG>_LINKER_WRAPPER_FLAG` and :variable:`CMAKE_<LANG>_LINKER_WRAPPER_FLAG` and
:variable:`CMAKE_<LANG>_LINKER_WRAPPER_FLAG_SEP` variables. :variable:`CMAKE_<LANG>_LINKER_WRAPPER_FLAG_SEP` variables.
@@ -12,11 +12,11 @@ For example, ``"LINKER:-z,defs"`` becomes ``-Xlinker -z -Xlinker defs`` for
The ``LINKER:`` prefix can be specified as part of a ``SHELL:`` prefix The ``LINKER:`` prefix can be specified as part of a ``SHELL:`` prefix
expression. expression.
The ``LINKER:`` prefix supports, as alternate syntax, specification of The ``LINKER:`` prefix supports, as an alternative syntax, specification of
arguments using ``SHELL:`` prefix and space as separator. Previous example arguments using the ``SHELL:`` prefix and space as separator. The previous
becomes ``"LINKER:SHELL:-z defs"``. example then becomes ``"LINKER:SHELL:-z defs"``.
.. note:: .. note::
Specifying ``SHELL:`` prefix elsewhere than at the beginning of the Specifying the ``SHELL:`` prefix anywhere other than at the beginning of the
``LINKER:`` prefix is not supported. ``LINKER:`` prefix is not supported.

4
Help/command/OPTIONS_SHELL.txt
View File

@@ -1,9 +1,9 @@
The final set of compile or link options used for a target is constructed by The final set of compile or link 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
it dependencies. The set of options is de-duplicated to avoid repetition. its dependencies. The set of options is de-duplicated to avoid repetition.
While beneficial for individual options, the de-duplication step can break While beneficial for individual options, the de-duplication step can break
up option groups. For example, ``-D A -D B`` becomes ``-D A B``. One may up option groups. For example, ``-D A -D B`` becomes ``-D A B``. One may
specify a group of options using shell-like quoting along with a ``SHELL:`` specify a group of options using shell-like quoting along with a ``SHELL:``
prefix. The ``SHELL:`` prefix is dropped and the rest of the option string prefix. The ``SHELL:`` prefix is dropped, and the rest of the option string
is parsed using the :command:`separate_arguments` ``UNIX_COMMAND`` mode. is parsed using the :command:`separate_arguments` ``UNIX_COMMAND`` mode.
For example, ``"SHELL:-D A" "SHELL:-D B"`` becomes ``-D A -D B``. For example, ``"SHELL:-D A" "SHELL:-D B"`` becomes ``-D A -D B``.