mirror of
https://github.com/Kitware/CMake.git
synced 2025-06-10 07:58:03 +08:00
700cdf393a
The configure_file() command now converts relative output paths to full paths using the current binary directory. Input relative paths were already converted using the current source directory, but this behavior was not previously documented.
105 lines
3.4 KiB
C++
105 lines
3.4 KiB
C++
/*=========================================================================
|
|
|
|
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 cmConfigureFileCommand_h
|
|
#define cmConfigureFileCommand_h
|
|
|
|
#include "cmCommand.h"
|
|
|
|
class cmConfigureFileCommand : public cmCommand
|
|
{
|
|
public:
|
|
cmTypeMacro(cmConfigureFileCommand, cmCommand);
|
|
|
|
virtual cmCommand* Clone()
|
|
{
|
|
return new cmConfigureFileCommand;
|
|
}
|
|
|
|
/**
|
|
* This is called when the command is first encountered in
|
|
* the input file.
|
|
*/
|
|
virtual bool InitialPass(std::vector<std::string> const& args,
|
|
cmExecutionStatus &status);
|
|
|
|
/**
|
|
* The name of the command as specified in CMakeList.txt.
|
|
*/
|
|
virtual const char* GetName() { return "configure_file";}
|
|
|
|
/**
|
|
* This determines if the command is invoked when in script mode.
|
|
*/
|
|
virtual bool IsScriptable() { return true; }
|
|
|
|
/**
|
|
* Succinct documentation.
|
|
*/
|
|
virtual const char* GetTerseDocumentation()
|
|
{
|
|
return "Copy a file to another location and modify its contents.";
|
|
}
|
|
|
|
/**
|
|
* Longer documentation.
|
|
*/
|
|
virtual const char* GetFullDocumentation()
|
|
{
|
|
return
|
|
" configure_file(<input> <output>\n"
|
|
" [COPYONLY] [ESCAPE_QUOTES] [@ONLY])\n"
|
|
"Copies a file <input> to file <output> and substitutes variable "
|
|
"values referenced in the file content. "
|
|
"If <input> is a relative path it is evaluated with respect to "
|
|
"the current source directory. "
|
|
"If <output> is a relative path it is evaluated with respect to "
|
|
"the current binary directory. "
|
|
"\n"
|
|
"This command replaces any variables in the input file referenced as "
|
|
"${VAR} or @VAR@ with their values as determined by CMake. If a "
|
|
"variable is not defined, it will be replaced with nothing. "
|
|
"If COPYONLY is specified, then no variable expansion will take "
|
|
"place. If ESCAPE_QUOTES is specified then any substituted quotes "
|
|
"will be C-style escaped. "
|
|
"The file will be configured with the current values of CMake "
|
|
"variables. If @ONLY is specified, only variables "
|
|
"of the form @VAR@ will be replaces and ${VAR} will be ignored. "
|
|
"This is useful for configuring scripts that use ${VAR}. "
|
|
"Any occurrences of #cmakedefine VAR will be replaced with "
|
|
"either #define VAR or /* #undef VAR */ depending on "
|
|
"the setting of VAR in CMake. Any occurrences of #cmakedefine01 VAR "
|
|
"will be replaced with either #define VAR 1 or #define VAR 0 "
|
|
"depending on whether VAR evaluates to TRUE or FALSE in CMake";
|
|
}
|
|
|
|
virtual void FinalPass();
|
|
virtual bool HasFinalPass() const { return !this->Immediate; }
|
|
private:
|
|
int ConfigureFile();
|
|
|
|
std::string InputFile;
|
|
std::string OutputFile;
|
|
bool CopyOnly;
|
|
bool EscapeQuotes;
|
|
bool Immediate;
|
|
bool AtOnly;
|
|
};
|
|
|
|
|
|
|
|
#endif
|