CMake/Source/cmLocalUnixMakefileGenerato...

362 lines
13 KiB
C
Raw Normal View History

2005-05-05 20:45:53 +04:00
/*=========================================================================
Program: CMake - Cross-Platform Makefile Generator
Module: $RCSfile$
Language: C++
Date: $Date$
Version: $Revision$
Copyright (c) 2002 Kitware, Inc., Insight Consortium. All rights reserved.
See Copyright.txt or http://www.cmake.org/HTML/Copyright.html for details.
This software is distributed WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the above copyright notices for more information.
=========================================================================*/
#ifndef cmLocalUnixMakefileGenerator3_h
#define cmLocalUnixMakefileGenerator3_h
#include "cmLocalGenerator.h"
class cmCustomCommand;
class cmDependInformation;
class cmDepends;
class cmMakeDepend;
class cmMakefileTargetGenerator;
2005-05-05 20:45:53 +04:00
class cmTarget;
class cmSourceFile;
/** \class cmLocalUnixMakefileGenerator3
* \brief Write a LocalUnix makefiles.
*
* cmLocalUnixMakefileGenerator3 produces a LocalUnix makefile from its
2006-03-15 19:02:08 +03:00
* member Makefile.
2005-05-05 20:45:53 +04:00
*/
class cmLocalUnixMakefileGenerator3 : public cmLocalGenerator
{
public:
cmLocalUnixMakefileGenerator3();
virtual ~cmLocalUnixMakefileGenerator3();
2005-06-01 21:37:49 +04:00
/**
* Process the CMakeLists files for this directory to fill in the
2006-03-15 19:02:08 +03:00
* Makefile ivar
2005-06-01 21:37:49 +04:00
*/
virtual void Configure();
/**
* Generate the makefile for this directory.
*/
virtual void Generate();
2005-05-06 22:49:38 +04:00
2005-05-06 22:49:38 +04:00
// this returns the relative path between the HomeOutputDirectory and this
// local generators StartOutputDirectory
2005-06-01 21:37:49 +04:00
const std::string &GetHomeRelativeOutputPath();
2005-05-06 22:49:38 +04:00
// Write out a make rule
void WriteMakeRule(std::ostream& os,
const char* comment,
const char* target,
const std::vector<std::string>& depends,
const std::vector<std::string>& commands,
bool symbolic,
bool in_help = false);
2005-05-06 22:49:38 +04:00
// write the main variables used by the makefiles
2005-08-06 01:07:07 +04:00
void WriteMakeVariables(std::ostream& makefileStream);
2005-05-06 22:49:38 +04:00
// write the progress variables used by the makefiles
void WriteProgressVariables(unsigned long total, unsigned long &current);
void WriteAllProgressVariable();
2005-05-06 22:49:38 +04:00
/**
* If true, then explicitly pass MAKEFLAGS on the make all target for makes
* that do not use environment variables.
*
*/
2006-03-15 19:02:08 +03:00
void SetPassMakeflags(bool s){this->PassMakeflags = s;}
bool GetPassMakeflags() { return this->PassMakeflags; }
2005-05-06 22:49:38 +04:00
/**
* Set the flag used to keep the make program silent.
*/
2006-03-15 19:02:08 +03:00
void SetMakeSilentFlag(const char* s) { this->MakeSilentFlag = s; }
std::string &GetMakeSilentFlag() { return this->MakeSilentFlag; }
2005-05-05 20:45:53 +04:00
/**
* Set to true if the shell being used is the windows shell.
* This controls if statements in the makefile and the SHELL variable.
* The default is false.
*/
2006-03-15 19:02:08 +03:00
void SetWindowsShell(bool v) {this->WindowsShell = v;}
2005-05-05 20:45:53 +04:00
/**
* Set to true if the make tool being used is Watcom WMake.
*/
void SetWatcomWMake(bool v) {this->WatcomWMake = v;}
/**
* Set to true if the shell being used is the MSYS shell.
* This controls if statements in the makefile and the SHELL variable.
* The default is false.
*/
void SetMSYSShell(bool v) {this->MSYSShell = v;}
/**
* If set to true, then NULL is set to nil for non Windows_NT.
* This uses make syntax used by nmake and borland.
* The default is false.
*/
2006-03-15 19:02:08 +03:00
void SetDefineWindowsNULL(bool v) {this->DefineWindowsNULL = v;}
/**
* If set to true, cd dir && command is used to
* run commands in a different directory.
*/
2006-03-15 19:02:08 +03:00
void SetUnixCD(bool v) {this->UnixCD = v;}
/**
* Set Support Verbose Variable. If true, then .SILENT will
* be not end with : i.e. .SILENT: or .SILENT
*/
2006-03-15 19:02:08 +03:00
void SetSilentNoColon(bool v) {this->SilentNoColon = v;}
/**
* If set to true, the CMake variable CMAKE_VERBOSE_MAKEFILES doesn't have
* anymore. Set it to true when writing a generator where short output
* doesn't make sense, e.g. because the full output is parsed by an
* IDE/editor.
*/
void SetForceVerboseMakefiles(bool enable)
{this->ForceVerboseMakefiles=enable;}
/**
* Set the command to use for native make shell echo. The value
* should include all parts of the command up to the beginning of
* the message (including a whitespace separator).
*/
void SetNativeEchoCommand(const char* cmd, bool isWindows)
{ this->NativeEchoCommand = cmd; this->NativeEchoWindows = isWindows; }
2005-05-05 20:45:53 +04:00
/**
* Set the string used to include one makefile into another default
* is include.
*/
2006-03-15 19:02:08 +03:00
void SetIncludeDirective(const char* s) { this->IncludeDirective = s; }
const char *GetIncludeDirective() { return this->IncludeDirective.c_str(); }
2005-05-05 20:45:53 +04:00
/**
* Set max makefile variable size, default is 0 which means unlimited.
*/
2006-03-15 19:02:08 +03:00
void SetMakefileVariableSize(int s) { this->MakefileVariableSize = s; }
2005-05-05 20:45:53 +04:00
/**
* If ignore lib prefix is true, then do not strip lib from the name
* of a library.
*/
2006-03-15 19:02:08 +03:00
void SetIgnoreLibPrefix(bool s) { this->IgnoreLibPrefix = s; }
2005-05-05 20:45:53 +04:00
/**
* Set whether passing a make target on a command line requires an
* extra level of escapes.
*/
void SetMakeCommandEscapeTargetTwice(bool b)
{ this->MakeCommandEscapeTargetTwice = b; }
// used in writing out Cmake files such as WriteDirectoryInformation
static void WriteCMakeArgument(std::ostream& os, const char* s);
/** creates the common disclainer text at the top of each makefile */
void WriteDisclaimer(std::ostream& os);
// write a comment line #====... in the stream
void WriteDivider(std::ostream& os);
/** used to create a recursive make call */
std::string GetRecursiveMakeCall(const char *makefile, const char* tgt);
2005-05-06 22:49:38 +04:00
// append an echo command
enum EchoColor { EchoNormal, EchoDepend, EchoBuild, EchoLink,
EchoGenerate, EchoGlobal };
void AppendEcho(std::vector<std::string>& commands, const char* text,
EchoColor color = EchoNormal);
static std::string GetTargetDirectory(cmTarget& target);
// create a command that cds to the start dir then runs the commands
void CreateCDCommand(std::vector<std::string>& commands,
const char *targetDir, const char *returnDir);
static std::string ConvertToQuotedOutputPath(const char* p);
std::string CreateMakeVariable(const char* sin, const char* s2in);
2005-05-05 20:45:53 +04:00
/** Called from command-line hook to scan dependencies. */
virtual bool ScanDependencies(const char* tgtInfo);
2005-05-05 20:45:53 +04:00
/** Called from command-line hook to check dependencies. */
virtual void CheckDependencies(cmMakefile* mf, bool verbose,
bool clear);
2005-05-06 22:49:38 +04:00
/** write some extra rules such as make test etc */
2005-05-06 22:49:38 +04:00
void WriteSpecialTargetsTop(std::ostream& makefileStream);
2005-05-05 20:45:53 +04:00
void WriteSpecialTargetsBottom(std::ostream& makefileStream);
std::string GetRelativeTargetDirectory(cmTarget& target);
2005-05-05 20:45:53 +04:00
// List the files for which to check dependency integrity. Each
// language has its own list because integrity may be checked
// differently.
struct IntegrityCheckSet: public std::set<cmSourceFile *> {};
2006-03-10 21:54:57 +03:00
struct IntegrityCheckSetMap: public std::map<cmStdString, IntegrityCheckSet>
{};
std::map<cmStdString, IntegrityCheckSetMap> &GetIntegrityCheckSet()
2006-03-15 19:02:08 +03:00
{ return this->CheckDependFiles;}
2005-05-05 20:45:53 +04:00
void AppendGlobalTargetDepends(std::vector<std::string>& depends,
cmTarget& target);
// write the target rules for the local Makefile into the stream
void WriteLocalAllRules(std::ostream& ruleFileStream);
struct LocalObjectEntry
{
cmTarget* Target;
std::string Language;
LocalObjectEntry(): Target(0), Language() {}
LocalObjectEntry(cmTarget* t, const char* lang):
Target(t), Language(lang) {}
};
class LocalObjectInfo: public std::vector<LocalObjectEntry> {};
std::map<cmStdString, LocalObjectInfo> const& GetLocalObjectFiles()
2006-03-15 19:02:08 +03:00
{ return this->LocalObjectFiles;}
std::vector<cmStdString> const& GetLocalHelp() { return this->LocalHelp; }
// return info about progress actions
unsigned long GetNumberOfProgressActions();
unsigned long GetNumberOfProgressActionsForTarget(const char *);
/** Get whether to create rules to generate preprocessed and
assembly sources. This could be converted to a variable lookup
later. */
bool GetCreatePreprocessedSourceRules()
{
return !this->SkipPreprocessedSourceRules;
}
bool GetCreateAssemblySourceRules()
{
return !this->SkipAssemblySourceRules;
}
// Get the directories into which the .o files will go for this target
void GetTargetObjectFileDirectories(cmTarget* target,
std::vector<std::string>& dirs);
2005-05-05 20:45:53 +04:00
protected:
void WriteLocalMakefile();
2005-05-11 16:45:16 +04:00
// write the target rules for the local Makefile into the stream
void WriteLocalMakefileTargets(std::ostream& ruleFileStream,
std::set<cmStdString> &emitted);
// this method Writes the Directory informaiton files
void WriteDirectoryInformationFile();
// write the depend info
void WriteDependLanguageInfo(std::ostream& cmakefileStream, cmTarget &tgt);
2005-05-06 22:49:38 +04:00
// write the local help rule
void WriteHelpRule(std::ostream& ruleFileStream);
2005-05-06 22:49:38 +04:00
// this converts a file name that is relative to the StartOuputDirectory
// into a full path
std::string ConvertToFullPath(const std::string& localPath);
2005-05-06 22:49:38 +04:00
void WriteConvenienceRule(std::ostream& ruleFileStream,
const char* realTarget,
const char* helpTarget);
2005-05-17 19:15:09 +04:00
void WriteTargetDependRule(std::ostream& ruleFileStream,
cmTarget& target);
void WriteTargetCleanRule(std::ostream& ruleFileStream,
cmTarget& target,
const std::vector<std::string>& files);
2005-05-11 16:45:16 +04:00
void WriteTargetRequiresRule(std::ostream& ruleFileStream,
cmTarget& target,
2005-05-17 19:15:09 +04:00
const std::vector<std::string>& objects);
void WriteObjectConvenienceRule(std::ostream& ruleFileStream,
const char* comment, const char* output,
LocalObjectInfo const& targets);
2005-05-11 16:45:16 +04:00
std::string GetObjectFileName(cmTarget& target,
const cmSourceFile& source,
std::string* nameWithoutTargetDir = 0);
2005-05-05 20:45:53 +04:00
void AppendRuleDepend(std::vector<std::string>& depends,
const char* ruleFileName);
void AppendCustomDepends(std::vector<std::string>& depends,
const std::vector<cmCustomCommand>& ccs);
void AppendCustomDepend(std::vector<std::string>& depends,
const cmCustomCommand& cc);
void AppendCustomCommands(std::vector<std::string>& commands,
const std::vector<cmCustomCommand>& ccs);
void AppendCustomCommand(std::vector<std::string>& commands,
const cmCustomCommand& cc);
void AppendCleanCommand(std::vector<std::string>& commands,
const std::vector<std::string>& files,
cmTarget& target, const char* filename =0);
2005-05-05 20:45:53 +04:00
bool ForceVerboseMakefiles;
2006-05-23 17:11:46 +04:00
std::map<cmStdString, std::vector<int> > ProgressFiles;
2005-05-05 20:45:53 +04:00
private:
friend class cmMakefileTargetGenerator;
friend class cmMakefileExecutableTargetGenerator;
friend class cmMakefileLibraryTargetGenerator;
friend class cmMakefileUtilityTargetGenerator;
2006-05-23 17:11:46 +04:00
friend class cmGlobalUnixMakefileGenerator3;
2006-03-15 19:02:08 +03:00
std::map<cmStdString, IntegrityCheckSetMap> CheckDependFiles;
2005-05-05 20:45:53 +04:00
//==========================================================================
// Configuration settings.
2006-03-15 19:02:08 +03:00
int MakefileVariableSize;
std::string IncludeDirective;
std::string MakeSilentFlag;
std::string ConfigurationName;
std::string NativeEchoCommand;
bool NativeEchoWindows;
2006-03-15 19:02:08 +03:00
bool DefineWindowsNULL;
bool UnixCD;
bool PassMakeflags;
bool SilentNoColon;
bool MakeCommandEscapeTargetTwice;
//==========================================================================
2005-05-05 20:45:53 +04:00
2006-03-15 19:02:08 +03:00
std::string HomeRelativeOutputPath;
/* Copy the setting of CMAKE_COLOR_MAKEFILE from the makefile at the
beginning of generation to avoid many duplicate lookups. */
bool ColorMakefile;
/* Copy the setting of CMAKE_SKIP_PREPROCESSED_SOURCE_RULES and
CMAKE_SKIP_ASSEMBLY_SOURCE_RULES at the beginning of generation to
avoid many duplicate lookups. */
bool SkipPreprocessedSourceRules;
bool SkipAssemblySourceRules;
std::map<cmStdString, LocalObjectInfo> LocalObjectFiles;
std::vector<cmStdString> LocalHelp;
/* does the work for each target */
std::vector<cmMakefileTargetGenerator *> TargetGenerators;
2006-03-15 19:02:08 +03:00
std::map<cmStdString, cmStdString> MakeVariableMap;
std::map<cmStdString, cmStdString> ShortMakeVariableMap;
2005-05-05 20:45:53 +04:00
};
#endif