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.
|
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
|
||||||
|
|
|
@ -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
|
||||||
'''''''
|
'''''''
|
||||||
|
|
|
@ -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
|
||||||
===============
|
===============
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue