e934b1f503
The wording "Commands in the file are processed immediately as if they were written in place of the include command" sounds as if some kind of macro replacement is performed. This is not accurate. Update the wording to describe behavior of the included code in terms of the variable access scope.
94 lines
2.9 KiB
C++
94 lines
2.9 KiB
C++
/*============================================================================
|
|
CMake - Cross Platform Makefile Generator
|
|
Copyright 2000-2009 Kitware, Inc., Insight Software Consortium
|
|
|
|
Distributed under the OSI-approved BSD License (the "License");
|
|
see accompanying file Copyright.txt for details.
|
|
|
|
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.
|
|
============================================================================*/
|
|
#ifndef cmIncludeCommand_h
|
|
#define cmIncludeCommand_h
|
|
|
|
#include "cmCommand.h"
|
|
|
|
/** \class cmIncludeCommand
|
|
* \brief
|
|
*
|
|
* cmIncludeCommand defines a list of distant
|
|
* files that can be "included" in the current list file.
|
|
* In almost every sense, this is identical to a C/C++
|
|
* #include command. Arguments are first expended as usual.
|
|
*/
|
|
class cmIncludeCommand : public cmCommand
|
|
{
|
|
public:
|
|
/**
|
|
* This is a virtual constructor for the command.
|
|
*/
|
|
virtual cmCommand* Clone()
|
|
{
|
|
return new cmIncludeCommand;
|
|
}
|
|
|
|
/**
|
|
* This is called when the command is first encountered in
|
|
* the CMakeLists.txt file.
|
|
*/
|
|
virtual bool InitialPass(std::vector<std::string> const& args,
|
|
cmExecutionStatus &status);
|
|
|
|
/**
|
|
* This determines if the command is invoked when in script mode.
|
|
*/
|
|
virtual bool IsScriptable() const { return true; }
|
|
|
|
/**
|
|
* The name of the command as specified in CMakeList.txt.
|
|
*/
|
|
virtual const char* GetName() const {return "include";}
|
|
|
|
/**
|
|
* Succinct documentation.
|
|
*/
|
|
virtual const char* GetTerseDocumentation() const
|
|
{
|
|
return "Load and run CMake code from a file or module.";
|
|
}
|
|
|
|
/**
|
|
* More documentation.
|
|
*/
|
|
virtual const char* GetFullDocumentation() const
|
|
{
|
|
return
|
|
" include(<file|module> [OPTIONAL] [RESULT_VARIABLE <VAR>]\n"
|
|
" [NO_POLICY_SCOPE])\n"
|
|
"Load and run CMake code from the file given. "
|
|
"Variable reads and writes access the scope of the caller "
|
|
"(dynamic scoping). "
|
|
"If OPTIONAL is present, then no error "
|
|
"is raised if the file does not exist. If RESULT_VARIABLE is given "
|
|
"the variable will be set to the full filename which "
|
|
"has been included or NOTFOUND if it failed.\n"
|
|
"If a module is specified instead of a file, the file with name "
|
|
"<modulename>.cmake is searched first in CMAKE_MODULE_PATH, then in the "
|
|
"CMake module directory. There is one exception to this: if the file "
|
|
"which calls include() is located itself in the CMake module directory, "
|
|
"then first the CMake module directory is searched and "
|
|
"CMAKE_MODULE_PATH afterwards. See also policy CMP0017."
|
|
"\n"
|
|
"See the cmake_policy() command documentation for discussion of the "
|
|
"NO_POLICY_SCOPE option."
|
|
;
|
|
}
|
|
|
|
cmTypeMacro(cmIncludeCommand, cmCommand);
|
|
};
|
|
|
|
|
|
|
|
#endif
|