summaryrefslogtreecommitdiffstats
path: root/Help/prop_tgt/MACOSX_RPATH.rst
diff options
context:
space:
mode:
authorClinton Stimpson <clinton@elemtech.com>2013-12-19 04:25:29 (GMT)
committerBrad King <brad.king@kitware.com>2014-01-02 18:41:49 (GMT)
commitd25ad482e978cbf5e4fcfa8b1dcc342ba93dcda0 (patch)
treef0a1f688356d4f346279bacc9203c467a5bb76ac /Help/prop_tgt/MACOSX_RPATH.rst
parent2a384e08cc0809fec75ebb20be585fb5a1bf591a (diff)
downloadCMake-d25ad482e978cbf5e4fcfa8b1dcc342ba93dcda0.zip
CMake-d25ad482e978cbf5e4fcfa8b1dcc342ba93dcda0.tar.gz
CMake-d25ad482e978cbf5e4fcfa8b1dcc342ba93dcda0.tar.bz2
OS X: Add CMP0042 to enable MACOSX_RPATH by default
Also adding documentation for CMAKE_MACOSX_RPATH, and improving documentation for MACOSX_RPATH.
Diffstat (limited to 'Help/prop_tgt/MACOSX_RPATH.rst')
-rw-r--r--Help/prop_tgt/MACOSX_RPATH.rst16
1 files changed, 12 insertions, 4 deletions
diff --git a/Help/prop_tgt/MACOSX_RPATH.rst b/Help/prop_tgt/MACOSX_RPATH.rst
index f2d8078..d3934ba 100644
--- a/Help/prop_tgt/MACOSX_RPATH.rst
+++ b/Help/prop_tgt/MACOSX_RPATH.rst
@@ -4,7 +4,15 @@ MACOSX_RPATH
Whether to use rpaths on Mac OS X.
When this property is set to true, the directory portion of
-the"install_name" field of shared libraries will default to
-"@rpath".Runtime paths will also be embedded in binaries using this
-target.This property is initialized by the value of the variable
-CMAKE_MACOSX_RPATH if it is set when a target is created.
+the "install_name" field of shared libraries will be ``@rpath``
+unless overridden by :prop_tgt:`INSTALL_NAME_DIR`. Runtime
+paths will also be embedded in binaries using this target and
+can be controlled by the :prop_tgt:`INSTALL_RPATH` target property.
+This property is initialized by the value of the variable
+:variable:`CMAKE_MACOSX_RPATH` if it is set when a target is
+created.
+
+Policy CMP0042 was introduced to change the default value of
+MACOSX_RPATH to ON. This is because use of ``@rpath`` is a
+more flexible and powerful alternative to ``@executable_path`` and
+``@loader_path``.