kolan/CMake
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Documentation: Clarify configure_file behavior

Browse Source
This commit is contained in:
Brad King 2012-11-07 14:11:12 -05:00
parent 07d5e4b871
commit fa046735ae
1 changed files with 14 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
Source/cmConfigureFileCommand.h
View File

@ -68,6 +68,9 @@ public:
"If <output> names an existing directory the input file is placed " "If <output> names an existing directory the input file is placed "
"in that directory with its original name. " "in that directory with its original name. "
"\n" "\n"
"If the <input> file is modified the build system will re-run CMake "
"to re-configure the file and generate the build system again."
"\n"
"This command replaces any variables in the input file referenced as " "This command replaces any variables in the input file referenced as "
"${VAR} or @VAR@ with their values as determined by CMake. If a " "${VAR} or @VAR@ with their values as determined by CMake. If a "
"variable is not defined, it will be replaced with nothing. " "variable is not defined, it will be replaced with nothing. "
@ -77,12 +80,17 @@ public:
"The file will be configured with the current values of CMake " "The file will be configured with the current values of CMake "
"variables. If @ONLY is specified, only variables " "variables. If @ONLY is specified, only variables "
"of the form @VAR@ will be replaced and ${VAR} will be ignored. " "of the form @VAR@ will be replaced and ${VAR} will be ignored. "
"This is useful for configuring scripts that use ${VAR}. " "This is useful for configuring scripts that use ${VAR}."
"Any occurrences of #cmakedefine VAR will be replaced with " "\n"
"either #define VAR or /* #undef VAR */ depending on " "Input file lines of the form \"#cmakedefine VAR ...\" "
"the setting of VAR in CMake. Any occurrences of #cmakedefine01 VAR " "will be replaced with either \"#define VAR ...\" or "
"will be replaced with either #define VAR 1 or #define VAR 0 " "\"/* #undef VAR */\" depending on whether VAR is set in CMake to "
"depending on whether VAR evaluates to TRUE or FALSE in CMake.\n" "any value not considered a false constant by the if() command. "
"(Content of \"...\", if any, is processed as above.) "
"Input file lines of the form \"#cmakedefine01 VAR\" "
"will be replaced with either \"#define VAR 1\" or "
"\"#define VAR 0\" similarly."
"\n"
"With NEWLINE_STYLE the line ending could be adjusted: \n" "With NEWLINE_STYLE the line ending could be adjusted: \n"
" 'UNIX' or 'LF' for \\n, 'DOS', 'WIN32' or 'CRLF' for \\r\\n.\n" " 'UNIX' or 'LF' for \\n, 'DOS', 'WIN32' or 'CRLF' for \\r\\n.\n"
"COPYONLY must not be used with NEWLINE_STYLE.\n"; "COPYONLY must not be used with NEWLINE_STYLE.\n";