diff options
| author | Brad King <brad.king@kitware.com> | 2018-02-21 15:33:12 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2018-02-21 15:33:12 (GMT) |
| commit | d513a4035b088311eede69cd54040b42eb6c70cd (patch) | |
| tree | 1f725b8571d576e41f542f5082acb422ba4cb7f9 /Help/prop_tgt/AUTOGEN_TARGET_DEPENDS.rst | |
| parent | 82c23d6afcc862f3000607ab1521e72ca743a3b0 (diff) | |
| parent | bfffe42b98b85790c93315eecaf62637a246b040 (diff) | |
| download | CMake-d513a4035b088311eede69cd54040b42eb6c70cd.zip CMake-d513a4035b088311eede69cd54040b42eb6c70cd.tar.gz CMake-d513a4035b088311eede69cd54040b42eb6c70cd.tar.bz2 | |
Merge branch 'autogen-depend-filters-documentation' into release-3.11
Merge-request: !1782
Diffstat (limited to 'Help/prop_tgt/AUTOGEN_TARGET_DEPENDS.rst')
| -rw-r--r-- | Help/prop_tgt/AUTOGEN_TARGET_DEPENDS.rst | 30 |
1 files changed, 22 insertions, 8 deletions
diff --git a/Help/prop_tgt/AUTOGEN_TARGET_DEPENDS.rst b/Help/prop_tgt/AUTOGEN_TARGET_DEPENDS.rst index f522c6b..7d3dfd1 100644 --- a/Help/prop_tgt/AUTOGEN_TARGET_DEPENDS.rst +++ b/Help/prop_tgt/AUTOGEN_TARGET_DEPENDS.rst @@ -3,15 +3,29 @@ AUTOGEN_TARGET_DEPENDS Target dependencies of the corresponding ``_autogen`` target. -Targets which have their :prop_tgt:`AUTOMOC` target ``ON`` have a -corresponding ``_autogen`` target which is used to autogenerate generate moc -files. As this ``_autogen`` target is created at generate-time, it is not -possible to define dependencies of it, such as to create inputs for the ``moc`` -executable. +Targets which have their :prop_tgt:`AUTOMOC` or :prop_tgt:`AUTOUIC` property +``ON`` have a corresponding ``_autogen`` target which is used to auto generate +``moc`` and ``uic`` files. As this ``_autogen`` target is created at +generate-time, it is not possible to define dependencies of it, +such as to create inputs for the ``moc`` or ``uic`` executable. -The ``AUTOGEN_TARGET_DEPENDS`` target property can be set instead to a list of -dependencies for the ``_autogen`` target. The buildsystem will be generated to -depend on its contents. +The :prop_tgt:`AUTOGEN_TARGET_DEPENDS` target property can be set instead to a +list of dependencies of the ``_autogen`` target. Dependencies can be target +names or file names. See the :manual:`cmake-qt(7)` manual for more information on using CMake with Qt. + +Use cases +^^^^^^^^^ + +If :prop_tgt:`AUTOMOC` or :prop_tgt:`AUTOUIC` depends on a file that is either + +- a :prop_sf:`GENERATED` non C++ file (e.g. a :prop_sf:`GENERATED` ``.json`` + or ``.ui`` file) or +- a :prop_sf:`GENERATED` C++ file that isn't recognized by :prop_tgt:`AUTOMOC` + and :prop_tgt:`AUTOUIC` because it's skipped by :prop_sf:`SKIP_AUTOMOC`, + :prop_sf:`SKIP_AUTOUIC`, :prop_sf:`SKIP_AUTOGEN` or :policy:`CMP0071` or +- a file that isn't in the target's sources + +it must added to :prop_tgt:`AUTOGEN_TARGET_DEPENDS`. |