Merge topic 'extend-docs'

0b3e98d9 Help: Don't list debuggable properties in cmake-buildsystem manual.
39d08b92 Help: Add additional hyperlink targets
ef17e293 Help: Document SYSTEM treatment of IMPORTED target INTERFACE_INCLUDE_DIRS
This commit is contained in:
Brad King 2014-02-10 11:25:10 -05:00 committed by CMake Topic Stage
commit 89d49eccc5
3 changed files with 17 additions and 4 deletions

View File

@ -392,10 +392,8 @@ locality of code which creates a target and code which is responsible for
setting build specifications may make the code more difficult to reason about. setting build specifications may make the code more difficult to reason about.
:manual:`cmake(1)` provides a debugging facility to print the origin of the :manual:`cmake(1)` provides a debugging facility to print the origin of the
contents of properties which may be determined by dependencies. The properties contents of properties which may be determined by dependencies. The properties
which can be debugged are :prop_tgt:`INCLUDE_DIRECTORIES`, which can be debugged are listed in the
:prop_tgt:`COMPILE_DEFINITIONS`, :prop_tgt:`COMPILE_OPTIONS`, :variable:`CMAKE_DEBUG_TARGET_PROPERTIES` variable documentation:
:prop_tgt:`AUTOUIC_OPTIONS`, and all properties listed in a
``COMPATIBLE_INTERFACE_*`` target property:
.. code-block:: cmake .. code-block:: cmake
@ -544,6 +542,8 @@ with either ``-DClimbingStats_FROM_BUILD_LOCATION`` or
``-DClimbingStats_FROM_INSTALL_LOCATION``. For more about packages and ``-DClimbingStats_FROM_INSTALL_LOCATION``. For more about packages and
exporting see the :manual:`cmake-packages(7)` manual. exporting see the :manual:`cmake-packages(7)` manual.
.. _`Include Directories and Usage Requirements`:
Include Directories and Usage Requirements Include Directories and Usage Requirements
'''''''''''''''''''''''''''''''''''''''''' ''''''''''''''''''''''''''''''''''''''''''
@ -602,6 +602,14 @@ This is equivalent to appending ``${CMAKE_INSTALL_PREFIX}/include`` to the
:prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` of each of the installed :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` of each of the installed
:prop_tgt:`IMPORTED` targets when generated by :command:`install(EXPORT)`. :prop_tgt:`IMPORTED` targets when generated by :command:`install(EXPORT)`.
When the :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` of an
:ref:`imported target <Imported targets>` is consumed, the entries in the
property are treated as ``SYSTEM`` include directories, as if they were
listed in the :prop_tgt:`INTERFACE_SYSTEM_INCLUDE_DIRECTORIES` of the
dependency. This can result in omission of compiler warnings for headers
found in those directories. This behavior for :ref:`imported targets` may
be controlled with the :prop_tgt:`NO_SYSTEM_FROM_IMPORTED` target property.
If a binary target is linked transitively to a Mac OX framework, the If a binary target is linked transitively to a Mac OX framework, the
``Headers`` directory of the framework is also treated as a usage requirement. ``Headers`` directory of the framework is also treated as a usage requirement.
This has the same effect as passing the framework directory as an include This has the same effect as passing the framework directory as an include

View File

@ -81,6 +81,8 @@ following targets by setting the :variable:`CMAKE_AUTOMOC` variable. The
options to pass to ``moc``. The :variable:`CMAKE_AUTOMOC_MOC_OPTIONS` options to pass to ``moc``. The :variable:`CMAKE_AUTOMOC_MOC_OPTIONS`
variable may be populated to pre-set the options for all following targets. variable may be populated to pre-set the options for all following targets.
.. _`Qt AUTOUIC`:
AUTOUIC AUTOUIC
''''''' '''''''
@ -142,6 +144,7 @@ result of linking with the :prop_tgt:`IMPORTED` target:
Qt5::Widgets Qt5::Widgets
) )
.. _`Qt AUTORCC`:
AUTORCC AUTORCC
''''''' '''''''

View File

@ -90,6 +90,8 @@ the compiler supports that feature. The :prop_tgt:`<LANG>_VISIBILITY_PRESET`
and :prop_tgt:`VISIBILITY_INLINES_HIDDEN` target properties add flags for and :prop_tgt:`VISIBILITY_INLINES_HIDDEN` target properties add flags for
hidden visibility, if supported by the compiler. hidden visibility, if supported by the compiler.
.. _`Cross Compiling Toolchain`:
Cross Compiling Cross Compiling
=============== ===============