ENH: LOAD_COMMAND command will now set a variable called CMAKE_LOADED_COMMAND_<COMMAND_NAME> to the full path of the loaded module if loading was successful. Otherwise the variable is not set (will evaluate to empty string). This is useful both in testing whether loading worked and for installing loaded command modules.

1 files changed, 5 insertions, 1 deletions

diff --git a/Source/cmLoadCommandCommand.h b/Source/cmLoadCommandCommand.h
index 8737da2..aae0342 100644
--- a/Source/cmLoadCommandCommand.h
+++ b/Source/cmLoadCommandCommand.h
@@ -70,7 +70,11 @@ public:
       "The given locations are searched for a library whose name is "
       "cmCOMMAND_NAME.  If found, it is loaded as a module and the command "
       "is added to the set of available CMake commands.  Usually, TRY_COMPILE "
-      "is used before this command to compile the module.";
+      "is used before this command to compile the module.  If the command "
+      "is successfully loaded a variable named\n"
+      "  CMAKE_LOADED_COMMAND_<COMMAND_NAME>\n"
+      "will be set to the full path of the module that was loaded.  "
+      "Otherwise the variable will not be set.";
     }
   
   cmTypeMacro(cmLoadCommandCommand, cmCommand);