diff options
author | Clinton Stimpson <clinton@elemtech.com> | 2013-12-19 04:25:29 (GMT) |
---|---|---|
committer | Brad King <brad.king@kitware.com> | 2014-01-02 18:41:49 (GMT) |
commit | d25ad482e978cbf5e4fcfa8b1dcc342ba93dcda0 (patch) | |
tree | f0a1f688356d4f346279bacc9203c467a5bb76ac /Help/prop_tgt/MACOSX_RPATH.rst | |
parent | 2a384e08cc0809fec75ebb20be585fb5a1bf591a (diff) | |
download | CMake-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.rst | 16 |
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``. |