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.
37 lines
1.4 KiB
ReStructuredText
37 lines
1.4 KiB
ReStructuredText
CMP0068
|
|
-------
|
|
|
|
.. versionadded:: 3.9
|
|
|
|
``RPATH`` settings on macOS do not affect ``install_name``.
|
|
|
|
CMake 3.9 and newer remove any effect the following settings may have on the
|
|
``install_name`` of a target on macOS:
|
|
|
|
* :prop_tgt:`BUILD_WITH_INSTALL_RPATH` target property
|
|
* :prop_tgt:`SKIP_BUILD_RPATH` target property
|
|
* :variable:`CMAKE_SKIP_RPATH` variable
|
|
* :variable:`CMAKE_SKIP_INSTALL_RPATH` variable
|
|
|
|
Previously, setting :prop_tgt:`BUILD_WITH_INSTALL_RPATH` had the effect of
|
|
setting both the ``install_name`` of a target to :prop_tgt:`INSTALL_NAME_DIR`
|
|
and the ``RPATH`` to :prop_tgt:`INSTALL_RPATH`. In CMake 3.9, it only affects
|
|
setting of ``RPATH``. However, if one wants :prop_tgt:`INSTALL_NAME_DIR` to
|
|
apply to the target in the build tree, one may set
|
|
:prop_tgt:`BUILD_WITH_INSTALL_NAME_DIR`.
|
|
|
|
If :prop_tgt:`SKIP_BUILD_RPATH`, :variable:`CMAKE_SKIP_RPATH` or
|
|
:variable:`CMAKE_SKIP_INSTALL_RPATH` were used to strip the directory portion
|
|
of the ``install_name`` of a target, one may set ``INSTALL_NAME_DIR=""``
|
|
instead.
|
|
|
|
The ``OLD`` behavior of this policy is to use the ``RPATH`` settings for
|
|
``install_name`` on macOS. The ``NEW`` behavior of this policy is to ignore
|
|
the ``RPATH`` settings for ``install_name`` on macOS.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.9
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|