Merge branch 'source-file-property-documentation'

This commit is contained in:
Brad King 2010-06-15 13:59:58 -04:00
commit 8209300a6b
2 changed files with 11 additions and 29 deletions

View File

@ -66,7 +66,9 @@ public:
"directory (already processed by CMake) may be named by full or " "directory (already processed by CMake) may be named by full or "
"relative path.\n" "relative path.\n"
"TARGET scope may name zero or more existing targets.\n" "TARGET scope may name zero or more existing targets.\n"
"SOURCE scope may name zero or more source files.\n" "SOURCE scope may name zero or more source files. "
"Note that source file properties are visible only to targets "
"added in the same directory (CMakeLists.txt).\n"
"TEST scope may name zero or more existing tests.\n" "TEST scope may name zero or more existing tests.\n"
"CACHE scope must name zero or more cache existing entries.\n" "CACHE scope must name zero or more cache existing entries.\n"
"The required PROPERTY option is immediately followed by the name " "The required PROPERTY option is immediately followed by the name "

View File

@ -48,35 +48,15 @@ public:
virtual const char* GetFullDocumentation() virtual const char* GetFullDocumentation()
{ {
return return
" set_source_files_properties(file1 file2 ...\n" " set_source_files_properties([file1 [file2 [...]]]\n"
" PROPERTIES prop1 value1\n" " PROPERTIES prop1 value1\n"
" prop2 value2 ...)\n" " [prop2 value2 [...]])\n"
"Set properties on a file. The syntax for the command is to list all " "Set properties associated with source files using a key/value "
"the files you want " "paired list. "
"to change, and then provide the values you want to set next. You " "See properties documentation for those known to CMake. "
"can make up your own properties as well. " "Unrecognized properties are ignored. "
"The following are used by CMake. " "Source file properties are visible only to targets "
"The ABSTRACT flag (boolean) is used by some class wrapping " "added in the same directory (CMakeLists.txt).";
"commands. "
"If WRAP_EXCLUDE (boolean) is true then many wrapping commands "
"will ignore this file. If GENERATED (boolean) is true then it "
"is not an error if this source file does not exist when it is "
"added to a target. Obviously, "
"it must be created (presumably by a custom command) before the "
"target is built. "
"If the HEADER_FILE_ONLY (boolean) property is true then the "
"file is not compiled. This is useful if you want to add extra "
"non build files to an IDE. "
"OBJECT_DEPENDS (string) adds dependencies to the object file. "
"COMPILE_FLAGS (string) is passed to the compiler as additional "
"command line arguments when the source file is compiled. "
"LANGUAGE (string) CXX|C will change the default compiler used "
"to compile the source file. The languages used need to be enabled "
"in the PROJECT command. "
"If SYMBOLIC (boolean) is set to true the build system will be "
"informed that the source file is not actually created on disk but "
"instead used as a symbolic name for a build rule.";
} }
cmTypeMacro(cmSetSourceFilesPropertiesCommand, cmCommand); cmTypeMacro(cmSetSourceFilesPropertiesCommand, cmCommand);