904ff9fe59
Currently, export() is executed at configure-time. One problem with this is that certain exported properties like the link interface may not be complete at the point the export() is encountered leading to an incorrect or incomplete exported representation. Additionally, the generated IMPORTED_LOCATION property may even be incorrect if commands following the export() have an effect on it. Another problem is that it requires the C++ implementation of cmake to be capable of computing the exported information at configure time. This is a limitation on the cleanup and maintenance of the code. At some point in the future, this limitation will be dropped and more implementation will be moved from cmTarget to cmGeneratorTarget.
138 lines
5.2 KiB
C++
138 lines
5.2 KiB
C++
/*============================================================================
|
|
CMake - Cross Platform Makefile Generator
|
|
Copyright 2000-2009 Kitware, Inc., Insight Software Consortium
|
|
|
|
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.
|
|
============================================================================*/
|
|
#ifndef cmPolicies_h
|
|
#define cmPolicies_h
|
|
|
|
#include "cmCustomCommand.h"
|
|
|
|
class cmake;
|
|
class cmMakefile;
|
|
class cmPolicy;
|
|
|
|
/** \class cmPolicies
|
|
* \brief Handles changes in CMake behavior and policies
|
|
*
|
|
* See the cmake wiki section on
|
|
* <a href="http://www.cmake.org/Wiki/CMake/Policies">policies</a>
|
|
* for an overview of this class's purpose
|
|
*/
|
|
class cmPolicies
|
|
{
|
|
public:
|
|
cmPolicies();
|
|
~cmPolicies();
|
|
|
|
/// Status of a policy
|
|
enum PolicyStatus {
|
|
OLD, ///< Use old behavior
|
|
WARN, ///< Use old behavior but issue a warning
|
|
NEW, ///< Use new behavior
|
|
/// Issue an error if user doesn't set policy status to NEW and hits the
|
|
/// check
|
|
REQUIRED_IF_USED,
|
|
REQUIRED_ALWAYS ///< Issue an error unless user sets policy status to NEW.
|
|
};
|
|
static const char* PolicyStatusNames[];
|
|
|
|
/// Policy identifiers
|
|
enum PolicyID
|
|
{
|
|
CMP0000, ///< Policy version specification
|
|
CMP0001, ///< Ignore old compatibility variable
|
|
CMP0002, ///< Target names must be unique
|
|
CMP0003, ///< Linking does not include extra -L paths
|
|
CMP0004, ///< Libraries linked may not have leading or trailing whitespace
|
|
CMP0005, ///< Definition value escaping
|
|
CMP0006, ///< BUNDLE install rules needed for MACOSX_BUNDLE targets
|
|
CMP0007, ///< list command handling of empty elements
|
|
CMP0008, ///< Full-path libraries must be a valid library file name
|
|
CMP0009, ///< GLOB_RECURSE should not follow symlinks by default
|
|
CMP0010, ///< Bad variable reference syntax is an error
|
|
CMP0011, ///< Strong policy scope for include and find_package
|
|
CMP0012, ///< Recognize numbers and boolean constants in if()
|
|
CMP0013, ///< Duplicate binary directories not allowed
|
|
CMP0014, ///< Input directories must have CMakeLists.txt
|
|
CMP0015, ///< link_directories() treats paths relative to source dir
|
|
/// target_link_libraries() fails if only argument is not a target
|
|
CMP0016,
|
|
CMP0017, ///< Prefer files in CMAKE_ROOT when including from CMAKE_ROOT
|
|
CMP0018, ///< Ignore language flags for shared libs, and adhere to
|
|
/// POSITION_INDEPENDENT_CODE property and *_COMPILE_OPTIONS_PI{E,C}
|
|
/// instead.
|
|
CMP0019, ///< No variable re-expansion in include and link info
|
|
CMP0020, ///< Automatically link Qt executables to qtmain target
|
|
CMP0021, ///< Fatal error on relative paths in INCLUDE_DIRECTORIES
|
|
/// target property
|
|
CMP0022, ///< INTERFACE_LINK_LIBRARIES defines the link interface
|
|
CMP0023, ///< Disallow mixing keyword and plain tll signatures
|
|
CMP0024, ///< Disallow including export() result.
|
|
|
|
/** \brief Always the last entry.
|
|
*
|
|
* Useful mostly to avoid adding a comma the last policy when adding a new
|
|
* one.
|
|
*/
|
|
CMPCOUNT
|
|
};
|
|
|
|
///! convert a string policy ID into a number
|
|
bool GetPolicyID(const char *id, /* out */ cmPolicies::PolicyID &pid);
|
|
std::string GetPolicyIDString(cmPolicies::PolicyID pid);
|
|
|
|
///! Get the default status for a policy
|
|
cmPolicies::PolicyStatus GetPolicyStatus(cmPolicies::PolicyID id);
|
|
|
|
///! Define a Policy for CMake
|
|
void DefinePolicy(cmPolicies::PolicyID id,
|
|
const char *stringID,
|
|
const char *shortDescription,
|
|
const char *longDescription,
|
|
unsigned int majorVersionIntroduced,
|
|
unsigned int minorVersionIntroduced,
|
|
unsigned int patchVersionIntroduced,
|
|
unsigned int tweakVersionIntroduced,
|
|
cmPolicies::PolicyStatus status);
|
|
|
|
///! Set a policy level for this listfile
|
|
bool ApplyPolicyVersion(cmMakefile *mf, const char *version);
|
|
|
|
///! return a warning string for a given policy
|
|
std::string GetPolicyWarning(cmPolicies::PolicyID id);
|
|
|
|
///! return an error string for when a required policy is unspecified
|
|
std::string GetRequiredPolicyError(cmPolicies::PolicyID id);
|
|
|
|
///! return an error string for when a required policy is unspecified
|
|
std::string GetRequiredAlwaysPolicyError(cmPolicies::PolicyID id);
|
|
|
|
///! Get docs for policies
|
|
void GetDocumentation(std::vector<cmDocumentationEntry>& v);
|
|
|
|
/** Represent a set of policy values. */
|
|
typedef std::map<PolicyID, PolicyStatus> PolicyMap;
|
|
|
|
private:
|
|
// might have to make these internal for VS6 not sure yet
|
|
std::map<PolicyID,cmPolicy *> Policies;
|
|
std::map<std::string,PolicyID> PolicyStringMap;
|
|
|
|
void DiagnoseAncientPolicies(std::vector<PolicyID> const& ancient,
|
|
unsigned int majorVer, unsigned int minorVer,
|
|
unsigned int patchVer, cmMakefile* mf);
|
|
|
|
bool GetPolicyDefault(cmMakefile* mf, std::string const& policy,
|
|
cmPolicies::PolicyStatus* defaultStatus);
|
|
|
|
};
|
|
|
|
#endif
|