Merge topic 'extend-docs'
0b3e98d9
Help: Don't list debuggable properties in cmake-buildsystem manual.39d08b92
Help: Add additional hyperlink targetsef17e293
Help: Document SYSTEM treatment of IMPORTED target INTERFACE_INCLUDE_DIRS
This commit is contained in:
commit
89d49eccc5
|
@ -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.
|
||||
:manual:`cmake(1)` provides a debugging facility to print the origin of the
|
||||
contents of properties which may be determined by dependencies. The properties
|
||||
which can be debugged are :prop_tgt:`INCLUDE_DIRECTORIES`,
|
||||
:prop_tgt:`COMPILE_DEFINITIONS`, :prop_tgt:`COMPILE_OPTIONS`,
|
||||
:prop_tgt:`AUTOUIC_OPTIONS`, and all properties listed in a
|
||||
``COMPATIBLE_INTERFACE_*`` target property:
|
||||
which can be debugged are listed in the
|
||||
:variable:`CMAKE_DEBUG_TARGET_PROPERTIES` variable documentation:
|
||||
|
||||
.. code-block:: cmake
|
||||
|
||||
|
@ -544,6 +542,8 @@ with either ``-DClimbingStats_FROM_BUILD_LOCATION`` or
|
|||
``-DClimbingStats_FROM_INSTALL_LOCATION``. For more about packages and
|
||||
exporting see the :manual:`cmake-packages(7)` manual.
|
||||
|
||||
.. _`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:`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
|
||||
``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
|
||||
|
|
|
@ -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`
|
||||
variable may be populated to pre-set the options for all following targets.
|
||||
|
||||
.. _`Qt AUTOUIC`:
|
||||
|
||||
AUTOUIC
|
||||
'''''''
|
||||
|
||||
|
@ -142,6 +144,7 @@ result of linking with the :prop_tgt:`IMPORTED` target:
|
|||
Qt5::Widgets
|
||||
)
|
||||
|
||||
.. _`Qt AUTORCC`:
|
||||
|
||||
AUTORCC
|
||||
'''''''
|
||||
|
|
|
@ -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
|
||||
hidden visibility, if supported by the compiler.
|
||||
|
||||
.. _`Cross Compiling Toolchain`:
|
||||
|
||||
Cross Compiling
|
||||
===============
|
||||
|
||||
|
|
Loading…
Reference in New Issue