CMake/Source/cmCMakeMinimumRequired.cxx

109 lines
3.6 KiB
C++
Raw Normal View History

Simplify CMake per-source license notices Per-source copyright/license notice headers that spell out copyright holder names and years are hard to maintain and often out-of-date or plain wrong. Precise contributor information is already maintained automatically by the version control tool. Ultimately it is the receiver of a file who is responsible for determining its licensing status, and per-source notices are merely a convenience. Therefore it is simpler and more accurate for each source to have a generic notice of the license name and references to more detailed information on copyright holders and full license terms. Our `Copyright.txt` file now contains a list of Contributors whose names appeared source-level copyright notices. It also references version control history for more precise information. Therefore we no longer need to spell out the list of Contributors in each source file notice. Replace CMake per-source copyright/license notice headers with a short description of the license and links to `Copyright.txt` and online information available from "https://cmake.org/licensing". The online URL also handles cases of modules being copied out of our source into other projects, so we can drop our notices about replacing links with full license text. Run the `Utilities/Scripts/filter-notices.bash` script to perform the majority of the replacements mechanically. Manually fix up shebang lines and trailing newlines in a few files. Manually update the notices in a few files that the script does not handle.
2016-09-27 19:01:08 +00:00
/* Distributed under the OSI-approved BSD 3-Clause License. See accompanying
file Copyright.txt or https://cmake.org/licensing for details. */
#include "cmCMakeMinimumRequired.h"
#include "cmVersion.h"
// cmCMakeMinimumRequired
bool cmCMakeMinimumRequired::InitialPass(std::vector<std::string> const& args,
cmExecutionStatus&)
{
// Process arguments.
std::string version_string;
bool doing_version = false;
for (unsigned int i = 0; i < args.size(); ++i) {
if (args[i] == "VERSION") {
doing_version = true;
} else if (args[i] == "FATAL_ERROR") {
if (doing_version) {
this->SetError("called with no value for VERSION.");
return false;
}
doing_version = false;
} else if (doing_version) {
doing_version = false;
version_string = args[i];
} else {
this->UnknownArguments.push_back(args[i]);
}
}
if (doing_version) {
this->SetError("called with no value for VERSION.");
return false;
}
// Make sure there was a version to check.
if (version_string.empty()) {
return this->EnforceUnknownArguments();
}
// Save the required version string.
2006-03-15 16:02:08 +00:00
this->Makefile->AddDefinition("CMAKE_MINIMUM_REQUIRED_VERSION",
version_string.c_str());
// Get the current version number.
unsigned int current_major = cmVersion::GetMajorVersion();
unsigned int current_minor = cmVersion::GetMinorVersion();
unsigned int current_patch = cmVersion::GetPatchVersion();
unsigned int current_tweak = cmVersion::GetTweakVersion();
// Parse at least two components of the version number.
// Use zero for those not specified.
unsigned int required_major = 0;
unsigned int required_minor = 0;
unsigned int required_patch = 0;
unsigned int required_tweak = 0;
if (sscanf(version_string.c_str(), "%u.%u.%u.%u", &required_major,
&required_minor, &required_patch, &required_tweak) < 2) {
std::ostringstream e;
e << "could not parse VERSION \"" << version_string << "\".";
this->SetError(e.str());
return false;
}
// Compare the version numbers.
if ((current_major < required_major) ||
(current_major == required_major && current_minor < required_minor) ||
(current_major == required_major && current_minor == required_minor &&
current_patch < required_patch) ||
(current_major == required_major && current_minor == required_minor &&
current_patch == required_patch && current_tweak < required_tweak)) {
// The current version is too low.
std::ostringstream e;
e << "CMake " << version_string
<< " or higher is required. You are running version "
<< cmVersion::GetCMakeVersion();
this->Makefile->IssueMessage(cmake::FATAL_ERROR, e.str());
cmSystemTools::SetFatalErrorOccured();
return true;
}
// The version is not from the future, so enforce unknown arguments.
if (!this->EnforceUnknownArguments()) {
return false;
}
if (required_major < 2 || (required_major == 2 && required_minor < 4)) {
this->Makefile->IssueMessage(
cmake::AUTHOR_WARNING,
"Compatibility with CMake < 2.4 is not supported by CMake >= 3.0.");
this->Makefile->SetPolicyVersion("2.4");
} else {
this->Makefile->SetPolicyVersion(version_string.c_str());
}
return true;
}
bool cmCMakeMinimumRequired::EnforceUnknownArguments()
{
if (!this->UnknownArguments.empty()) {
std::ostringstream e;
e << "called with unknown argument \"" << this->UnknownArguments[0]
<< "\".";
this->SetError(e.str());
return false;
}
return true;
}