BUG: Corrected and updated documentation of the -P option, -C option, GET_TARGET_PROPERTY command, and GET_SOURCE_FILE_PROPERTY command.

This commit is contained in:
Brad King 2005-09-21 13:31:43 -04:00
parent 059f62c5ea
commit c59d56f653
4 changed files with 15 additions and 10 deletions

View File

@ -53,9 +53,9 @@ public:
{
return
" GET_SOURCE_FILE_PROPERTY(VAR file property)\n"
"Get a property from a source file. The value of the property is "
"Get a property from a source file. The value of the property is "
"stored in the variable VAR. If the property is not found, var "
"will be set to NOT_FOUND. Use SET_SOURCE_FILES_PROPERTIES to set "
"will be set to \"NOTFOUND\". Use SET_SOURCE_FILES_PROPERTIES to set "
"property values. Source file properties usually control how the "
"file is built.";
}

View File

@ -53,19 +53,19 @@ public:
{
return
" GET_TARGET_PROPERTY(VAR target property)\n"
"Get a property from a target. The value of the property is "
"Get a property from a target. The value of the property is "
"stored in the variable VAR. If the property is not found, var "
"will be set to NOT_FOUND. Use SET_TARGET_PROPERTIES to set "
"will be set to \"NOTFOUND\". Use SET_TARGET_PROPERTIES to set "
"property values. Properties are usually used to control how "
"a target is built. The read-only property \"LOCATION\" specifies "
"a target is built.\n"
"The read-only property \"LOCATION\" specifies "
"the full path to the file on disk that will be created for the "
"target. This is very useful for executable targets to get "
"the path to the executable file for use in a custom command. "
"the path to the executable file for use in a custom command.\n"
"The read-only property \"TYPE\" returns which type the specified "
"target has (EXECUTABLE, STATIC_LIBRARY, SHARED_LIBRARY, "
"MODULE_LIBRARY, UTILITY, INSTALL_FILES or INSTALL_PROGRAMS)."
"This command can get properties for any target so far created. "
"MODULE_LIBRARY, UTILITY, INSTALL_FILES or INSTALL_PROGRAMS). "
"This command can get properties for any target so far created.\n"
"The targets do not need to be in the current CMakeLists.txt file.";
}

View File

@ -318,13 +318,15 @@ private:
};
#define CMAKE_STANDARD_OPTIONS_TABLE \
{"-C <initial-cache>", "Pre-load cmake cache from given file.", \
{"-C <initial-cache>", "Pre-load a script to populate the cache.", \
"When cmake is first run in an empty build tree, it creates a " \
"CMakeCache.txt file and populates it with customizable settings " \
"for the project. This option may be used to specify a file from " \
"which to load cache entries before the first pass through " \
"the project's cmake listfiles. The loaded entries take priority " \
"over the project's default values."}, \
"over the project's default values. The given file should be a CMake " \
"script containing SET commands that use the CACHE option, " \
"not a cache-format file."}, \
{"-D <var>:<type>=<value>", "Create a cmake cache entry.", \
"When cmake is first run in an empty build tree, it creates a " \
"CMakeCache.txt file and populates it with customizable settings " \

View File

@ -74,6 +74,9 @@ static const cmDocumentationEntry cmDocumentationOptions[] =
"each variable."},
{"-N", "View mode only.",
"Only load the cache. Do not actually run configure and generate steps."},
{"-P <file>", "Process script mode.",
"Process the given cmake file as a script written in the CMake language. "
"No configure or generate step is performed and the cache is not modified."},
{"--help-command cmd [file]", "Print help for a single command and exit.",
"Full documentation specific to the given command is displayed."},
{"--help-command-list [file]", "List available listfile commands and exit.",