2009-09-28 19:43:28 +04:00
|
|
|
/*============================================================================
|
|
|
|
CMake - Cross Platform Makefile Generator
|
|
|
|
Copyright 2000-2009 Kitware, Inc., Insight Software Consortium
|
2001-01-11 16:04:28 +03:00
|
|
|
|
2009-09-28 19:43:28 +04:00
|
|
|
Distributed under the OSI-approved BSD License (the "License");
|
|
|
|
see accompanying file Copyright.txt for details.
|
2001-01-11 16:04:28 +03:00
|
|
|
|
2009-09-28 19:43:28 +04:00
|
|
|
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.
|
|
|
|
============================================================================*/
|
2001-01-18 19:20:24 +03:00
|
|
|
#ifndef cmIncludeDirectoryCommand_h
|
|
|
|
#define cmIncludeDirectoryCommand_h
|
2001-01-05 19:41:20 +03:00
|
|
|
|
2001-01-18 19:20:24 +03:00
|
|
|
#include "cmCommand.h"
|
2001-01-05 19:41:20 +03:00
|
|
|
|
2001-01-18 19:20:24 +03:00
|
|
|
/** \class cmIncludeDirectoryCommand
|
2001-01-11 16:04:28 +03:00
|
|
|
* \brief Add include directories to the build.
|
|
|
|
*
|
2001-01-18 19:20:24 +03:00
|
|
|
* cmIncludeDirectoryCommand is used to specify directory locations
|
2001-01-11 16:04:28 +03:00
|
|
|
* to search for included files.
|
|
|
|
*/
|
2001-01-18 19:20:24 +03:00
|
|
|
class cmIncludeDirectoryCommand : public cmCommand
|
2001-01-05 19:41:20 +03:00
|
|
|
{
|
|
|
|
public:
|
2001-01-11 16:04:28 +03:00
|
|
|
/**
|
2001-01-18 19:20:24 +03:00
|
|
|
* This is a virtual constructor for the command.
|
2001-01-11 16:04:28 +03:00
|
|
|
*/
|
2012-08-13 21:42:58 +04:00
|
|
|
virtual cmCommand* Clone()
|
2001-01-05 19:41:20 +03:00
|
|
|
{
|
2001-01-18 19:20:24 +03:00
|
|
|
return new cmIncludeDirectoryCommand;
|
2001-01-05 19:41:20 +03:00
|
|
|
}
|
2001-01-11 16:04:28 +03:00
|
|
|
|
|
|
|
/**
|
2001-01-18 19:20:24 +03:00
|
|
|
* This is called when the command is first encountered in
|
2001-01-11 16:04:28 +03:00
|
|
|
* the CMakeLists.txt file.
|
|
|
|
*/
|
2008-01-23 18:28:26 +03:00
|
|
|
virtual bool InitialPass(std::vector<std::string> const& args,
|
|
|
|
cmExecutionStatus &status);
|
2001-01-11 16:04:28 +03:00
|
|
|
|
|
|
|
/**
|
2001-01-18 19:20:24 +03:00
|
|
|
* The name of the command as specified in CMakeList.txt.
|
2001-01-11 16:04:28 +03:00
|
|
|
*/
|
2012-02-25 10:49:24 +04:00
|
|
|
virtual const char* GetName() const { return "include_directories";}
|
2001-01-11 16:04:28 +03:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Succinct documentation.
|
|
|
|
*/
|
2012-02-25 10:49:24 +04:00
|
|
|
virtual const char* GetTerseDocumentation() const
|
2001-01-05 19:41:20 +03:00
|
|
|
{
|
2001-01-11 16:04:28 +03:00
|
|
|
return "Add include directories to the build.";
|
2001-01-05 19:41:20 +03:00
|
|
|
}
|
2012-08-13 21:42:58 +04:00
|
|
|
|
2001-01-11 16:04:28 +03:00
|
|
|
/**
|
|
|
|
* More documentation.
|
|
|
|
*/
|
2012-02-25 10:49:24 +04:00
|
|
|
virtual const char* GetFullDocumentation() const
|
2001-01-05 19:41:20 +03:00
|
|
|
{
|
2001-01-11 16:04:28 +03:00
|
|
|
return
|
2007-10-10 19:47:43 +04:00
|
|
|
" include_directories([AFTER|BEFORE] [SYSTEM] dir1 dir2 ...)\n"
|
2012-02-22 23:30:00 +04:00
|
|
|
"Add the given directories to those the compiler uses to search "
|
|
|
|
"for include files. "
|
|
|
|
"These directories are added to the directory property "
|
|
|
|
"INCLUDE_DIRECTORIES for the current CMakeLists file. "
|
|
|
|
"They are also added to the target property INCLUDE_DIRECTORIES "
|
|
|
|
"for each target in the current CMakeLists file. "
|
|
|
|
"The target property values are the ones used by the generators."
|
|
|
|
"\n"
|
|
|
|
"By default the directories are appended onto the current list of "
|
|
|
|
"directories. "
|
|
|
|
"This default behavior can be changed by setting "
|
|
|
|
"CMAKE_INCLUDE_DIRECTORIES_BEFORE to ON. "
|
|
|
|
"By using AFTER or BEFORE explicitly, you can select between "
|
|
|
|
"appending and prepending, independent of the default. "
|
2012-11-07 20:12:03 +04:00
|
|
|
"\n"
|
2012-02-22 23:30:00 +04:00
|
|
|
"If the SYSTEM option is given, the compiler will be told the "
|
2006-10-05 16:55:59 +04:00
|
|
|
"directories are meant as system include directories on some "
|
2012-11-07 20:12:03 +04:00
|
|
|
"platforms (signalling this setting might achieve effects such as "
|
|
|
|
"the compiler skipping warnings, or these fixed-install system files "
|
|
|
|
"not being considered in dependency calculations - see compiler docs).";
|
2001-01-05 19:41:20 +03:00
|
|
|
}
|
2012-08-13 21:42:58 +04:00
|
|
|
|
2001-02-26 20:07:53 +03:00
|
|
|
cmTypeMacro(cmIncludeDirectoryCommand, cmCommand);
|
2007-03-07 19:03:57 +03:00
|
|
|
|
|
|
|
protected:
|
|
|
|
// used internally
|
2013-01-20 15:28:59 +04:00
|
|
|
void GetIncludes(const std::string &arg, std::vector<std::string> &incs);
|
|
|
|
void NormalizeInclude(std::string &inc);
|
2001-01-05 19:41:20 +03:00
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#endif
|