summaryrefslogtreecommitdiffstats
path: root/Modules/FindPackageMessage.cmake
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2008-03-17 15:10:42 (GMT)
committerBrad King <brad.king@kitware.com>2008-03-17 15:10:42 (GMT)
commit7a888b68daa674690088f0beaf1a83fa8e409138 (patch)
treebc21d74ec3f7bcf2ceba288da2cf0610f5fcfff1 /Modules/FindPackageMessage.cmake
parent98e06794dd2b4554e1fc82314edc9a5c7a232d7d (diff)
downloadCMake-7a888b68daa674690088f0beaf1a83fa8e409138.zip
CMake-7a888b68daa674690088f0beaf1a83fa8e409138.tar.gz
CMake-7a888b68daa674690088f0beaf1a83fa8e409138.tar.bz2
ENH: Added FindPackageMessage module
- Defines FIND_PACKAGE_MESSAGE function to help display find result messages only once - Added use of it to FindPackageHandleStandardArgs - Added use of it to FindQt4, and FindX11 - This cleans up repeated messages in big projects
Diffstat (limited to 'Modules/FindPackageMessage.cmake')
-rw-r--r--Modules/FindPackageMessage.cmake35
1 files changed, 35 insertions, 0 deletions
diff --git a/Modules/FindPackageMessage.cmake b/Modules/FindPackageMessage.cmake
new file mode 100644
index 0000000..1106e0e
--- /dev/null
+++ b/Modules/FindPackageMessage.cmake
@@ -0,0 +1,35 @@
+# FIND_PACKAGE_MESSAGE(<name> "message for user" "find result details")
+#
+# This macro is intended to be used in FindXXX.cmake modules files.
+# It will print a message once for each unique find result.
+# This is useful for telling the user where a package was found.
+# The first argument specifies the name (XXX) of the package.
+# The second argument specifies the message to display.
+# The third argument lists details about the find result so that
+# if they change the message will be displayed again.
+# The macro also obeys the QUIET argument to the find_package command.
+#
+# Example:
+#
+# IF(X11_FOUND)
+# FIND_PACKAGE_MESSAGE(X11 "Found X11: ${X11_X11_LIB}"
+# "[${X11_X11_LIB}][${X11_INCLUDE_DIR}]")
+# ELSE(X11_FOUND)
+# ...
+# ENDIF(X11_FOUND)
+
+FUNCTION(FIND_PACKAGE_MESSAGE pkg msg details)
+ # Avoid printing a message repeatedly for the same find result.
+ IF(NOT ${pkg}_FIND_QUIETLY)
+ SET(DETAILS_VAR FIND_PACKAGE_MESSAGE_DETAILS_${pkg})
+ IF(NOT "${details}" STREQUAL "${${DETAILS_VAR}}")
+ # The message has not yet been printed.
+ MESSAGE(STATUS "${msg}")
+
+ # Save the find details in the cache to avoid printing the same
+ # message again.
+ SET("${DETAILS_VAR}" "${details}"
+ CACHE INTERNAL "Details about finding ${pkg}")
+ ENDIF(NOT "${details}" STREQUAL "${${DETAILS_VAR}}")
+ ENDIF(NOT ${pkg}_FIND_QUIETLY)
+ENDFUNCTION(FIND_PACKAGE_MESSAGE)