Merge topic 'cmake-qt-manual'

4271a4ed Help: Add information about INTERFACE_AUTOUIC_OPTIONS.
7935f4de Help: Note that AUTOMOC consumes the defines and includes from targets.
2739a6f9 Help: Move Qt tool invocation information to a generic cmake-qt manual.
This commit is contained in:
Brad King
2014-02-03 11:11:14 -05:00
committed by CMake Topic Stage
3 changed files with 186 additions and 72 deletions
+1 -72
View File
@@ -35,78 +35,7 @@
# meta-object code generation,``uic`` for widget layout and population,
# and ``rcc`` for virtual filesystem content generation. These tools may be
# automatically invoked by :manual:`cmake(1)` if the appropriate conditions
# are met.
#
# The tools are executed as part of a synthesized custom target generated by
# CMake. Target dependencies may be added to that custom target by adding them
# to the :prop_tgt:`AUTOGEN_TARGET_DEPENDS` target property.
#
# AUTOMOC
# '''''''
#
# The :prop_tgt:`AUTOMOC` target property controls whether :manual:`cmake(1)`
# inspects the C++ files in the target to determine if they require ``moc`` to
# be run, and to create rules to execute ``moc`` at the appropriate time.
#
# If a ``Q_OBJECT`` or ``Q_GADGET`` macro is found in a header file, ``moc``
# will be run on the file. The result will be put into a file named according
# to ``moc_<basename>.cpp``. If the macro is found in a C++ implementation
# file, the moc output will be put into a file named according to
# ``<basename>.moc``, following the Qt conventions. The ``moc file`` may be
# included by the user in the C++ implementation file with a preprocessor
# ``#include``. If it is not so included, it will be added to a separate file
# which is compiled into the target.
#
# Generated ``moc_*.cpp`` and ``*.moc`` files are placed in the build directory
# so it is convenient to set the :variable:`CMAKE_INCLUDE_CURRENT_DIR`
# variable. The :prop_tgt:`AUTOMOC` target property may be pre-set for all
# following targets by setting the :variable:`CMAKE_AUTOMOC` variable. The
# :prop_tgt:`AUTOMOC_MOC_OPTIONS` target property may be populated to set
# options to pass to ``moc``. The :variable:`CMAKE_AUTOMOC_MOC_OPTIONS`
# variable may be populated to pre-set the options for all following targets.
#
# AUTOUIC
# '''''''
#
# The :prop_tgt:`AUTOUIC` target property controls whether :manual:`cmake(1)`
# inspects the C++ files in the target to determine if they require ``uic`` to
# be run, and to create rules to execute ``uic`` at the appropriate time.
#
# If a preprocessor ``#include`` directive is found which matches
# ``ui_<basename>.h``, and a ``<basename>.ui`` file exists, then ``uic`` will
# be executed to generate the appropriate file.
#
# Generated ``ui_*.h`` files are placed in the build directory so it is
# convenient to set the :variable:`CMAKE_INCLUDE_CURRENT_DIR` variable. The
# :prop_tgt:`AUTOUIC` target property may be pre-set for all following targets
# by setting the :variable:`CMAKE_AUTOUIC` variable. The
# :prop_tgt:`AUTOUIC_OPTIONS` target property may be populated to set options
# to pass to ``uic``. The :variable:`CMAKE_AUTOUIC_OPTIONS` variable may be
# populated to pre-set the options for all following targets. The
# :prop_sf:`AUTOUIC_OPTIONS` source file property may be set on the
# ``<basename>.ui`` file to set particular options for the file. This
# overrides options from the :prop_tgt:`AUTOUIC_OPTIONS` target property.
#
# AUTORCC
# '''''''
#
# The :prop_tgt:`AUTORCC` target property controls whether :manual:`cmake(1)`
# creates rules to execute ``rcc`` at the appropriate time on source files
# which have the suffix ``.qrc``.
#
# .. code-block:: cmake
#
# add_executable(myexe main.cpp resource_file.qrc)
#
# The :prop_tgt:`AUTORCC` target property may be pre-set for all following targets
# by setting the :variable:`CMAKE_AUTORCC` variable. The
# :prop_tgt:`AUTORCC_OPTIONS` target property may be populated to set options
# to pass to ``rcc``. The :variable:`CMAKE_AUTORCC_OPTIONS` variable may be
# populated to pre-set the options for all following targets. The
# :prop_sf:`AUTORCC_OPTIONS` source file property may be set on the
# ``<name>.qrc`` file to set particular options for the file. This
# overrides options from the :prop_tgt:`AUTORCC_OPTIONS` target property.
#
# are met. See :manual:`cmake-qt(7)` for more.
#
# Qt Macros
# =========