summaryrefslogtreecommitdiff
path: root/Modules/FindPackageHandleStandardArgs.cmake
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2015-04-15 11:32:26 -0400
committerBrad King <brad.king@kitware.com>2015-04-17 10:46:25 -0400
commit84f06d0c84a7db85561cca044780d3ca92c9c3a3 (patch)
treedc5aeba49abc15be94fd437f6abe13819dde9a45 /Modules/FindPackageHandleStandardArgs.cmake
parenta3ad275ce08784493267604d57207fce14602c48 (diff)
downloadcmake-84f06d0c84a7db85561cca044780d3ca92c9c3a3.tar.gz
FPHSA: Document REQUIRED_VARS recommendation (#15352)
State explicitly that the variables specified are user-facing.
Diffstat (limited to 'Modules/FindPackageHandleStandardArgs.cmake')
-rw-r--r--Modules/FindPackageHandleStandardArgs.cmake4
1 files changed, 4 insertions, 0 deletions
diff --git a/Modules/FindPackageHandleStandardArgs.cmake b/Modules/FindPackageHandleStandardArgs.cmake
index a88eaecd26..1be38af2b2 100644
--- a/Modules/FindPackageHandleStandardArgs.cmake
+++ b/Modules/FindPackageHandleStandardArgs.cmake
@@ -49,6 +49,10 @@ valid filepaths.
``REQUIRED_VARS <required-var>...``
Specify the variables which are required for this package.
+ These may be named in the generated failure message asking the
+ user to set the missing variable values. Therefore these should
+ typically be cache entries such as ``FOO_LIBRARY`` and not output
+ variables like ``FOO_LIBRARIES``.
``VERSION_VAR <version-var>``
Specify the name of a variable that holds the version of the package