"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "Help/prop_tgt/AUTOMOC.rst" between
cmake-3.13.4.tar.gz and cmake-3.14.0-rc1.tar.gz

About: CMake is a cross-platform build system designed to build, test and package software. Release candidate.

AUTOMOC.rst  (cmake-3.13.4):AUTOMOC.rst  (cmake-3.14.0-rc1)
AUTOMOC AUTOMOC
------- -------
Should the target be processed with automoc (for Qt projects). Should the target be processed with automoc (for Qt projects).
AUTOMOC is a boolean specifying whether CMake will handle the Qt ``moc`` :prop_tgt:`AUTOMOC` is a boolean specifying whether CMake will handle the Qt
preprocessor automatically, i.e. without having to use the ``moc`` preprocessor automatically, i.e. without having to use the
:module:`QT4_WRAP_CPP() <FindQt4>` or QT5_WRAP_CPP() macro. :module:`QT4_WRAP_CPP() <FindQt4>` or QT5_WRAP_CPP() macro.
Currently Qt4 and Qt5 are supported. Currently Qt4 and Qt5 are supported.
When this property is set ``ON``, CMake will scan the header and When this property is set ``ON``, CMake will scan the header and
source files at build time and invoke moc accordingly. source files at build time and invoke moc accordingly.
* If an ``#include`` statement like ``#include "moc_<basename>.cpp"`` is found, * If an ``#include`` statement like ``#include "moc_<basename>.cpp"`` is found,
a macro from :prop_tgt:`AUTOMOC_MACRO_NAMES` is expected to appear in the a macro from :prop_tgt:`AUTOMOC_MACRO_NAMES` is expected to appear in the
``<basename>.h(xx)`` header file. ``moc`` is run on the header ``<basename>.h(xx)`` header file. ``moc`` is run on the header
file to generate ``moc_<basename>.cpp`` in the file to generate ``moc_<basename>.cpp`` in the
skipping to change at line 61 skipping to change at line 61
* ``AUTOMOC`` always checks multiple header alternative extensions, * ``AUTOMOC`` always checks multiple header alternative extensions,
such as ``hpp``, ``hxx``, etc. when searching for headers. such as ``hpp``, ``hxx``, etc. when searching for headers.
* ``AUTOMOC`` looks for the ``Q_PLUGIN_METADATA`` macro and reruns the * ``AUTOMOC`` looks for the ``Q_PLUGIN_METADATA`` macro and reruns the
``moc`` when the file addressed by the ``FILE`` argument of the macro changes. ``moc`` when the file addressed by the ``FILE`` argument of the macro changes.
This property is initialized by the value of the :variable:`CMAKE_AUTOMOC` This property is initialized by the value of the :variable:`CMAKE_AUTOMOC`
variable if it is set when a target is created. variable if it is set when a target is created.
The ``moc`` executable will be detected automatically, but can be forced to
a certain binary using the :prop_tgt:`AUTOMOC_EXECUTABLE` property.
Additional command line options for ``moc`` can be set via the Additional command line options for ``moc`` can be set via the
:prop_tgt:`AUTOMOC_MOC_OPTIONS` property. :prop_tgt:`AUTOMOC_MOC_OPTIONS` property.
By enabling the :variable:`CMAKE_AUTOMOC_RELAXED_MODE` variable the By enabling the :variable:`CMAKE_AUTOMOC_RELAXED_MODE` variable the
rules for searching the files which will be processed by ``moc`` can be relaxed. rules for searching the files which will be processed by ``moc`` can be relaxed.
See the documentation for this variable for more details. See the documentation for this variable for more details.
The global property :prop_gbl:`AUTOGEN_TARGETS_FOLDER` can be used to group the The global property :prop_gbl:`AUTOGEN_TARGETS_FOLDER` can be used to group the
automoc targets together in an IDE, e.g. in MSVS. automoc targets together in an IDE, e.g. in MSVS.
skipping to change at line 89 skipping to change at line 92
Compiler pre definitions for ``moc`` are written to a ``moc_predefs.h`` file Compiler pre definitions for ``moc`` are written to a ``moc_predefs.h`` file
which is controlled by :prop_tgt:`AUTOMOC_COMPILER_PREDEFINES`. which is controlled by :prop_tgt:`AUTOMOC_COMPILER_PREDEFINES`.
Source C++ files can be excluded from :prop_tgt:`AUTOMOC` processing by Source C++ files can be excluded from :prop_tgt:`AUTOMOC` processing by
enabling :prop_sf:`SKIP_AUTOMOC` or the broader :prop_sf:`SKIP_AUTOGEN`. enabling :prop_sf:`SKIP_AUTOMOC` or the broader :prop_sf:`SKIP_AUTOGEN`.
The number of parallel ``moc`` processes to start can be modified by The number of parallel ``moc`` processes to start can be modified by
setting :prop_tgt:`AUTOGEN_PARALLEL`. setting :prop_tgt:`AUTOGEN_PARALLEL`.
A global ``autogen`` target that depends on all :prop_tgt:`AUTOMOC` generated
``<ORIGIN>_autogen`` targets in the project can be generated by enabling
:variable:`CMAKE_GLOBAL_AUTOGEN_TARGET`.
See the :manual:`cmake-qt(7)` manual for more information on using CMake See the :manual:`cmake-qt(7)` manual for more information on using CMake
with Qt. with Qt.
 End of changes. 3 change blocks. 
2 lines changed or deleted 9 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)