mirror of
https://gitlab.kitware.com/cmake/cmake.git
synced 2026-09-25 04:09:36 +03:00
Matthew Woehlke
00959286b9
Introduce `CMD_STRICT` to act as a parent for warnings about allowed but disrecommended usage. Introduce a warning that discourages use of non-target directives (which modify the build environment for the entire [sub]tree). Add notes to the official documentation recommending use of target-specific alternatives. This has been accepted wisdom for quite some time, but only some of the affected commands made any mention of this in the documentation.
53 lines
1.6 KiB
ReStructuredText
53 lines
1.6 KiB
ReStructuredText
add_link_options
|
|
----------------
|
|
|
|
.. versionadded:: 3.13
|
|
|
|
Add options to the link step for executable, shared library or module
|
|
library targets in the current directory and below that are added after
|
|
this command is invoked.
|
|
|
|
.. code-block:: cmake
|
|
|
|
add_link_options(<option> ...)
|
|
|
|
This command can be used to add any link options, but alternative commands
|
|
exist to add libraries (:command:`target_link_libraries` or
|
|
:command:`link_libraries`). See documentation of the
|
|
:prop_dir:`directory <LINK_OPTIONS>` and
|
|
:prop_tgt:`target <LINK_OPTIONS>` ``LINK_OPTIONS`` properties.
|
|
|
|
.. note::
|
|
|
|
This command cannot be used to add options for static library targets,
|
|
since they do not use a linker. To add archiver or MSVC librarian flags,
|
|
see the :prop_tgt:`STATIC_LIBRARY_OPTIONS` target property.
|
|
|
|
.. |command_name| replace:: ``add_link_options``
|
|
.. include:: include/GENEX_NOTE.rst
|
|
|
|
.. |target_command_name| replace:: :command:`target_link_options`
|
|
.. include:: include/NON_TARGET_NOTE.rst
|
|
|
|
.. include:: include/DEVICE_LINK_OPTIONS.rst
|
|
|
|
.. include:: include/OPTIONS_SHELL.rst
|
|
|
|
.. include:: include/LINK_OPTIONS_LINKER.rst
|
|
|
|
See Also
|
|
^^^^^^^^
|
|
|
|
* :command:`link_libraries`
|
|
* :command:`target_link_libraries`
|
|
* :command:`target_link_options`
|
|
|
|
* :variable:`CMAKE_<LANG>_FLAGS` and :variable:`CMAKE_<LANG>_FLAGS_<CONFIG>`
|
|
add language-wide flags passed to all invocations of the compiler.
|
|
This includes invocations that drive compiling and those that drive linking.
|
|
|
|
* .. versionadded:: 4.3
|
|
:variable:`CMAKE_<LANG>_LINK_FLAGS` and
|
|
:variable:`CMAKE_<LANG>_LINK_FLAGS_<CONFIG>` add language-wide flags passed
|
|
to all invocations of the compiler which drive linking.
|