diff options
| author | Brad King <brad.king@kitware.com> | 2014-06-03 13:03:51 (GMT) |
|---|---|---|
| committer | CMake Topic Stage <kwrobot@kitware.com> | 2014-06-03 13:03:51 (GMT) |
| commit | a38cc338244dd8cd6bff164b107bf22e564b31b9 (patch) | |
| tree | 93faec55a7b066057630cda52a639ce92f8e7026 /Help/command | |
| parent | f60da64a4d98e1fc78c14e7a48c23490f34406e0 (diff) | |
| parent | 907e422bc889135e9789ead872c0fd644ba76186 (diff) | |
| download | CMake-a38cc338244dd8cd6bff164b107bf22e564b31b9.zip CMake-a38cc338244dd8cd6bff164b107bf22e564b31b9.tar.gz CMake-a38cc338244dd8cd6bff164b107bf22e564b31b9.tar.bz2 | |
Merge topic 'doc-include-dir-props'
907e422b Help: Explain build/install-tree include dirs in more places (#14946)
Diffstat (limited to 'Help/command')
| -rw-r--r-- | Help/command/target_include_directories.rst | 14 |
1 files changed, 14 insertions, 0 deletions
diff --git a/Help/command/target_include_directories.rst b/Help/command/target_include_directories.rst index 75f917d..581bace 100644 --- a/Help/command/target_include_directories.rst +++ b/Help/command/target_include_directories.rst @@ -40,3 +40,17 @@ Arguments to ``target_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. + +Include directories usage requirements commonly differ between the build-tree +and the install-tree. The ``BUILD_INTERFACE`` and ``INSTALL_INTERFACE`` +generator expressions can be used to describe separate usage requirements +based on the usage location. Relative paths are allowed within the +``INSTALL_INTERFACE`` expression and are interpreted relative to the +installation prefix. For example: + +.. code-block:: cmake + + target_include_directories(mylib PUBLIC + $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include/mylib> + $<INSTALL_INTERFACE:include/mylib> # <prefix>/include/mylib + ) |