CMake/Source/cmGlobalUnixMakefileGenerat...

258 lines
9.0 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 22:01:08 +03:00
/* Distributed under the OSI-approved BSD 3-Clause License. See accompanying
file Copyright.txt or https://cmake.org/licensing for details. */
2005-05-05 20:45:53 +04:00
#ifndef cmGlobalUnixMakefileGenerator3_h
#define cmGlobalUnixMakefileGenerator3_h
#include <cmConfigure.h>
#include "cmGeneratorTarget.h"
#include "cmGlobalCommonGenerator.h"
#include "cmGlobalGeneratorFactory.h"
#include "cmState.h"
#include <iosfwd>
#include <map>
#include <set>
#include <stddef.h>
#include <string>
#include <vector>
2005-05-05 20:45:53 +04:00
2005-05-06 22:49:38 +04:00
class cmGeneratedFileStream;
class cmLocalGenerator;
2005-05-06 22:49:38 +04:00
class cmLocalUnixMakefileGenerator3;
class cmMakefile;
class cmMakefileTargetGenerator;
class cmake;
struct cmDocumentationEntry;
2005-05-06 22:49:38 +04:00
2005-05-05 20:45:53 +04:00
/** \class cmGlobalUnixMakefileGenerator3
* \brief Write a Unix makefiles.
*
* cmGlobalUnixMakefileGenerator3 manages UNIX build process for a tree
2010-11-12 00:02:07 +03:00
The basic approach of this generator is to produce Makefiles that will all
be run with the current working directory set to the Home Output
directory. The one exception to this is the subdirectory Makefiles which are
created as a convenience and just cd up to the Home Output directory and
2010-11-12 00:02:07 +03:00
invoke the main Makefiles.
The make process starts with Makefile. Makefile should only contain the
targets the user is likely to invoke directly from a make command line. No
internal targets should be in this file. Makefile2 contains the internal
targets that are required to make the process work.
2010-11-12 00:02:07 +03:00
Makefile2 in turn will recursively make targets in the correct order. Each
2011-03-20 16:22:39 +03:00
target has its own directory \<target\>.dir and its own makefile build.make in
that directory. Also in that directory is a couple makefiles per source file
used by the target. Typically these are named source.obj.build.make and
source.obj.build.depend.make. The source.obj.build.make contains the rules
for building, cleaning, and computing dependencies for the given source
file. The build.depend.make contains additional dependencies that were
computed during dependency scanning. An additional file called
source.obj.depend is used as a marker to indicate when dependencies must be
rescanned.
Rules for custom commands follow the same model as rules for source files.
2010-11-12 00:02:07 +03:00
2005-05-05 20:45:53 +04:00
*/
class cmGlobalUnixMakefileGenerator3 : public cmGlobalCommonGenerator
2005-05-05 20:45:53 +04:00
{
public:
cmGlobalUnixMakefileGenerator3(cmake* cm);
static cmGlobalGeneratorFactory* NewFactory()
{
return new cmGlobalGeneratorSimpleFactory<
cmGlobalUnixMakefileGenerator3>();
}
2005-05-05 20:45:53 +04:00
///! Get the name for the generator.
2016-06-27 22:25:27 +03:00
std::string GetName() const CM_OVERRIDE
{
return cmGlobalUnixMakefileGenerator3::GetActualName();
}
static std::string GetActualName() { return "Unix Makefiles"; }
2005-05-05 20:45:53 +04:00
/**
* Utilized by the generator factory to determine if this generator
* supports toolsets.
*/
static bool SupportsToolset() { return false; }
/**
* Utilized by the generator factory to determine if this generator
* supports platforms.
*/
static bool SupportsPlatform() { return false; }
2005-05-05 20:45:53 +04:00
/** Get the documentation entry for this generator. */
static void GetDocumentation(cmDocumentationEntry& entry);
2010-11-12 00:02:07 +03:00
2016-06-27 22:25:27 +03:00
cmLocalGenerator* CreateLocalGenerator(cmMakefile* mf) CM_OVERRIDE;
2005-05-05 20:45:53 +04:00
/**
2014-10-10 03:22:45 +04:00
* Try to determine system information such as shared library
2010-11-12 00:02:07 +03:00
* extension, pthreads, byte order etc.
2005-05-05 20:45:53 +04:00
*/
2016-06-27 22:25:27 +03:00
void EnableLanguage(std::vector<std::string> const& languages, cmMakefile*,
bool optional) CM_OVERRIDE;
2005-05-05 20:45:53 +04:00
2016-06-27 22:25:27 +03:00
void Configure() CM_OVERRIDE;
2005-05-05 20:45:53 +04:00
/**
* Generate the all required files for building this project/tree. This
* basically creates a series of LocalGenerators for each directory and
2010-11-12 00:02:07 +03:00
* requests that they Generate.
2005-05-05 20:45:53 +04:00
*/
2016-06-27 22:25:27 +03:00
void Generate() CM_OVERRIDE;
2010-11-12 00:02:07 +03:00
void WriteMainCMakefileLanguageRules(cmGeneratedFileStream& cmakefileStream,
std::vector<cmLocalGenerator*>&);
2005-05-05 20:45:53 +04:00
// write out the help rule listing the valid targets
void WriteHelpRule(std::ostream& ruleFileStream,
cmLocalUnixMakefileGenerator3*);
2011-03-19 13:41:00 +03:00
// write the top level target rules
2010-11-12 00:02:07 +03:00
void WriteConvenienceRules(std::ostream& ruleFileStream,
std::set<std::string>& emitted);
/** Get the command to use for a target that has no rule. This is
used for multiple output dependencies and for cmake_force. */
std::string GetEmptyRuleHackCommand() { return this->EmptyRuleHackCommand; }
2006-05-02 17:56:42 +04:00
/** Get the fake dependency to use when a rule has no real commands
or dependencies. */
std::string GetEmptyRuleHackDepends() { return this->EmptyRuleHackDepends; }
2006-05-02 17:56:42 +04:00
// change the build command for speed
2016-06-27 22:25:27 +03:00
void GenerateBuildCommand(std::vector<std::string>& makeCommand,
const std::string& makeProgram,
const std::string& projectName,
const std::string& projectDir,
const std::string& targetName,
const std::string& config, bool fast, bool verbose,
std::vector<std::string> const& makeOptions =
std::vector<std::string>()) CM_OVERRIDE;
2006-05-02 17:56:42 +04:00
/** Record per-target progress information. */
void RecordTargetProgress(cmMakefileTargetGenerator* tg);
void AddCXXCompileCommand(const std::string& sourceFile,
const std::string& workingDirectory,
const std::string& compileCommand);
2011-01-13 07:39:13 +03:00
/** Does the make tool tolerate .NOTPARALLEL? */
virtual bool AllowNotParallel() const { return true; }
/** Does the make tool tolerate .DELETE_ON_ERROR? */
virtual bool AllowDeleteOnError() const { return true; }
2016-06-27 22:25:27 +03:00
void ComputeTargetObjectDirectory(cmGeneratorTarget* gt) const CM_OVERRIDE;
std::string IncludeDirective;
bool DefineWindowsNULL;
bool PassMakeflags;
bool UnixCD;
2005-05-05 20:45:53 +04:00
protected:
void WriteMainMakefile2();
2005-05-05 20:45:53 +04:00
void WriteMainCMakefile();
void WriteConvenienceRules2(std::ostream& ruleFileStream,
cmLocalUnixMakefileGenerator3*);
void WriteDirectoryRule2(std::ostream& ruleFileStream,
cmLocalUnixMakefileGenerator3* lg, const char* pass,
bool check_all, bool check_relink);
void WriteDirectoryRules2(std::ostream& ruleFileStream,
cmLocalUnixMakefileGenerator3* lg);
void AppendGlobalTargetDepends(std::vector<std::string>& depends,
cmGeneratorTarget* target);
// does this generator need a requires step for any of its targets
2015-10-19 00:20:47 +03:00
bool NeedRequiresStep(cmGeneratorTarget const*);
2005-05-06 22:49:38 +04:00
// Target name hooks for superclass.
2016-06-27 22:25:27 +03:00
const char* GetAllTargetName() const CM_OVERRIDE { return "all"; }
const char* GetInstallTargetName() const CM_OVERRIDE { return "install"; }
const char* GetInstallLocalTargetName() const CM_OVERRIDE
{
return "install/local";
}
const char* GetInstallStripTargetName() const CM_OVERRIDE
{
return "install/strip";
}
const char* GetPreinstallTargetName() const CM_OVERRIDE
{
return "preinstall";
}
const char* GetTestTargetName() const CM_OVERRIDE { return "test"; }
const char* GetPackageTargetName() const CM_OVERRIDE { return "package"; }
const char* GetPackageSourceTargetName() const CM_OVERRIDE
{
return "package_source";
}
const char* GetEditCacheTargetName() const CM_OVERRIDE
{
return "edit_cache";
}
const char* GetRebuildCacheTargetName() const CM_OVERRIDE
{
return "rebuild_cache";
}
const char* GetCleanTargetName() const CM_OVERRIDE { return "clean"; }
bool CheckALLOW_DUPLICATE_CUSTOM_TARGETS() const CM_OVERRIDE { return true; }
// Some make programs (Borland) do not keep a rule if there are no
// dependencies or commands. This is a problem for creating rules
// that might not do anything but might have other dependencies
// added later. If non-empty this variable holds a fake dependency
// that can be added.
2006-03-15 19:02:08 +03:00
std::string EmptyRuleHackDepends;
// Some make programs (Watcom) do not like rules with no commands.
// If non-empty this variable holds a bogus command that may be put
// in the rule to satisfy the make program.
std::string EmptyRuleHackCommand;
// Store per-target progress counters.
struct TargetProgress
{
TargetProgress()
: NumberOfActions(0)
{
}
unsigned long NumberOfActions;
std::string VariableFile;
std::vector<unsigned long> Marks;
void WriteProgressVariables(unsigned long total, unsigned long& current);
};
typedef std::map<cmGeneratorTarget const*, TargetProgress,
cmGeneratorTarget::StrictTargetComparison>
ProgressMapType;
ProgressMapType ProgressMap;
size_t CountProgressMarksInTarget(
cmGeneratorTarget const* target,
std::set<cmGeneratorTarget const*>& emitted);
2015-10-22 02:06:46 +03:00
size_t CountProgressMarksInAll(cmLocalGenerator* lg);
2011-01-13 07:39:13 +03:00
cmGeneratedFileStream* CommandDatabase;
private:
2016-06-27 22:25:27 +03:00
const char* GetBuildIgnoreErrorsFlag() const CM_OVERRIDE { return "-i"; }
std::string GetEditCacheCommand() const CM_OVERRIDE;
std::map<cmState::Snapshot, std::set<cmGeneratorTarget const*>,
cmState::Snapshot::StrictWeakOrder>
DirectoryTargetsMap;
2016-06-27 22:25:27 +03:00
void InitializeProgressMarks() CM_OVERRIDE;
2005-05-05 20:45:53 +04:00
};
#endif