diff options
Diffstat (limited to 'Source/cmAddCustomCommandCommand.h')
| -rw-r--r-- | Source/cmAddCustomCommandCommand.h | 13 |
1 files changed, 7 insertions, 6 deletions
diff --git a/Source/cmAddCustomCommandCommand.h b/Source/cmAddCustomCommandCommand.h index 8add9708ec..e750ebfa3c 100644 --- a/Source/cmAddCustomCommandCommand.h +++ b/Source/cmAddCustomCommandCommand.h @@ -123,14 +123,15 @@ public: "options are currently ignored when APPEND is given, " "but may be used in the future." "\n" - "If VERBATIM is given then all the arguments to the commands will be " - "passed exactly as specified no matter the build tool used. " + "If VERBATIM is given then all arguments to the commands will be " + "escaped properly for the build tool so that the invoked command " + "receives each argument unchanged. " "Note that one level of escapes is still used by the CMake language " - "processor before ADD_CUSTOM_TARGET even sees the arguments. " + "processor before add_custom_command 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.\n" + "When VERBATIM is not given the behavior is platform specific because " + "there is no protection of tool-specific special characters." + "\n" "If the output of the custom command is not actually " "created as a file on disk it should be marked as SYMBOLIC with " "SET_SOURCE_FILES_PROPERTIES.\n" |