| 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. |
| |
| Arguments to ``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. |
| |
| .. note:: |
| |
| Prefer the :command:`target_include_directories` command to add include |
| directories to individual targets and optionally propagate/export them |
| to dependents. |