summaryrefslogtreecommitdiffstats
path: root/Help/command/add_executable.rst
diff options
context:
space:
mode:
Diffstat (limited to 'Help/command/add_executable.rst')
-rw-r--r--Help/command/add_executable.rst73
1 files changed, 73 insertions, 0 deletions
diff --git a/Help/command/add_executable.rst b/Help/command/add_executable.rst
new file mode 100644
index 0000000..656af7c
--- /dev/null
+++ b/Help/command/add_executable.rst
@@ -0,0 +1,73 @@
+add_executable
+--------------
+
+Add an executable to the project using the specified source files.
+
+::
+
+ add_executable(<name> [WIN32] [MACOSX_BUNDLE]
+ [EXCLUDE_FROM_ALL]
+ source1 source2 ... sourceN)
+
+Adds an executable target called <name> to be built from the source
+files listed in the command invocation. The <name> corresponds to the
+logical target name and must be globally unique within a project. The
+actual file name of the executable built is constructed based on
+conventions of the native platform (such as <name>.exe or just
+<name>).
+
+By default the executable file will be created in the build tree
+directory corresponding to the source tree directory in which the
+command was invoked. See documentation of the
+RUNTIME_OUTPUT_DIRECTORY target property to change this location. See
+documentation of the OUTPUT_NAME target property to change the <name>
+part of the final file name.
+
+If WIN32 is given the property WIN32_EXECUTABLE will be set on the
+target created. See documentation of that target property for
+details.
+
+If MACOSX_BUNDLE is given the corresponding property will be set on
+the created target. See documentation of the MACOSX_BUNDLE target
+property for details.
+
+If EXCLUDE_FROM_ALL is given the corresponding property will be set on
+the created target. See documentation of the EXCLUDE_FROM_ALL target
+property for details.
+
+The add_executable command can also create IMPORTED executable targets
+using this signature:
+
+::
+
+ add_executable(<name> IMPORTED [GLOBAL])
+
+An IMPORTED executable target references an executable file located
+outside the project. No rules are generated to build it. The target
+name has scope in the directory in which it is created and below, but
+the GLOBAL option extends visibility. It may be referenced like any
+target built within the project. IMPORTED executables are useful for
+convenient reference from commands like add_custom_command. Details
+about the imported executable are specified by setting properties
+whose names begin in "IMPORTED_". The most important such property is
+IMPORTED_LOCATION (and its per-configuration version
+IMPORTED_LOCATION_<CONFIG>) which specifies the location of the main
+executable file on disk. See documentation of the IMPORTED_*
+properties for more information.
+
+The signature
+
+::
+
+ add_executable(<name> ALIAS <target>)
+
+creates an alias, such that <name> can be used to refer to <target> in
+subsequent commands. The <name> does not appear in the generated
+buildsystem as a make target. The <target> may not be an IMPORTED
+target or an ALIAS. Alias targets can be used as linkable targets,
+targets to read properties from, executables for custom commands and
+custom targets. They can also be tested for existance with the
+regular if(TARGET) subcommand. The <name> may not be used to modify
+properties of <target>, that is, it may not be used as the operand of
+set_property, set_target_properties, target_link_libraries etc. An
+ALIAS target may not be installed of exported.