summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2013-07-08 15:35:56 (GMT)
committerBrad King <brad.king@kitware.com>2013-07-08 15:55:33 (GMT)
commit93c116570591ac32bb6d19ee3fc23b9abd348a78 (patch)
tree458c52b7bc7331a752995140f7ee634e3cee2460
parent448a67714825a6d3018a6974153de6771080a8e6 (diff)
downloadCMake-93c116570591ac32bb6d19ee3fc23b9abd348a78.zip
CMake-93c116570591ac32bb6d19ee3fc23b9abd348a78.tar.gz
CMake-93c116570591ac32bb6d19ee3fc23b9abd348a78.tar.bz2
ExternalProject: Document multiple COMMAND lines
We support multiple commands per external project step by using the COMMAND keyword. Document this behavior and show an example. While at it, document that shell operators and current working directory behavior is not defined.
-rw-r--r--Modules/ExternalProject.cmake9
1 files changed, 9 insertions, 0 deletions
diff --git a/Modules/ExternalProject.cmake b/Modules/ExternalProject.cmake
index 6afdb97..3acb4f9 100644
--- a/Modules/ExternalProject.cmake
+++ b/Modules/ExternalProject.cmake
@@ -114,6 +114,15 @@
# and <TMP_DIR>
# with corresponding property values.
#
+# Any builtin step that specifies a "<step>_COMMAND cmd..." or custom
+# step that specifies a "COMMAND cmd..." may specify additional command
+# lines using the form "COMMAND cmd...". At build time the commands will
+# be executed in order and aborted if any one fails. For example:
+# ... BUILD_COMMAND make COMMAND echo done ...
+# specifies to run "make" and then "echo done" during the build step.
+# Whether the current working directory is preserved between commands
+# is not defined. Behavior of shell operators like "&&" is not defined.
+#
# The 'ExternalProject_Get_Property' function retrieves external project
# target properties:
# ExternalProject_Get_Property(<name> [prop1 [prop2 [...]]])