diff options
| author | Brad King <brad.king@kitware.com> | 2006-09-28 11:30:49 -0400 |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2006-09-28 11:30:49 -0400 |
| commit | d01b6f12819c4d8aec189ae3eebfd1779565bbf2 (patch) | |
| tree | 90a04b304477a20c1adbc46b5ee2d892e4aae64b /Source/cmAddCustomTargetCommand.h | |
| parent | 16f8da8b1443b7ebb315f40aa1ae199d87f211de (diff) | |
| download | cmake-d01b6f12819c4d8aec189ae3eebfd1779565bbf2.tar.gz | |
ENH: Added VERBATIM option to ADD_CUSTOM_COMMAND and ADD_CUSTOM_TARGET commands. This option enables full escaping of custom command arguments on all platforms. See bug#3786.
Diffstat (limited to 'Source/cmAddCustomTargetCommand.h')
| -rw-r--r-- | Source/cmAddCustomTargetCommand.h | 14 |
1 files changed, 11 insertions, 3 deletions
diff --git a/Source/cmAddCustomTargetCommand.h b/Source/cmAddCustomTargetCommand.h index d6b38e324d..a8ed7c4943 100644 --- a/Source/cmAddCustomTargetCommand.h +++ b/Source/cmAddCustomTargetCommand.h @@ -65,8 +65,8 @@ public: return " ADD_CUSTOM_TARGET(Name [ALL] [command1 [args1...]]\n" " [COMMAND command2 [args2...] ...]\n" - " [DEPENDS depend depend depend ... ])\n" - " [WORKING_DIRECTORY dir]\n" + " [DEPENDS depend depend depend ... ]\n" + " [WORKING_DIRECTORY dir] [VERBATIM])\n" "Adds a target with the given name that executes the given commands. " "The target has no output file and is ALWAYS CONSIDERED OUT OF DATE " "even if the commands try to create a file with the name of the " @@ -82,7 +82,15 @@ public: "If WORKING_DIRECTORY is set, then the command will be run in that " "directory. " "Dependencies listed with the DEPENDS argument may reference files " - "and outputs of custom commands created with ADD_CUSTOM_COMMAND."; + "and outputs of custom commands created with ADD_CUSTOM_COMMAND.\n" + "If VERBATIM is given then all the arguments to the commands will be " + "passed exactly as specified no matter the build tool used. " + "Note that one level of escapes is still used by the CMake language " + "processor before ADD_CUSTOM_TARGET even sees the arguments. " + "Use of VERBATIM is recommended as it enables correct behavior. " + "When VERBATIM is not given the behavior is platform specific. " + "In the future VERBATIM may be enabled by default. The only reason " + "it is an option is to preserve compatibility with older CMake code."; } cmTypeMacro(cmAddCustomTargetCommand, cmCommand); |