summaryrefslogtreecommitdiffstats
path: root/Help/prop_tgt/AUTOMOC_COMPILER_PREDEFINES.rst
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2017-10-02 12:01:02 (GMT)
committerKitware Robot <kwrobot@kitware.com>2017-10-02 12:01:21 (GMT)
commit275b4a53eef8d10af069fbcb0d1d9bc4d0b5f6d5 (patch)
tree1863a4e43cd68b578996eade2522c55c0d90e0e9 /Help/prop_tgt/AUTOMOC_COMPILER_PREDEFINES.rst
parent9288c291cb56f75ad0ed8a86b0882d1998c8b79d (diff)
parent6bbc1e775d46cbe1ad97ecea0862d030680b332a (diff)
downloadCMake-275b4a53eef8d10af069fbcb0d1d9bc4d0b5f6d5.zip
CMake-275b4a53eef8d10af069fbcb0d1d9bc4d0b5f6d5.tar.gz
CMake-275b4a53eef8d10af069fbcb0d1d9bc4d0b5f6d5.tar.bz2
Merge topic 'autogen-predefs'
6bbc1e77 Autogen: Add release notes for (CMAKE_)AUTOMOC_COMPILER_PREDEFINES 75c98b5e Autogen: Doc: Add documentation for (CMAKE_)AUTOMOC_COMPILER_PREDEFINES 1d7f099d Autogen: Add (CMAKE_)AUTOMOC_COMPILER_PREDEFINES Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1328
Diffstat (limited to 'Help/prop_tgt/AUTOMOC_COMPILER_PREDEFINES.rst')
-rw-r--r--Help/prop_tgt/AUTOMOC_COMPILER_PREDEFINES.rst24
1 files changed, 24 insertions, 0 deletions
diff --git a/Help/prop_tgt/AUTOMOC_COMPILER_PREDEFINES.rst b/Help/prop_tgt/AUTOMOC_COMPILER_PREDEFINES.rst
new file mode 100644
index 0000000..57a647f
--- /dev/null
+++ b/Help/prop_tgt/AUTOMOC_COMPILER_PREDEFINES.rst
@@ -0,0 +1,24 @@
+AUTOMOC_COMPILER_PREDEFINES
+---------------------------
+
+Boolean value used by :prop_tgt:`AUTOMOC` to determine if the
+compiler pre definitions file ``moc_predefs.h`` should be generated.
+
+CMake generates a ``moc_predefs.h`` file with compiler pre definitions
+from the output of the command defined in
+:variable:`CMAKE_CXX_COMPILER_PREDEFINES_COMMAND <CMAKE_<LANG>_COMPILER_PREDEFINES_COMMAND>`
+when
+
+- :prop_tgt:`AUTOMOC` is enabled,
+- :prop_tgt:`AUTOMOC_COMPILER_PREDEFINES` is enabled,
+- :variable:`CMAKE_CXX_COMPILER_PREDEFINES_COMMAND <CMAKE_<LANG>_COMPILER_PREDEFINES_COMMAND>` isn't empty and
+- the Qt version is greater or equal 5.8.
+
+The ``moc_predefs.h`` file, which is generated in :prop_tgt:`AUTOGEN_BUILD_DIR`,
+is passed to ``moc`` as the argument to the ``--include`` option.
+
+By default :prop_tgt:`AUTOMOC_COMPILER_PREDEFINES` is initialized from
+:variable:`CMAKE_AUTOMOC_COMPILER_PREDEFINES`, which is ON by default.
+
+See the :manual:`cmake-qt(7)` manual for more information on using CMake
+with Qt.