|
|
|
|
include_directories
|
|
|
|
|
-------------------
|
|
|
|
|
|
|
|
|
|
Add include directories to the build.
|
|
|
|
|
|
|
|
|
|
.. code-block:: cmake
|
|
|
|
|
|
|
|
|
|
include_directories([AFTER|BEFORE] [SYSTEM] dir1 [dir2 ...])
|
|
|
|
|
|
|
|
|
|
Add the given directories to those the compiler uses to search for
|
|
|
|
|
include files. Relative paths are interpreted as relative to the
|
|
|
|
|
current source directory.
|
|
|
|
|
|
|
|
|
|
The include directories are added to the :prop_dir:`INCLUDE_DIRECTORIES`
|
|
|
|
|
directory property for the current ``CMakeLists`` file. They are also
|
|
|
|
|
added to the :prop_tgt:`INCLUDE_DIRECTORIES` target property for each
|
|
|
|
|
target in the current ``CMakeLists`` file. The target property values
|
|
|
|
|
are the ones used by the generators.
|
|
|
|
|
|
|
|
|
|
By default the directories specified are appended onto the current list of
|
|
|
|
|
directories. This default behavior can be changed by setting
|
|
|
|
|
:variable:`CMAKE_INCLUDE_DIRECTORIES_BEFORE` to ``ON``. By using
|
|
|
|
|
``AFTER`` or ``BEFORE`` explicitly, you can select between appending and
|
|
|
|
|
prepending, independent of the default.
|
|
|
|
|
|
|
|
|
|
If the ``SYSTEM`` option is given, the compiler will be told the
|
|
|
|
|
directories are meant as system include directories on some platforms.
|
|
|
|
|
Signalling this setting might achieve effects such as the compiler
|
|
|
|
|
skipping warnings, or these fixed-install system files not being
|
|
|
|
|
considered in dependency calculations - see compiler docs.
|
|
|
|
|
|
|
|
|
|
.. |command_name| replace:: ``include_directories``
|
|
|
|
|
.. include:: GENEX_NOTE.txt
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
|
|
|
|
|
Prefer the :command:`target_include_directories` command to add include
|
|
|
|
|
directories to individual targets and optionally propagate/export them
|
|
|
|
|
to dependents.
|
|
|
|
|
|
|
|
|
|
See Also
|
|
|
|
|
^^^^^^^^
|
|
|
|
|
|
|
|
|
|
* :command:`target_include_directories`
|
