summaryrefslogtreecommitdiffstats
path: root/Help/command/qt_wrap_ui.rst
diff options
context:
space:
mode:
authorTobias Hunger <tobias.hunger@gmail.com>2018-12-13 15:21:43 (GMT)
committerCraig Scott <craig.scott@crascit.com>2019-01-15 21:08:38 (GMT)
commit74dc68b4063193850c2d081139ca72355a39f5c5 (patch)
tree2c3aec1f8436c2ce21e6381d8b5eaf613e087fb3 /Help/command/qt_wrap_ui.rst
parent50454c96d691871dce0a7f3176ceccdc09419b32 (diff)
downloadCMake-74dc68b4063193850c2d081139ca72355a39f5c5.zip
CMake-74dc68b4063193850c2d081139ca72355a39f5c5.tar.gz
CMake-74dc68b4063193850c2d081139ca72355a39f5c5.tar.bz2
qt_wrap_*: Add deprecation notes to command docs
Co-authored-by: Craig Scott <craig.scott@crascit.com>
Diffstat (limited to 'Help/command/qt_wrap_ui.rst')
-rw-r--r--Help/command/qt_wrap_ui.rst14
1 files changed, 13 insertions, 1 deletions
diff --git a/Help/command/qt_wrap_ui.rst b/Help/command/qt_wrap_ui.rst
index 9a8863d..efbbc54 100644
--- a/Help/command/qt_wrap_ui.rst
+++ b/Help/command/qt_wrap_ui.rst
@@ -1,7 +1,16 @@
qt_wrap_ui
----------
-Create Qt user interfaces Wrappers.
+.. deprecated:: 3.14
+
+ This command was originally added to support Qt 3 before the
+ :command:`add_custom_command()` command was sufficiently mature. The
+ :module:`FindQt4` module provides the ``qt4_wrap_ui()`` macro, which
+ should be used instead for Qt 4 projects. For projects using Qt 5 or
+ later, use the equivalent macro provided by Qt itself (e.g. Qt 5 provides
+ ``qt5_wrap_ui()``).
+
+Manually create Qt user interfaces Wrappers.
.. code-block:: cmake
@@ -12,3 +21,6 @@ Produces .h and .cxx files for all the .ui files listed in the
``SourceLists``. The .h files will be added to the library using the
``HeadersDestNamesource`` list. The .cxx files will be added to the
library using the ``SourcesDestNamesource`` list.
+
+Consider updating the project to use the :prop_tgt:`AUTOUIC` target property
+instead for a more automated way of invoking the ``uic`` tool.