CMake/Source/cmLocalUnixMakefileGenerato...

355 lines
14 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 cmTarget;
class cmSourceFile;
/** \class cmLocalUnixMakefileGenerator3
* \brief Write a LocalUnix makefiles.
*
* cmLocalUnixMakefileGenerator3 produces a LocalUnix makefile from its
* member m_Makefile.
*/
class cmLocalUnixMakefileGenerator3 : public cmLocalGenerator
{
public:
cmLocalUnixMakefileGenerator3();
virtual ~cmLocalUnixMakefileGenerator3();
2005-05-06 22:49:38 +04:00
/**
* Generate the makefile for this directory.
*/
virtual void Generate();
2005-06-01 21:37:49 +04:00
/**
* Process the CMakeLists files for this directory to fill in the
* m_Makefile ivar
*/
virtual void Configure();
2005-05-06 22:49:38 +04:00
/** creates the common disclainer text at the top of each makefile */
void WriteDisclaimer(std::ostream& os);
// 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);
// write the main variables used by the makefiles
2005-07-07 00:16:12 +04:00
void WriteMakeVariables(std::ostream& makefileStream, RelativeRoot root);
2005-05-06 22:49:38 +04:00
// write a comment line #====... in the stream
void WriteDivider(std::ostream& os);
/**
* If true, then explicitly pass MAKEFLAGS on the make all target for makes
* that do not use environment variables.
*
*/
void SetPassMakeflags(bool s){m_PassMakeflags = s;}
bool GetPassMakeflags() { return m_PassMakeflags; }
/**
* Set the flag used to keep the make program silent.
*/
void SetMakeSilentFlag(const char* s) { m_MakeSilentFlag = s; }
std::string &GetMakeSilentFlag() { return m_MakeSilentFlag; }
2005-05-05 20:45:53 +04:00
2005-05-11 16:45:16 +04:00
/** used to create a recursive make call */
std::string GetRecursiveMakeCall(const char *makefile, const char* tgt);
2005-05-06 22:49:38 +04:00
2005-05-05 20:45:53 +04:00
/** Set whether the echo command needs its argument quoted. */
void SetEchoNeedsQuote(bool b) { m_EchoNeedsQuote = b; }
/**
* 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.
*/
void SetWindowsShell(bool v) {m_WindowsShell = v;}
/**
* Set the string used to include one makefile into another default
* is include.
*/
void SetIncludeDirective(const char* s) { m_IncludeDirective = s; }
const char *GetIncludeDirective() { return m_IncludeDirective.c_str(); }
/**
* Set max makefile variable size, default is 0 which means unlimited.
*/
void SetMakefileVariableSize(int s) { m_MakefileVariableSize = s; }
/**
* If ignore lib prefix is true, then do not strip lib from the name
* of a library.
*/
void SetIgnoreLibPrefix(bool s) { m_IgnoreLibPrefix = s; }
2005-05-06 22:49:38 +04:00
2005-05-05 20:45:53 +04:00
/** Called from command-line hook to scan dependencies. */
2005-05-12 18:49:56 +04:00
virtual bool ScanDependencies(std::vector<std::string> const& args);
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 suahc as make test etc */
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 *> {};
struct IntegrityCheckSetMap: public std::map<cmStdString, IntegrityCheckSet> {};
std::map<cmStdString, IntegrityCheckSetMap> &GetIntegrityCheckSet()
2005-05-05 20:45:53 +04:00
{ return m_CheckDependFiles;}
void AppendTargetDepends(std::vector<std::string>& depends,
cmTarget& target);
void AppendGlobalTargetDepends(std::vector<std::string>& depends,
cmTarget& target);
void AppendEcho(std::vector<std::string>& commands,
const char* text);
2005-05-05 20:45:53 +04:00
protected:
// write the depend info
void WriteDependLanguageInfo(std::ostream& cmakefileStream, cmTarget &tgt);
2005-05-11 16:45:16 +04:00
// write the target rules for the local Makefile into the stream
2005-05-11 20:44:01 +04:00
void WriteLocalMakefileTargets(std::ostream& ruleFileStream);
// write the local help rule
void WriteHelpRule(std::ostream& ruleFileStream);
2005-05-11 16:45:16 +04:00
// create the cd to home commands
void CreateJumpCommand(std::vector<std::string>& commands,
const char *MakefileName,
std::string & localName);
2005-05-11 16:45:16 +04:00
2005-05-06 22:49:38 +04:00
// these two methods just compute reasonable values for m_LibraryOutputPath and
// m_ExecutableOutputPath
void ConfigureOutputPaths();
void FormatOutputPath(std::string& path, const char* name);
// this converts a file name that is relative to the StartOuputDirectory
// into a full path
std::string ConvertToFullPath(const std::string& localPath);
// this is responsible for writing all of the rules for all this
// directories custom commands (but not utility targets)
2005-07-28 23:24:31 +04:00
void WriteCustomCommands(std::ostream& os,
std::vector<std::string>& cleanFiles);
2005-05-06 22:49:38 +04:00
// this method Writes the Directory informaiton files
void WriteDirectoryInformationFile();
// cleanup the name of a potential target
std::string ConvertToMakeTarget(const char* tgt);
// used in writing out Cmake files such as WriteDirectoryInformation
void WriteCMakeArgument(std::ostream& os, const char* s);
// write out all the rules for this target
void WriteTargetRuleFiles(cmTarget& target);
void WriteUtilityRuleFiles(cmTarget& target);
2005-05-06 22:49:38 +04:00
// create the rule files for an object
void WriteObjectRuleFiles(cmTarget& target,
cmSourceFile& source,
std::vector<std::string>& objects,
std::ostream &filestr,
std::ostream &flagstr);
2005-05-06 22:49:38 +04:00
// write the build rule for an object
void WriteObjectBuildFile(std::string &obj,
const char *lang,
cmTarget& target,
cmSourceFile& source,
2005-05-06 22:49:38 +04:00
std::vector<std::string>& depends,
std::ostream &filestr,
std::ostream &flagstr);
2005-05-06 22:49:38 +04:00
// write the depend.make file for an object
void WriteObjectDependRules(cmSourceFile& source,
std::vector<std::string>& depends);
2005-05-17 19:15:09 +04:00
2005-05-06 22:49:38 +04:00
// this is used only by WriteObjectDependFile
2005-05-05 20:45:53 +04:00
bool GenerateDependsMakeFile(const std::string& lang,
const char* objFile);
2005-05-06 22:49:38 +04:00
// return the appropriate depends checker
cmDepends* GetDependsChecker(const std::string& lang,
bool verbose);
2005-05-06 22:49:38 +04:00
void GenerateCustomRuleFile(const cmCustomCommand& cc,
std::ostream &ruleStream);
2005-05-06 22:49:38 +04:00
// these three make some simple changes and then call WriteLibraryRule
2005-05-05 20:45:53 +04:00
void WriteStaticLibraryRule(std::ostream& ruleFileStream,
const char* ruleFileName,
cmTarget& target,
2005-05-05 20:45:53 +04:00
const std::vector<std::string>& objects,
const std::vector<std::string>& external_objects,
std::vector<std::string>& cleanFiles);
2005-05-05 20:45:53 +04:00
void WriteSharedLibraryRule(std::ostream& ruleFileStream,
const char* ruleFileName,
cmTarget& target,
2005-05-05 20:45:53 +04:00
const std::vector<std::string>& objects,
const std::vector<std::string>& external_objects,
std::vector<std::string>& cleanFiles);
2005-05-05 20:45:53 +04:00
void WriteModuleLibraryRule(std::ostream& ruleFileStream,
const char* ruleFileName,
cmTarget& target,
2005-05-05 20:45:53 +04:00
const std::vector<std::string>& objects,
const std::vector<std::string>& external_objects,
std::vector<std::string>& cleanFiles);
2005-05-06 22:49:38 +04:00
// the main code for writing the Executable target rules
void WriteExecutableRule(std::ostream& ruleFileStream,
const char* ruleFileName,
cmTarget& target,
2005-05-06 22:49:38 +04:00
const std::vector<std::string>& objects,
const std::vector<std::string>& external_objects,
std::vector<std::string>& cleanFiles);
2005-05-06 22:49:38 +04:00
// the main method for writing library rules
2005-05-05 20:45:53 +04:00
void WriteLibraryRule(std::ostream& ruleFileStream,
const char* ruleFileName,
cmTarget& target,
2005-05-05 20:45:53 +04:00
const std::vector<std::string>& objects,
const std::vector<std::string>& external_objects,
const char* linkRuleVar,
const char* extraLinkFlags,
std::vector<std::string>& cleanFiles);
2005-05-06 22:49:38 +04:00
2005-05-11 16:45:16 +04:00
void WriteLocalMakefile();
2005-05-06 22:49:38 +04:00
void WriteLocalRule(std::ostream& ruleFileStream, const char* pass,
const char* dependency);
void WriteConvenienceRule(std::ostream& ruleFileStream,
const char* realTarget,
const char* helpTarget);
2005-05-05 20:45:53 +04:00
void WriteObjectsVariable(std::ostream& ruleFileStream,
cmTarget& target,
2005-05-05 20:45:53 +04:00
const std::vector<std::string>& objects,
const std::vector<std::string>& external_objects,
std::string& variableName,
std::string& variableNameExternal);
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);
2005-05-11 16:45:16 +04:00
std::string GetTargetDirectory(cmTarget& target);
2005-05-05 20:45:53 +04:00
std::string GetSubdirTargetName(const char* pass, const char* subdir);
std::string GetObjectFileName(cmTarget& target,
2005-05-05 20:45:53 +04:00
const cmSourceFile& source);
const char* GetSourceFileLanguage(const cmSourceFile& source);
std::string ConvertToQuotedOutputPath(const char* p);
void AppendAnyDepend(std::vector<std::string>& depends, const char* name,
bool assume_unknown_is_file=false);
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);
//==========================================================================
bool SamePath(const char* path1, const char* path2);
std::string& CreateSafeUniqueObjectFileName(const char* sin);
std::string CreateMakeVariable(const char* sin, const char* s2in);
//==========================================================================
2005-06-01 21:37:49 +04:00
void ComputeHomeRelativeOutputPath();
2005-05-05 20:45:53 +04:00
private:
std::map<cmStdString, IntegrityCheckSetMap> m_CheckDependFiles;
2005-05-05 20:45:53 +04:00
//==========================================================================
// Configuration settings.
int m_MakefileVariableSize;
std::map<cmStdString, cmStdString> m_MakeVariableMap;
std::map<cmStdString, cmStdString> m_ShortMakeVariableMap;
std::map<cmStdString, cmStdString> m_UniqueObjectNamesMap;
std::string m_IncludeDirective;
std::string m_MakeSilentFlag;
std::string m_ExecutableOutputPath;
std::string m_LibraryOutputPath;
bool m_PassMakeflags;
//==========================================================================
// Flag for whether echo command needs quotes.
bool m_EchoNeedsQuote;
2005-06-01 21:37:49 +04:00
std::string m_HomeRelativeOutputPath;
2005-05-05 20:45:53 +04:00
// Set of object file names that will be built in this directory.
std::set<cmStdString> m_ObjectFiles;
std::map<cmStdString,std::vector<cmTarget *> > m_LocalObjectFiles;
2005-05-05 20:45:53 +04:00
};
#endif