ENH: Added INSTALL(CODE) mode to allow inline specification of install script code. This reduces the need for configuring an install script that needs some variable settings because the install code can set thing up first.

1 files changed, 8 insertions, 4 deletions

diff --git a/Source/cmInstallCommand.h b/Source/cmInstallCommand.h
index ea5e2010f1..4907b91e2a 100644
--- a/Source/cmInstallCommand.h
+++ b/Source/cmInstallCommand.h
@@ -156,12 +156,16 @@ public:
       "such as shell scripts.  Use the TARGETS form to install targets "
       "built within the project."
       "\n"
-      "The SCRIPT signature:\n"
-      "  INSTALL(SCRIPT <file1> [SCRIPT <file2> [...]])\n"
+      "The SCRIPT and CODE signature:\n"
+      "  INSTALL([[SCRIPT <file>] [CODE <code>]] [...])\n"
       "The SCRIPT form will invoke the given CMake script files during "
       "installation.  If the script file name is a relative path "
-      "it will be interpreted with respect to the current source directory."
-      "\n"
+      "it will be interpreted with respect to the current source directory.  "
+      "The CODE form will invoke the given CMake code during installation.  "
+      "Code is specified as a single argument inside a double-quoted string.  "
+      "For example, the code\n"
+      "  INSTALL(CODE \"MESSAGE(\\\"Sample install message.\\\")\")\n"
+      "will print a message during installation.\n"
       "NOTE: This command supercedes the INSTALL_TARGETS command and the "
       "target properties PRE_INSTALL_SCRIPT and POST_INSTALL_SCRIPT.  "
       "It also replaces the FILES forms of the INSTALL_FILES and "