summaryrefslogtreecommitdiff
path: root/Help/command/load_command.rst
diff options
context:
space:
mode:
Diffstat (limited to 'Help/command/load_command.rst')
-rw-r--r--Help/command/load_command.rst23
1 files changed, 23 insertions, 0 deletions
diff --git a/Help/command/load_command.rst b/Help/command/load_command.rst
new file mode 100644
index 000000000..a1576e8b5
--- /dev/null
+++ b/Help/command/load_command.rst
@@ -0,0 +1,23 @@
+load_command
+------------
+
+Disallowed. See CMake Policy :policy:`CMP0031`.
+
+Load a command into a running CMake.
+
+::
+
+ load_command(COMMAND_NAME <loc1> [loc2 ...])
+
+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,
+:command:`try_compile` is used before this command to compile the
+module. If the command is successfully loaded a variable named
+
+::
+
+ CMAKE_LOADED_COMMAND_<COMMAND_NAME>
+
+will be set to the full path of the module that was loaded. Otherwise
+the variable will not be set.