[0008668: CTest Dev: Missing executables shown as failed tests when using MPI.] Added a wrapping option to add_test so that exes built by the project can be safely wrapped in other exes and be listed as "not run" rather than "failed" if they are not built.

1 files changed, 6 insertions, 2 deletions

diff --git a/Source/cmAddTestCommand.h b/Source/cmAddTestCommand.h
index 2070fd3..a360ac0 100644
--- a/Source/cmAddTestCommand.h
+++ b/Source/cmAddTestCommand.h
@@ -56,7 +56,8 @@ public:
   virtual const char* GetFullDocumentation()
     {
     return
-      "  add_test(testname Exename arg1 arg2 ...)\n"
+      "  add_test(testname Exename arg1 arg2 ... \n"
+      "           [EXEC_PREFIX_CMD wrapperExe args...])\n"
       "If the ENABLE_TESTING command has been run, this command adds a "
       "test target to the current directory. If ENABLE_TESTING has not "
       "been run, this command does nothing.  "
@@ -65,7 +66,10 @@ public:
       "built by this project or an arbitrary executable on the "
       "system (like tclsh).  The test will be run with the current working "
       "directory set to the CMakeList.txt files corresponding directory "
-      "in the binary tree."
+      "in the binary tree.\n"
+      "Use EXEC_PREFIX_CMD to wrap an executable built by this project "
+      "in another executable such as mpiexec.  This will only run the "
+      "test if the wrapped executable was built."
       "\n"
       "  add_test(NAME <name> [CONFIGURATIONS [Debug|Release|...]]\n"
       "           COMMAND <command> [arg1 [arg2 ...]])\n"