2013-10-15 19:17:36 +04:00
|
|
|
#.rst:
|
|
|
|
# FeatureSummary
|
|
|
|
# --------------
|
2007-08-07 23:41:57 +04:00
|
|
|
#
|
2013-10-15 19:17:36 +04:00
|
|
|
# Macros for generating a summary of enabled/disabled features
|
|
|
|
#
|
|
|
|
#
|
|
|
|
#
|
|
|
|
# This module provides the macros feature_summary(),
|
|
|
|
# set_package_properties() and add_feature_info(). For compatibility it
|
|
|
|
# also still provides set_package_info(), set_feature_info(),
|
2011-07-17 23:23:13 +04:00
|
|
|
# print_enabled_features() and print_disabled_features().
|
2010-08-25 23:53:16 +04:00
|
|
|
#
|
|
|
|
# These macros can be used to generate a summary of enabled and disabled
|
|
|
|
# packages and/or feature for a build tree:
|
|
|
|
#
|
2013-10-15 19:17:36 +04:00
|
|
|
# ::
|
|
|
|
#
|
|
|
|
# -- The following OPTIONAL packages have been found:
|
2014-11-06 21:50:40 +03:00
|
|
|
# LibXml2 (required version >= 2.4), XML processing lib, <http://xmlsoft.org>
|
2013-10-15 19:17:36 +04:00
|
|
|
# * Enables HTML-import in MyWordProcessor
|
|
|
|
# * Enables odt-export in MyWordProcessor
|
|
|
|
# PNG , A PNG image library. , <http://www.libpng.org/pub/png/>
|
|
|
|
# * Enables saving screenshots
|
|
|
|
# -- The following OPTIONAL packages have not been found:
|
|
|
|
# Lua51 , The Lua scripting language. , <http://www.lua.org>
|
|
|
|
# * Enables macros in MyWordProcessor
|
|
|
|
# Foo , Foo provides cool stuff.
|
|
|
|
#
|
|
|
|
#
|
|
|
|
#
|
|
|
|
#
|
|
|
|
#
|
|
|
|
# ::
|
|
|
|
#
|
|
|
|
# FEATURE_SUMMARY( [FILENAME <file>]
|
|
|
|
# [APPEND]
|
|
|
|
# [VAR <variable_name>]
|
|
|
|
# [INCLUDE_QUIET_PACKAGES]
|
|
|
|
# [FATAL_ON_MISSING_REQUIRED_PACKAGES]
|
|
|
|
# [DESCRIPTION "Found packages:"]
|
|
|
|
# WHAT (ALL | PACKAGES_FOUND | PACKAGES_NOT_FOUND
|
2015-01-23 01:48:38 +03:00
|
|
|
# | ENABLED_FEATURES | DISABLED_FEATURES)
|
2013-10-15 19:17:36 +04:00
|
|
|
# )
|
|
|
|
#
|
|
|
|
#
|
|
|
|
#
|
|
|
|
# The FEATURE_SUMMARY() macro can be used to print information about
|
|
|
|
# enabled or disabled packages or features of a project. By default,
|
|
|
|
# only the names of the features/packages will be printed and their
|
|
|
|
# required version when one was specified. Use SET_PACKAGE_PROPERTIES()
|
|
|
|
# to add more useful information, like e.g. a download URL for the
|
|
|
|
# respective package or their purpose in the project.
|
|
|
|
#
|
|
|
|
# The WHAT option is the only mandatory option. Here you specify what
|
|
|
|
# information will be printed:
|
|
|
|
#
|
2014-10-22 23:52:31 +04:00
|
|
|
# ``ALL``
|
|
|
|
# print everything
|
|
|
|
# ``ENABLED_FEATURES``
|
|
|
|
# the list of all features which are enabled
|
|
|
|
# ``DISABLED_FEATURES``
|
|
|
|
# the list of all features which are disabled
|
|
|
|
# ``PACKAGES_FOUND``
|
|
|
|
# the list of all packages which have been found
|
|
|
|
# ``PACKAGES_NOT_FOUND``
|
|
|
|
# the list of all packages which have not been found
|
|
|
|
# ``OPTIONAL_PACKAGES_FOUND``
|
|
|
|
# only those packages which have been found which have the type OPTIONAL
|
|
|
|
# ``OPTIONAL_PACKAGES_NOT_FOUND``
|
|
|
|
# only those packages which have not been found which have the type OPTIONAL
|
|
|
|
# ``RECOMMENDED_PACKAGES_FOUND``
|
|
|
|
# only those packages which have been found which have the type RECOMMENDED
|
|
|
|
# ``RECOMMENDED_PACKAGES_NOT_FOUND``
|
|
|
|
# only those packages which have not been found which have the type RECOMMENDED
|
|
|
|
# ``REQUIRED_PACKAGES_FOUND``
|
|
|
|
# only those packages which have been found which have the type REQUIRED
|
|
|
|
# ``REQUIRED_PACKAGES_NOT_FOUND``
|
|
|
|
# only those packages which have not been found which have the type REQUIRED
|
|
|
|
# ``RUNTIME_PACKAGES_FOUND``
|
|
|
|
# only those packages which have been found which have the type RUNTIME
|
|
|
|
# ``RUNTIME_PACKAGES_NOT_FOUND``
|
|
|
|
# only those packages which have not been found which have the type RUNTIME
|
2013-10-15 19:17:36 +04:00
|
|
|
#
|
2014-02-28 20:36:38 +04:00
|
|
|
# With the exception of the ``ALL`` value, these values can be combined
|
|
|
|
# in order to customize the output. For example:
|
|
|
|
#
|
|
|
|
# ::
|
|
|
|
#
|
|
|
|
# feature_summary(WHAT ENABLED_FEATURES DISABLED_FEATURES)
|
|
|
|
#
|
2013-10-15 19:17:36 +04:00
|
|
|
#
|
|
|
|
#
|
|
|
|
# If a FILENAME is given, the information is printed into this file. If
|
|
|
|
# APPEND is used, it is appended to this file, otherwise the file is
|
|
|
|
# overwritten if it already existed. If the VAR option is used, the
|
|
|
|
# information is "printed" into the specified variable. If FILENAME is
|
|
|
|
# not used, the information is printed to the terminal. Using the
|
|
|
|
# DESCRIPTION option a description or headline can be set which will be
|
|
|
|
# printed above the actual content. If INCLUDE_QUIET_PACKAGES is given,
|
|
|
|
# packages which have been searched with find_package(... QUIET) will
|
|
|
|
# also be listed. By default they are skipped. If
|
|
|
|
# FATAL_ON_MISSING_REQUIRED_PACKAGES is given, CMake will abort if a
|
|
|
|
# package which is marked as REQUIRED has not been found.
|
2010-08-25 00:59:01 +04:00
|
|
|
#
|
|
|
|
# Example 1, append everything to a file:
|
2013-10-15 19:17:36 +04:00
|
|
|
#
|
|
|
|
# ::
|
|
|
|
#
|
|
|
|
# feature_summary(WHAT ALL
|
|
|
|
# FILENAME ${CMAKE_BINARY_DIR}/all.log APPEND)
|
|
|
|
#
|
|
|
|
#
|
|
|
|
#
|
|
|
|
# Example 2, print the enabled features into the variable
|
|
|
|
# enabledFeaturesText, including QUIET packages:
|
|
|
|
#
|
|
|
|
# ::
|
|
|
|
#
|
|
|
|
# feature_summary(WHAT ENABLED_FEATURES
|
|
|
|
# INCLUDE_QUIET_PACKAGES
|
|
|
|
# DESCRIPTION "Enabled Features:"
|
|
|
|
# VAR enabledFeaturesText)
|
|
|
|
# message(STATUS "${enabledFeaturesText}")
|
|
|
|
#
|
|
|
|
#
|
|
|
|
#
|
|
|
|
#
|
|
|
|
#
|
|
|
|
# ::
|
|
|
|
#
|
2014-10-22 23:52:31 +04:00
|
|
|
# SET_PACKAGE_PROPERTIES(<name> PROPERTIES
|
|
|
|
# [ URL <url> ]
|
|
|
|
# [ DESCRIPTION <description> ]
|
|
|
|
# [ TYPE (RUNTIME|OPTIONAL|RECOMMENDED|REQUIRED) ]
|
|
|
|
# [ PURPOSE <purpose> ]
|
2013-10-15 19:17:36 +04:00
|
|
|
# )
|
|
|
|
#
|
|
|
|
#
|
|
|
|
#
|
|
|
|
# Use this macro to set up information about the named package, which
|
|
|
|
# can then be displayed via FEATURE_SUMMARY(). This can be done either
|
|
|
|
# directly in the Find-module or in the project which uses the module
|
|
|
|
# after the find_package() call. The features for which information can
|
|
|
|
# be set are added automatically by the find_package() command.
|
|
|
|
#
|
|
|
|
# URL: this should be the homepage of the package, or something similar.
|
2011-07-17 23:23:13 +04:00
|
|
|
# Ideally this is set already directly in the Find-module.
|
|
|
|
#
|
2013-10-15 19:17:36 +04:00
|
|
|
# DESCRIPTION: A short description what that package is, at most one
|
|
|
|
# sentence. Ideally this is set already directly in the Find-module.
|
|
|
|
#
|
|
|
|
# TYPE: What type of dependency has the using project on that package.
|
|
|
|
# Default is OPTIONAL. In this case it is a package which can be used
|
|
|
|
# by the project when available at buildtime, but it also work without.
|
|
|
|
# RECOMMENDED is similar to OPTIONAL, i.e. the project will build if
|
|
|
|
# the package is not present, but the functionality of the resulting
|
|
|
|
# binaries will be severly limited. If a REQUIRED package is not
|
|
|
|
# available at buildtime, the project may not even build. This can be
|
|
|
|
# combined with the FATAL_ON_MISSING_REQUIRED_PACKAGES argument for
|
|
|
|
# feature_summary(). Last, a RUNTIME package is a package which is
|
|
|
|
# actually not used at all during the build, but which is required for
|
|
|
|
# actually running the resulting binaries. So if such a package is
|
|
|
|
# missing, the project can still be built, but it may not work later on.
|
|
|
|
# If set_package_properties() is called multiple times for the same
|
|
|
|
# package with different TYPEs, the TYPE is only changed to higher TYPEs
|
|
|
|
# ( RUNTIME < OPTIONAL < RECOMMENDED < REQUIRED ), lower TYPEs are
|
|
|
|
# ignored. The TYPE property is project-specific, so it cannot be set
|
|
|
|
# by the Find-module, but must be set in the project.
|
|
|
|
#
|
|
|
|
# PURPOSE: This describes which features this package enables in the
|
|
|
|
# project, i.e. it tells the user what functionality he gets in the
|
|
|
|
# resulting binaries. If set_package_properties() is called multiple
|
|
|
|
# times for a package, all PURPOSE properties are appended to a list of
|
|
|
|
# purposes of the package in the project. As the TYPE property, also
|
|
|
|
# the PURPOSE property is project-specific, so it cannot be set by the
|
|
|
|
# Find-module, but must be set in the project.
|
|
|
|
#
|
2011-07-17 23:23:13 +04:00
|
|
|
#
|
|
|
|
#
|
2010-08-25 01:08:41 +04:00
|
|
|
# Example for setting the info for a package:
|
2013-10-15 19:17:36 +04:00
|
|
|
#
|
|
|
|
# ::
|
|
|
|
#
|
|
|
|
# find_package(LibXml2)
|
2014-10-22 23:52:31 +04:00
|
|
|
# set_package_properties(LibXml2 PROPERTIES
|
|
|
|
# DESCRIPTION "A XML processing library."
|
|
|
|
# URL "http://xmlsoft.org/")
|
2013-10-15 19:17:36 +04:00
|
|
|
#
|
|
|
|
#
|
|
|
|
#
|
|
|
|
# ::
|
|
|
|
#
|
2014-10-22 23:52:31 +04:00
|
|
|
# set_package_properties(LibXml2 PROPERTIES
|
|
|
|
# TYPE RECOMMENDED
|
|
|
|
# PURPOSE "Enables HTML-import in MyWordProcessor")
|
2013-10-15 19:17:36 +04:00
|
|
|
# ...
|
2014-10-22 23:52:31 +04:00
|
|
|
# set_package_properties(LibXml2 PROPERTIES
|
|
|
|
# TYPE OPTIONAL
|
|
|
|
# PURPOSE "Enables odt-export in MyWordProcessor")
|
2013-10-15 19:17:36 +04:00
|
|
|
#
|
|
|
|
#
|
|
|
|
#
|
|
|
|
# ::
|
|
|
|
#
|
|
|
|
# find_package(DBUS)
|
2014-10-22 23:52:31 +04:00
|
|
|
# set_package_properties(DBUS PROPERTIES
|
|
|
|
# TYPE RUNTIME
|
|
|
|
# PURPOSE "Necessary to disable the screensaver during a presentation" )
|
2013-10-15 19:17:36 +04:00
|
|
|
#
|
|
|
|
#
|
|
|
|
#
|
|
|
|
# ::
|
|
|
|
#
|
|
|
|
# ADD_FEATURE_INFO(<name> <enabled> <description>)
|
|
|
|
#
|
|
|
|
# Use this macro to add information about a feature with the given
|
|
|
|
# <name>. <enabled> contains whether this feature is enabled or not,
|
|
|
|
# <description> is a text describing the feature. The information can
|
|
|
|
# be displayed using feature_summary() for ENABLED_FEATURES and
|
|
|
|
# DISABLED_FEATURES respectively.
|
2010-08-25 23:53:16 +04:00
|
|
|
#
|
|
|
|
# Example for setting the info for a feature:
|
|
|
|
#
|
2013-10-15 19:17:36 +04:00
|
|
|
# ::
|
|
|
|
#
|
|
|
|
# option(WITH_FOO "Help for foo" ON)
|
|
|
|
# add_feature_info(Foo WITH_FOO "The Foo feature provides very cool stuff.")
|
|
|
|
#
|
|
|
|
#
|
|
|
|
#
|
|
|
|
#
|
|
|
|
#
|
|
|
|
# The following macros are provided for compatibility with previous
|
|
|
|
# CMake versions:
|
|
|
|
#
|
|
|
|
# ::
|
|
|
|
#
|
|
|
|
# SET_PACKAGE_INFO(<name> <description> [<url> [<purpose>] ] )
|
|
|
|
#
|
|
|
|
# Use this macro to set up information about the named package, which
|
|
|
|
# can then be displayed via FEATURE_SUMMARY(). This can be done either
|
|
|
|
# directly in the Find-module or in the project which uses the module
|
|
|
|
# after the find_package() call. The features for which information can
|
|
|
|
# be set are added automatically by the find_package() command.
|
|
|
|
#
|
|
|
|
# ::
|
|
|
|
#
|
|
|
|
# PRINT_ENABLED_FEATURES()
|
|
|
|
#
|
|
|
|
# Does the same as FEATURE_SUMMARY(WHAT ENABLED_FEATURES DESCRIPTION
|
|
|
|
# "Enabled features:")
|
|
|
|
#
|
|
|
|
# ::
|
2010-08-25 23:53:16 +04:00
|
|
|
#
|
2013-10-15 19:17:36 +04:00
|
|
|
# PRINT_DISABLED_FEATURES()
|
2010-08-25 01:08:41 +04:00
|
|
|
#
|
2013-10-15 19:17:36 +04:00
|
|
|
# Does the same as FEATURE_SUMMARY(WHAT DISABLED_FEATURES DESCRIPTION
|
|
|
|
# "Disabled features:")
|
2011-07-17 23:23:13 +04:00
|
|
|
#
|
2013-10-15 19:17:36 +04:00
|
|
|
# ::
|
2010-08-25 00:59:01 +04:00
|
|
|
#
|
2013-10-15 19:17:36 +04:00
|
|
|
# SET_FEATURE_INFO(<name> <description> [<url>] )
|
2010-08-25 23:53:16 +04:00
|
|
|
#
|
2011-07-17 18:03:38 +04:00
|
|
|
# Does the same as SET_PACKAGE_INFO(<name> <description> <url> )
|
2007-08-07 23:41:57 +04:00
|
|
|
|
2009-09-28 19:46:51 +04:00
|
|
|
#=============================================================================
|
2015-01-23 01:48:38 +03:00
|
|
|
# Copyright 2007-2015 Kitware, Inc.
|
2009-09-28 19:46:51 +04:00
|
|
|
#
|
|
|
|
# Distributed under the OSI-approved BSD License (the "License");
|
|
|
|
# see accompanying file Copyright.txt for details.
|
|
|
|
#
|
|
|
|
# This software is distributed WITHOUT ANY WARRANTY; without even the
|
|
|
|
# implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
|
|
# See the License for more information.
|
|
|
|
#=============================================================================
|
2010-08-07 04:48:47 +04:00
|
|
|
# (To distribute this file outside of CMake, substitute the full
|
2009-09-28 19:46:51 +04:00
|
|
|
# License text for the above reference.)
|
2007-08-07 23:41:57 +04:00
|
|
|
|
2012-11-04 00:35:44 +04:00
|
|
|
include("${CMAKE_CURRENT_LIST_DIR}/CMakeParseArguments.cmake")
|
2010-08-24 23:24:54 +04:00
|
|
|
|
2010-08-25 23:53:16 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
function(ADD_FEATURE_INFO _name _enabled _desc)
|
|
|
|
if (${_enabled})
|
|
|
|
set_property(GLOBAL APPEND PROPERTY ENABLED_FEATURES "${_name}")
|
|
|
|
else ()
|
|
|
|
set_property(GLOBAL APPEND PROPERTY DISABLED_FEATURES "${_name}")
|
|
|
|
endif ()
|
2010-08-25 23:53:16 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
set_property(GLOBAL PROPERTY _CMAKE_${_name}_DESCRIPTION "${_desc}" )
|
2012-08-13 21:50:14 +04:00
|
|
|
endfunction()
|
2010-08-25 23:53:16 +04:00
|
|
|
|
|
|
|
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
function(SET_PACKAGE_PROPERTIES _name _props)
|
|
|
|
if(NOT "${_props}" STREQUAL "PROPERTIES")
|
|
|
|
message(FATAL_ERROR "PROPERTIES keyword is missing in SET_PACKAGE_PROPERTIES() call.")
|
|
|
|
endif()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
set(options ) # none
|
|
|
|
set(oneValueArgs DESCRIPTION URL TYPE PURPOSE )
|
|
|
|
set(multiValueArgs ) # none
|
2011-07-17 17:57:50 +04:00
|
|
|
|
|
|
|
CMAKE_PARSE_ARGUMENTS(_SPP "${options}" "${oneValueArgs}" "${multiValueArgs}" ${ARGN})
|
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
if(_SPP_UNPARSED_ARGUMENTS)
|
|
|
|
message(FATAL_ERROR "Unknown keywords given to SET_PACKAGE_PROPERTIES(): \"${_SPP_UNPARSED_ARGUMENTS}\"")
|
|
|
|
endif()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
if(_SPP_DESCRIPTION)
|
|
|
|
get_property(_info GLOBAL PROPERTY _CMAKE_${_name}_DESCRIPTION)
|
|
|
|
if(_info AND NOT "${_info}" STREQUAL "${_SPP_DESCRIPTION}")
|
|
|
|
message(STATUS "Warning: Property DESCRIPTION for package ${_name} already set to \"${_info}\", overriding it with \"${_SPP_DESCRIPTION}\"")
|
|
|
|
endif()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
set_property(GLOBAL PROPERTY _CMAKE_${_name}_DESCRIPTION "${_SPP_DESCRIPTION}" )
|
|
|
|
endif()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
if(_SPP_URL)
|
|
|
|
get_property(_info GLOBAL PROPERTY _CMAKE_${_name}_URL)
|
|
|
|
if(_info AND NOT "${_info}" STREQUAL "${_SPP_URL}")
|
|
|
|
message(STATUS "Warning: Property URL already set to \"${_info}\", overriding it with \"${_SPP_URL}\"")
|
|
|
|
endif()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
set_property(GLOBAL PROPERTY _CMAKE_${_name}_URL "${_SPP_URL}" )
|
|
|
|
endif()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
|
|
|
|
|
|
|
# handle the PURPOSE: use APPEND, since there can be multiple purposes for one package inside a project
|
2012-08-13 21:47:32 +04:00
|
|
|
if(_SPP_PURPOSE)
|
|
|
|
set_property(GLOBAL APPEND PROPERTY _CMAKE_${_name}_PURPOSE "${_SPP_PURPOSE}" )
|
|
|
|
endif()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
|
|
|
# handle the TYPE
|
2012-08-13 21:47:32 +04:00
|
|
|
if(NOT _SPP_TYPE)
|
|
|
|
set(_SPP_TYPE OPTIONAL)
|
|
|
|
endif()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2011-07-17 22:41:09 +04:00
|
|
|
# List the supported types, according to their priority
|
2012-08-13 21:47:32 +04:00
|
|
|
set(validTypes "RUNTIME" "OPTIONAL" "RECOMMENDED" "REQUIRED" )
|
|
|
|
list(FIND validTypes ${_SPP_TYPE} _typeIndexInList)
|
|
|
|
if("${_typeIndexInList}" STREQUAL "-1" )
|
|
|
|
message(FATAL_ERROR "Bad package property type ${_SPP_TYPE} used in SET_PACKAGE_PROPERTIES(). "
|
2011-07-17 17:57:50 +04:00
|
|
|
"Valid types are OPTIONAL, RECOMMENDED, REQUIRED and RUNTIME." )
|
2012-08-13 21:47:32 +04:00
|
|
|
endif()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
get_property(_previousType GLOBAL PROPERTY _CMAKE_${_name}_TYPE)
|
|
|
|
list(FIND validTypes "${_previousType}" _prevTypeIndexInList)
|
2011-07-17 22:41:09 +04:00
|
|
|
|
|
|
|
# make sure a previously set TYPE is not overridden with a lower new TYPE:
|
2012-08-13 21:47:32 +04:00
|
|
|
if("${_typeIndexInList}" GREATER "${_prevTypeIndexInList}")
|
|
|
|
set_property(GLOBAL PROPERTY _CMAKE_${_name}_TYPE "${_SPP_TYPE}" )
|
|
|
|
endif()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2012-08-13 21:50:14 +04:00
|
|
|
endfunction()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
|
|
|
|
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
function(_FS_GET_FEATURE_SUMMARY _property _var _includeQuiet)
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
set(_type "ANY")
|
|
|
|
if("${_property}" MATCHES "REQUIRED_")
|
|
|
|
set(_type "REQUIRED")
|
|
|
|
elseif("${_property}" MATCHES "RECOMMENDED_")
|
|
|
|
set(_type "RECOMMENDED")
|
|
|
|
elseif("${_property}" MATCHES "RUNTIME_")
|
|
|
|
set(_type "RUNTIME")
|
|
|
|
elseif("${_property}" MATCHES "OPTIONAL_")
|
|
|
|
set(_type "OPTIONAL")
|
|
|
|
endif()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
if("${_property}" MATCHES "PACKAGES_FOUND")
|
|
|
|
set(_property "PACKAGES_FOUND")
|
|
|
|
elseif("${_property}" MATCHES "PACKAGES_NOT_FOUND")
|
|
|
|
set(_property "PACKAGES_NOT_FOUND")
|
|
|
|
endif()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
set(_currentFeatureText "")
|
|
|
|
get_property(_EnabledFeatures GLOBAL PROPERTY ${_property})
|
2015-02-22 23:06:27 +03:00
|
|
|
if(_EnabledFeatures)
|
|
|
|
list(REMOVE_DUPLICATES _EnabledFeatures)
|
|
|
|
endif(_EnabledFeatures)
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
foreach(_currentFeature ${_EnabledFeatures})
|
2011-07-17 17:57:50 +04:00
|
|
|
|
|
|
|
# does this package belong to the type we currently want to list ?
|
2012-08-13 21:47:32 +04:00
|
|
|
get_property(_currentType GLOBAL PROPERTY _CMAKE_${_currentFeature}_TYPE)
|
|
|
|
if(NOT _currentType)
|
|
|
|
set(_currentType OPTIONAL)
|
|
|
|
endif()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
if("${_type}" STREQUAL ANY OR "${_type}" STREQUAL "${_currentType}")
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2011-07-17 19:48:00 +04:00
|
|
|
# check whether the current feature/package should be in the output depending on whether it was QUIET or not
|
2012-08-13 21:47:32 +04:00
|
|
|
set(includeThisOne TRUE)
|
2011-07-17 22:26:49 +04:00
|
|
|
# skip QUIET packages, except if they are REQUIRED or INCLUDE_QUIET_PACKAGES has been set
|
2012-08-13 21:47:32 +04:00
|
|
|
if((NOT "${_currentType}" STREQUAL "REQUIRED") AND NOT _includeQuiet)
|
|
|
|
get_property(_isQuiet GLOBAL PROPERTY _CMAKE_${_currentFeature}_QUIET)
|
|
|
|
if(_isQuiet)
|
|
|
|
set(includeThisOne FALSE)
|
|
|
|
endif()
|
|
|
|
endif()
|
2014-02-03 23:18:37 +04:00
|
|
|
get_property(_isTransitiveDepend
|
|
|
|
GLOBAL PROPERTY _CMAKE_${_currentFeature}_TRANSITIVE_DEPENDENCY
|
|
|
|
)
|
|
|
|
if(_isTransitiveDepend)
|
|
|
|
set(includeThisOne FALSE)
|
|
|
|
endif()
|
2011-07-17 19:48:00 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
if(includeThisOne)
|
2011-07-17 19:48:00 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
set(_currentFeatureText "${_currentFeatureText}\n * ${_currentFeature}")
|
|
|
|
get_property(_info GLOBAL PROPERTY _CMAKE_${_currentFeature}_REQUIRED_VERSION)
|
|
|
|
if(_info)
|
|
|
|
set(_currentFeatureText "${_currentFeatureText} (required version ${_info})")
|
2012-08-13 21:50:14 +04:00
|
|
|
endif()
|
2012-08-13 21:47:32 +04:00
|
|
|
get_property(_info GLOBAL PROPERTY _CMAKE_${_currentFeature}_DESCRIPTION)
|
|
|
|
if(_info)
|
|
|
|
set(_currentFeatureText "${_currentFeatureText} , ${_info}")
|
2012-08-13 21:50:14 +04:00
|
|
|
endif()
|
2012-08-13 21:47:32 +04:00
|
|
|
get_property(_info GLOBAL PROPERTY _CMAKE_${_currentFeature}_URL)
|
|
|
|
if(_info)
|
|
|
|
set(_currentFeatureText "${_currentFeatureText} , <${_info}>")
|
2012-08-13 21:50:14 +04:00
|
|
|
endif()
|
2011-07-17 19:48:00 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
get_property(_info GLOBAL PROPERTY _CMAKE_${_currentFeature}_PURPOSE)
|
|
|
|
foreach(_purpose ${_info})
|
|
|
|
set(_currentFeatureText "${_currentFeatureText}\n ${_purpose}")
|
|
|
|
endforeach()
|
2011-07-17 19:48:00 +04:00
|
|
|
|
2012-08-13 21:50:14 +04:00
|
|
|
endif()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2012-08-13 21:50:14 +04:00
|
|
|
endif()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2012-08-13 21:50:14 +04:00
|
|
|
endforeach()
|
2012-08-13 21:47:32 +04:00
|
|
|
set(${_var} "${_currentFeatureText}" PARENT_SCOPE)
|
2012-08-13 21:50:14 +04:00
|
|
|
endfunction()
|
2007-08-07 23:41:57 +04:00
|
|
|
|
|
|
|
|
2010-08-24 23:24:54 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
function(FEATURE_SUMMARY)
|
2010-08-24 23:24:54 +04:00
|
|
|
# CMAKE_PARSE_ARGUMENTS(<prefix> <options> <one_value_keywords> <multi_value_keywords> args...)
|
2012-08-13 21:47:32 +04:00
|
|
|
set(options APPEND INCLUDE_QUIET_PACKAGES FATAL_ON_MISSING_REQUIRED_PACKAGES)
|
2014-02-28 20:36:38 +04:00
|
|
|
set(oneValueArgs FILENAME VAR DESCRIPTION)
|
|
|
|
set(multiValueArgs WHAT)
|
2010-08-24 23:24:54 +04:00
|
|
|
|
|
|
|
CMAKE_PARSE_ARGUMENTS(_FS "${options}" "${oneValueArgs}" "${multiValueArgs}" ${_FIRST_ARG} ${ARGN})
|
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
if(_FS_UNPARSED_ARGUMENTS)
|
|
|
|
message(FATAL_ERROR "Unknown keywords given to FEATURE_SUMMARY(): \"${_FS_UNPARSED_ARGUMENTS}\"")
|
|
|
|
endif()
|
2010-08-24 23:24:54 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
if(NOT _FS_WHAT)
|
|
|
|
message(FATAL_ERROR "The call to FEATURE_SUMMARY() doesn't set the required WHAT argument.")
|
|
|
|
endif()
|
2010-08-24 23:24:54 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
set(validWhatParts "ENABLED_FEATURES"
|
2011-07-17 17:57:50 +04:00
|
|
|
"DISABLED_FEATURES"
|
|
|
|
"PACKAGES_FOUND"
|
|
|
|
"PACKAGES_NOT_FOUND"
|
|
|
|
"OPTIONAL_PACKAGES_FOUND"
|
|
|
|
"OPTIONAL_PACKAGES_NOT_FOUND"
|
|
|
|
"RECOMMENDED_PACKAGES_FOUND"
|
|
|
|
"RECOMMENDED_PACKAGES_NOT_FOUND"
|
|
|
|
"REQUIRED_PACKAGES_FOUND"
|
|
|
|
"REQUIRED_PACKAGES_NOT_FOUND"
|
|
|
|
"RUNTIME_PACKAGES_FOUND"
|
|
|
|
"RUNTIME_PACKAGES_NOT_FOUND")
|
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
list(FIND validWhatParts "${_FS_WHAT}" indexInList)
|
|
|
|
if(NOT "${indexInList}" STREQUAL "-1")
|
2011-07-17 19:48:00 +04:00
|
|
|
_FS_GET_FEATURE_SUMMARY( ${_FS_WHAT} _featureSummary ${_FS_INCLUDE_QUIET_PACKAGES} )
|
2012-08-13 21:47:32 +04:00
|
|
|
set(_fullText "${_FS_DESCRIPTION}${_featureSummary}\n")
|
|
|
|
if (("${_FS_WHAT}" STREQUAL "REQUIRED_PACKAGES_NOT_FOUND") AND _featureSummary)
|
|
|
|
set(requiredPackagesNotFound TRUE)
|
|
|
|
endif()
|
2011-07-17 22:26:49 +04:00
|
|
|
|
2014-02-28 20:36:38 +04:00
|
|
|
else()
|
|
|
|
if("${_FS_WHAT}" STREQUAL "ALL")
|
|
|
|
|
|
|
|
set(allWhatParts "ENABLED_FEATURES"
|
|
|
|
"RUNTIME_PACKAGES_FOUND"
|
|
|
|
"OPTIONAL_PACKAGES_FOUND"
|
|
|
|
"RECOMMENDED_PACKAGES_FOUND"
|
|
|
|
"REQUIRED_PACKAGES_FOUND"
|
|
|
|
|
|
|
|
"DISABLED_FEATURES"
|
|
|
|
"RUNTIME_PACKAGES_NOT_FOUND"
|
|
|
|
"OPTIONAL_PACKAGES_NOT_FOUND"
|
|
|
|
"RECOMMENDED_PACKAGES_NOT_FOUND"
|
|
|
|
"REQUIRED_PACKAGES_NOT_FOUND"
|
|
|
|
)
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2014-02-28 20:36:38 +04:00
|
|
|
else()
|
|
|
|
set(allWhatParts)
|
|
|
|
foreach(part ${_FS_WHAT})
|
|
|
|
list(FIND validWhatParts "${part}" indexInList)
|
|
|
|
if(NOT "${indexInList}" STREQUAL "-1")
|
|
|
|
list(APPEND allWhatParts "${part}")
|
|
|
|
else()
|
|
|
|
if("${part}" STREQUAL "ALL")
|
|
|
|
message(FATAL_ERROR "The WHAT argument of FEATURE_SUMMARY() contains ALL, which cannot be combined with other values.")
|
|
|
|
else()
|
|
|
|
message(FATAL_ERROR "The WHAT argument of FEATURE_SUMMARY() contains ${part}, which is not a valid value.")
|
|
|
|
endif()
|
|
|
|
endif()
|
|
|
|
endforeach()
|
|
|
|
endif()
|
2011-07-17 17:57:50 +04:00
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
set(title_ENABLED_FEATURES "The following features have been enabled:")
|
|
|
|
set(title_DISABLED_FEATURES "The following features have been disabled:")
|
2014-03-14 14:51:45 +04:00
|
|
|
set(title_PACKAGES_FOUND "The following packages have been found:")
|
|
|
|
set(title_PACKAGES_NOT_FOUND "The following packages have not been found:")
|
2012-08-13 21:47:32 +04:00
|
|
|
set(title_OPTIONAL_PACKAGES_FOUND "The following OPTIONAL packages have been found:")
|
|
|
|
set(title_OPTIONAL_PACKAGES_NOT_FOUND "The following OPTIONAL packages have not been found:")
|
|
|
|
set(title_RECOMMENDED_PACKAGES_FOUND "The following RECOMMENDED packages have been found:")
|
|
|
|
set(title_RECOMMENDED_PACKAGES_NOT_FOUND "The following RECOMMENDED packages have not been found:")
|
|
|
|
set(title_REQUIRED_PACKAGES_FOUND "The following REQUIRED packages have been found:")
|
|
|
|
set(title_REQUIRED_PACKAGES_NOT_FOUND "The following REQUIRED packages have not been found:")
|
|
|
|
set(title_RUNTIME_PACKAGES_FOUND "The following RUNTIME packages have been found:")
|
|
|
|
set(title_RUNTIME_PACKAGES_NOT_FOUND "The following RUNTIME packages have not been found:")
|
|
|
|
|
|
|
|
set(_fullText "${_FS_DESCRIPTION}")
|
|
|
|
foreach(part ${allWhatParts})
|
|
|
|
set(_tmp)
|
2011-07-17 19:48:00 +04:00
|
|
|
_FS_GET_FEATURE_SUMMARY( ${part} _tmp ${_FS_INCLUDE_QUIET_PACKAGES})
|
2012-08-13 21:47:32 +04:00
|
|
|
if(_tmp)
|
|
|
|
set(_fullText "${_fullText}\n-- ${title_${part}}\n${_tmp}\n")
|
|
|
|
if("${part}" STREQUAL "REQUIRED_PACKAGES_NOT_FOUND")
|
|
|
|
set(requiredPackagesNotFound TRUE)
|
|
|
|
endif()
|
|
|
|
endif()
|
|
|
|
endforeach()
|
|
|
|
endif()
|
|
|
|
|
|
|
|
if(_FS_FILENAME)
|
|
|
|
if(_FS_APPEND)
|
|
|
|
file(APPEND "${_FS_FILENAME}" "${_fullText}")
|
2012-08-13 21:50:14 +04:00
|
|
|
else()
|
2012-08-13 21:47:32 +04:00
|
|
|
file(WRITE "${_FS_FILENAME}" "${_fullText}")
|
|
|
|
endif()
|
|
|
|
|
2012-08-13 21:50:14 +04:00
|
|
|
else()
|
2012-08-13 21:47:32 +04:00
|
|
|
if(NOT _FS_VAR)
|
|
|
|
message(STATUS "${_fullText}")
|
|
|
|
endif()
|
|
|
|
endif()
|
|
|
|
|
|
|
|
if(_FS_VAR)
|
|
|
|
set(${_FS_VAR} "${_fullText}" PARENT_SCOPE)
|
|
|
|
endif()
|
|
|
|
|
|
|
|
if(requiredPackagesNotFound AND _FS_FATAL_ON_MISSING_REQUIRED_PACKAGES)
|
|
|
|
message(FATAL_ERROR "feature_summary() Error: REQUIRED package(s) are missing, aborting CMake run.")
|
|
|
|
endif()
|
|
|
|
|
2012-08-13 21:50:14 +04:00
|
|
|
endfunction()
|
2011-07-17 22:47:11 +04:00
|
|
|
|
|
|
|
|
|
|
|
# The stuff below is only kept for compatibility
|
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
function(SET_PACKAGE_INFO _name _desc)
|
2015-02-26 19:26:12 +03:00
|
|
|
unset(_url)
|
|
|
|
unset(_purpose)
|
|
|
|
if(ARGC GREATER 2)
|
|
|
|
set(_url "${ARGV2}")
|
|
|
|
endif()
|
|
|
|
if(ARGC GREATER 3)
|
|
|
|
set(_purpose "${ARGV3}")
|
|
|
|
endif()
|
2012-08-13 21:47:32 +04:00
|
|
|
set_property(GLOBAL PROPERTY _CMAKE_${_name}_DESCRIPTION "${_desc}" )
|
2014-04-11 20:36:08 +04:00
|
|
|
if(NOT _url STREQUAL "")
|
2012-08-13 21:47:32 +04:00
|
|
|
set_property(GLOBAL PROPERTY _CMAKE_${_name}_URL "${_url}" )
|
|
|
|
endif()
|
2014-04-11 20:36:08 +04:00
|
|
|
if(NOT _purpose STREQUAL "")
|
2012-08-13 21:47:32 +04:00
|
|
|
set_property(GLOBAL APPEND PROPERTY _CMAKE_${_name}_PURPOSE "${_purpose}" )
|
|
|
|
endif()
|
2012-08-13 21:50:14 +04:00
|
|
|
endfunction()
|
2011-07-17 22:47:11 +04:00
|
|
|
|
|
|
|
|
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
function(SET_FEATURE_INFO)
|
2011-07-17 22:47:11 +04:00
|
|
|
SET_PACKAGE_INFO(${ARGN})
|
2012-08-13 21:50:14 +04:00
|
|
|
endfunction()
|
2011-07-17 22:47:11 +04:00
|
|
|
|
|
|
|
|
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
function(PRINT_ENABLED_FEATURES)
|
2011-07-17 22:47:11 +04:00
|
|
|
FEATURE_SUMMARY(WHAT ENABLED_FEATURES DESCRIPTION "Enabled features:")
|
2012-08-13 21:50:14 +04:00
|
|
|
endfunction()
|
2011-07-17 22:47:11 +04:00
|
|
|
|
|
|
|
|
|
|
|
|
2012-08-13 21:47:32 +04:00
|
|
|
function(PRINT_DISABLED_FEATURES)
|
2011-07-17 22:47:11 +04:00
|
|
|
FEATURE_SUMMARY(WHAT DISABLED_FEATURES DESCRIPTION "Disabled features:")
|
2012-08-13 21:50:14 +04:00
|
|
|
endfunction()
|