[Cmake-commits] [cmake-commits] king committed cmAddCustomCommandCommand.h 1.36 1.37 cmAddCustomTargetCommand.h 1.24 1.25

[cmake-commits at cmake.org]

Update of /cvsroot/CMake/CMake/Source
In directory public:/mounts/ram/cvs-serv13580/Source

Modified Files:
	cmAddCustomCommandCommand.h cmAddCustomTargetCommand.h 
Log Message:
ENH: Clarify VERBATIM option documentation

The previous wording of the VERBATIM option documentation in the
add_custom_command and add_custom_target commands was confusing.  It
could be interpreted as the opposite of what the option means (no
escaping instead of escaping).  This clarifies the documentation to
explicitly state that it escapes.


Index: cmAddCustomTargetCommand.h
===================================================================
RCS file: /cvsroot/CMake/CMake/Source/cmAddCustomTargetCommand.h,v
retrieving revision 1.24
retrieving revision 1.25
diff -C 2 -d -r1.24 -r1.25
*** cmAddCustomTargetCommand.h	30 Mar 2009 12:27:28 -0000	1.24
--- cmAddCustomTargetCommand.h	1 Apr 2009 14:31:41 -0000	1.25
***************
*** 90,101 ****
        "and outputs of custom commands created with add_custom_command() in "
        "the same directory (CMakeLists.txt file).\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."
        "\n"
        "The SOURCES option specifies additional source files to be included "
--- 90,101 ----
        "and outputs of custom commands created with add_custom_command() in "
        "the same directory (CMakeLists.txt file).\n"
!       "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. "
        "Use of VERBATIM is recommended as it enables correct behavior. "
!       "When VERBATIM is not given the behavior is platform specific because "
!       "there is no protection of tool-specific special characters."
        "\n"
        "The SOURCES option specifies additional source files to be included "

Index: cmAddCustomCommandCommand.h
===================================================================
RCS file: /cvsroot/CMake/CMake/Source/cmAddCustomCommandCommand.h,v
retrieving revision 1.36
retrieving revision 1.37
diff -C 2 -d -r1.36 -r1.37
*** cmAddCustomCommandCommand.h	30 Mar 2009 12:27:25 -0000	1.36
--- cmAddCustomCommandCommand.h	1 Apr 2009 14:31:39 -0000	1.37
***************
*** 124,135 ****
        "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. "
        "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.\n"
        "If the output of the custom command is not actually "
        "created as a file on disk it should be marked as SYMBOLIC with "
--- 124,136 ----
        "but may be used in the future."
        "\n"
!       "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_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 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 "