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

3 files changed, 17 insertions, 4 deletions

diff --git a/Help/manual/cmake-buildsystem.7.rst b/Help/manual/cmake-buildsystem.7.rst
index 91a9b2f..03eb163 100644
--- a/Help/manual/cmake-buildsystem.7.rst
+++ b/Help/manual/cmake-buildsystem.7.rst
@@ -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
diff --git a/Help/manual/cmake-qt.7.rst b/Help/manual/cmake-qt.7.rst
index eff73b3..e4c3246 100644
--- a/Help/manual/cmake-qt.7.rst
+++ b/Help/manual/cmake-qt.7.rst
@@ -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
 '''''''
diff --git a/Help/manual/cmake-toolchains.7.rst b/Help/manual/cmake-toolchains.7.rst
index fb529ad..f36a43c 100644
--- a/Help/manual/cmake-toolchains.7.rst
+++ b/Help/manual/cmake-toolchains.7.rst
@@ -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
 ===============