summaryrefslogtreecommitdiffstats
path: root/Help/variable
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2019-01-21 12:47:22 (GMT)
committerKitware Robot <kwrobot@kitware.com>2019-01-21 12:47:29 (GMT)
commitd1aa2e11092acdcc22b333e219187026d38549a5 (patch)
treeeaba8a9e22decb92d4af7427667ec5e07fe0fe87 /Help/variable
parentfefae527c8c54d249c44313d9b09cdb0157e2f5d (diff)
parentb773e58099b2fc8ebdf8319172fb018d0139396d (diff)
downloadCMake-d1aa2e11092acdcc22b333e219187026d38549a5.zip
CMake-d1aa2e11092acdcc22b333e219187026d38549a5.tar.gz
CMake-d1aa2e11092acdcc22b333e219187026d38549a5.tar.bz2
Merge topic 'find-package-resolve-symlinks'
b773e58099 find_package: add test coverage for CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS a5e948a36f find_package: optionally resolve symlinks when discovering packages Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2798
Diffstat (limited to 'Help/variable')
-rw-r--r--Help/variable/CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS.rst10
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.