1CMP0042
2-------
3
4:prop_tgt:`MACOSX_RPATH` is enabled by default.
5
6CMake 2.8.12 and newer has support for using ``@rpath`` in a target's install
7name.  This was enabled by setting the target property
8:prop_tgt:`MACOSX_RPATH`.  The ``@rpath`` in an install name is a more
9flexible and powerful mechanism than ``@executable_path`` or ``@loader_path``
10for locating shared libraries.
11
12CMake 3.0 and later prefer this property to be ON by default.  Projects
13wanting ``@rpath`` in a target's install name may remove any setting of
14the :prop_tgt:`INSTALL_NAME_DIR` and :variable:`CMAKE_INSTALL_NAME_DIR`
15variables.
16
17This policy was introduced in CMake version 3.0.  CMake version
18|release| warns when the policy is not set and uses ``OLD`` behavior.  Use
19the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.
20
21.. include:: DEPRECATED.txt
22