diff options
| author | David Aguilar <davvid@gmail.com> | 2018-12-21 00:41:04 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2019-01-16 14:59:46 (GMT) |
| commit | a5e948a36f5d1c1cf6a0ea34b04bbc4b6058e7d9 (patch) | |
| tree | bc00d06b51f88ef5776b106f6be786319e18bc68 /Help/variable | |
| parent | c59eae7ebc5423c2b06befd762f8639b0f23b7a0 (diff) | |
| download | CMake-a5e948a36f5d1c1cf6a0ea34b04bbc4b6058e7d9.zip CMake-a5e948a36f5d1c1cf6a0ea34b04bbc4b6058e7d9.tar.gz CMake-a5e948a36f5d1c1cf6a0ea34b04bbc4b6058e7d9.tar.bz2 | |
find_package: optionally resolve symlinks when discovering packages
Teach find_package() to resolve symlinks when constructing
relocatable prefix paths from discovered cmake config files.
The `CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS` variable enables
this behavior when set to `TRUE`.
Fixes: #18704
Diffstat (limited to 'Help/variable')
| -rw-r--r-- | Help/variable/CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS.rst | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/Help/variable/CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS.rst b/Help/variable/CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS.rst new file mode 100644 index 0000000..dfbde20 --- /dev/null +++ b/Help/variable/CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS.rst @@ -0,0 +1,10 @@ +CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS +----------------------------------- + +Set to ``TRUE`` to tell :command:`find_package` calls to resolve symbolic +links in the value of ``<PackageName>_DIR``. + +This is helpful in use cases where the package search path points at a +proxy directory in which symlinks to the real package locations appear. +This is not enabled by default because there are also common use cases +in which the symlinks should be preserved. |