summaryrefslogtreecommitdiffstats
path: root/Help/prop_tgt/INCLUDE_DIRECTORIES.rst
blob: 8b40d9c3464ee82689178a94d59c7e72b3538bc4 (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
INCLUDE_DIRECTORIES
-------------------

List of preprocessor include file search directories.

This property specifies the list of directories given so far to the
:command:`target_include_directories` command.  In addition to accepting
values from that command, values may be set directly on any
target using the :command:`set_property` command.  A target gets its
initial value for this property from the value of the
:prop_dir:`INCLUDE_DIRECTORIES` directory property.  Both directory and
target property values are adjusted by calls to the
:command:`include_directories` command.

The value of this property is used by the generators to set the include
paths for the compiler.

Relative paths should not be added to this property directly. Use one of
the commands above instead to handle relative paths.

Contents of ``INCLUDE_DIRECTORIES`` may use "generator expressions" with
the syntax ``$<...>``.  See the :manual:`cmake-generator-expressions(7)`
manual for available expressions.  See the :manual:`cmake-buildsystem(7)`
manual for more on defining buildsystem properties.