mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-06 05:40:54 -06:00
6592d66030
The references to the <ORIGIN>_autogen and <ORIGIN>_autogen_timestamp_deps anchors were being replaced by the section heading text that immediately followed the anchors. But in most cases, the text where the cross-referencing was placed was expecting the anchor text to be used instead. Add custom text for such cross-references so that the text reads as originally intended.
30 lines
1.1 KiB
ReStructuredText
30 lines
1.1 KiB
ReStructuredText
CMAKE_GLOBAL_AUTOGEN_TARGET
|
|
---------------------------
|
|
|
|
.. versionadded:: 3.14
|
|
|
|
Switch to enable generation of a global ``autogen`` target.
|
|
|
|
When ``CMAKE_GLOBAL_AUTOGEN_TARGET`` is enabled, a custom target
|
|
``autogen`` is generated. This target depends on all :prop_tgt:`AUTOMOC` and
|
|
:prop_tgt:`AUTOUIC` generated :ref:`<ORIGIN>_autogen <<ORIGIN>_autogen>`
|
|
targets in the project. By building the global ``autogen`` target, all
|
|
:prop_tgt:`AUTOMOC` and :prop_tgt:`AUTOUIC` files in the project will be
|
|
generated.
|
|
|
|
The name of the global ``autogen`` target can be changed by setting
|
|
:variable:`CMAKE_GLOBAL_AUTOGEN_TARGET_NAME`.
|
|
|
|
By default ``CMAKE_GLOBAL_AUTOGEN_TARGET`` is unset.
|
|
|
|
See the :manual:`cmake-qt(7)` manual for more information on using CMake
|
|
with Qt.
|
|
|
|
.. note::
|
|
|
|
:ref:`<ORIGIN>_autogen <<ORIGIN>_autogen>` targets by default inherit their
|
|
origin target's dependencies. This might result in unintended dependency
|
|
target builds when only :ref:`<ORIGIN>_autogen <<ORIGIN>_autogen>` targets
|
|
are built. A solution is to disable :prop_tgt:`AUTOGEN_ORIGIN_DEPENDS` on
|
|
the respective origin targets.
|