summaryrefslogtreecommitdiffstats
path: root/Help/command/add_custom_target.rst
blob: 1bf70bffd9bea2be85373fdc733286f21c4c5086 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
add_custom_target
-----------------

Add a target with no output so it will always be built.

::

  add_custom_target(Name [ALL] [command1 [args1...]]
                    [COMMAND command2 [args2...] ...]
                    [DEPENDS depend depend depend ... ]
                    [WORKING_DIRECTORY dir]
                    [COMMENT comment] [VERBATIM]
                    [SOURCES src1 [src2...]])

Adds a target with the given name that executes the given commands.
The target has no output file and is ALWAYS CONSIDERED OUT OF DATE
even if the commands try to create a file with the name of the target.
Use ADD_CUSTOM_COMMAND to generate a file with dependencies.  By
default nothing depends on the custom target.  Use ADD_DEPENDENCIES to
add dependencies to or from other targets.  If the ALL option is
specified it indicates that this target should be added to the default
build target so that it will be run every time (the command cannot be
called ALL).  The command and arguments are optional and if not
specified an empty target will be created.  If WORKING_DIRECTORY is
set, then the command will be run in that directory.  If it is a
relative path it will be interpreted relative to the build tree
directory corresponding to the current source directory.  If COMMENT
is set, the value will be displayed as a message before the commands
are executed at build time.  Dependencies listed with the DEPENDS
argument may reference files and outputs of custom commands created
with add_custom_command() in the same directory (CMakeLists.txt file).

If VERBATIM is given then all arguments to the commands will be
escaped properly for the build tool so that the invoked command
receives each argument unchanged.  Note that one level of escapes is
still used by the CMake language processor before add_custom_target
even sees the arguments.  Use of VERBATIM is recommended as it enables
correct behavior.  When VERBATIM is not given the behavior is platform
specific because there is no protection of tool-specific special
characters.

The SOURCES option specifies additional source files to be included in
the custom target.  Specified source files will be added to IDE
project files for convenience in editing even if they have not build
rules.