mirror of
https://github.com/Kitware/CMake.git
synced 2026-02-21 22:50:26 -06:00
ad3c2c0b03
Every policy's documentation has a paragraph on what version of CMake introduced it, how to set the policy, and whether CMake warns if the policy is not set. The wording of this paragraph has diverged across policies over time. Factor the paragraph out into a standard advice document included by every policy.
22 lines
761 B
ReStructuredText
22 lines
761 B
ReStructuredText
CMP0042
|
|
-------
|
|
|
|
:prop_tgt:`MACOSX_RPATH` is enabled by default.
|
|
|
|
CMake 2.8.12 and newer has support for using ``@rpath`` in a target's install
|
|
name. This was enabled by setting the target property
|
|
:prop_tgt:`MACOSX_RPATH`. The ``@rpath`` in an install name is a more
|
|
flexible and powerful mechanism than ``@executable_path`` or ``@loader_path``
|
|
for locating shared libraries.
|
|
|
|
CMake 3.0 and later prefer this property to be ON by default. Projects
|
|
wanting ``@rpath`` in a target's install name may remove any setting of
|
|
the :prop_tgt:`INSTALL_NAME_DIR` and :variable:`CMAKE_INSTALL_NAME_DIR`
|
|
variables.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.0
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|