summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2014-04-21 13:32:30 (GMT)
committerCMake Topic Stage <kwrobot@kitware.com>2014-04-21 13:32:30 (GMT)
commita0972532b3d6bc31ac3cbf432cd0566e5d4b8f31 (patch)
tree977c3a6dbf8598930bdcd62734bad5ac341436f6
parentbb891c2ef1d5f2cf95fff64fe183a8f6d512d6ea (diff)
parent692228e41821a1af1f904304984c7366ae2ca288 (diff)
downloadCMake-a0972532b3d6bc31ac3cbf432cd0566e5d4b8f31.zip
CMake-a0972532b3d6bc31ac3cbf432cd0566e5d4b8f31.tar.gz
CMake-a0972532b3d6bc31ac3cbf432cd0566e5d4b8f31.tar.bz2
Merge topic 'CMP0052-docs'
692228e4 Help: Link to cmake-buildsystem from CMP0052 docs. e5e9b8e9 Help: Add code example for INSTALL_INTERFACE to cmake-buildsystem.
-rw-r--r--Help/manual/cmake-buildsystem.7.rst12
-rw-r--r--Help/policy/CMP0052.rst3
2 files changed, 14 insertions, 1 deletions
diff --git a/Help/manual/cmake-buildsystem.7.rst b/Help/manual/cmake-buildsystem.7.rst
index 501b924..3e1f011 100644
--- a/Help/manual/cmake-buildsystem.7.rst
+++ b/Help/manual/cmake-buildsystem.7.rst
@@ -580,7 +580,17 @@ 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 these
expressions, and are interpreted relative to the current source directory
-or the installation prefix, as appropriate.
+or the installation prefix, as appropriate:
+
+.. code-block:: cmake
+
+ add_library(ClimbingStats climbingstats.cpp)
+ target_include_directories(ClimbingStats INTERFACE
+ $<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}/generated>
+ $<INSTALL_INTERFACE:/absolute/path>
+ $<INSTALL_INTERFACE:relative/path>
+ $<INSTALL_INTERFACE:$<INSTALL_PREFIX>/$<CONFIG>/generated>
+ )
Two convenience APIs are provided relating to include directories usage
requirements. The :variable:`CMAKE_INCLUDE_CURRENT_DIR_IN_INTERFACE` variable
diff --git a/Help/policy/CMP0052.rst b/Help/policy/CMP0052.rst
index f857f36..48cfc9c 100644
--- a/Help/policy/CMP0052.rst
+++ b/Help/policy/CMP0052.rst
@@ -10,6 +10,9 @@ the installation prefix. This makes the installation depend on the
existence of the source dir or binary dir, and the installation will be
broken if either are removed after installation.
+See :ref:`Include Directories and Usage Requirements` for more on
+specifying include directories for targets.
+
The OLD behavior for this policy is to export the content of the
:prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` with the source or binary
directory. The NEW behavior for this