summaryrefslogtreecommitdiffstats
path: root/Help/manual/cmake-qt.7.rst
diff options
context:
space:
mode:
authorSebastian Holtermann <sebholt@xwmw.org>2017-09-06 14:10:47 (GMT)
committerSebastian Holtermann <sebholt@xwmw.org>2017-09-07 16:03:14 (GMT)
commit6739a12571bfa8b97b00740981e9f6eb5195529f (patch)
tree1ab49e6bb8d5863f93c4504b2ad53ddf1556d90e /Help/manual/cmake-qt.7.rst
parent2be0acb71e25cd425de71b047a0c77087e51c607 (diff)
downloadCMake-6739a12571bfa8b97b00740981e9f6eb5195529f.zip
CMake-6739a12571bfa8b97b00740981e9f6eb5195529f.tar.gz
CMake-6739a12571bfa8b97b00740981e9f6eb5195529f.tar.bz2
Autogen: Doc: Add Visual Studio PRE_BUILD note to cmake-qt.rst
Diffstat (limited to 'Help/manual/cmake-qt.7.rst')
-rw-r--r--Help/manual/cmake-qt.7.rst18
1 files changed, 18 insertions, 0 deletions
diff --git a/Help/manual/cmake-qt.7.rst b/Help/manual/cmake-qt.7.rst
index 55121df..7052e0a 100644
--- a/Help/manual/cmake-qt.7.rst
+++ b/Help/manual/cmake-qt.7.rst
@@ -214,6 +214,24 @@ overrides options from the :prop_tgt:`AUTORCC_OPTIONS` target property.
Source files can be excluded from :prop_tgt:`AUTORCC` processing by
enabling :prop_sf:`SKIP_AUTORCC` or the broader :prop_sf:`SKIP_AUTOGEN`.
+Visual Studio Generators
+========================
+
+When using the :manual:`Visual Studio generators <cmake-generators(7)>`
+CMake tries to use a ``PRE_BUILD``
+:command:`custom command <add_custom_command>` instead
+of a :command:`custom target <add_custom_target>` for autogen.
+``PRE_BUILD`` can't be used when the autogen target depends on files.
+This happens when
+
+- :prop_tgt:`AUTOMOC` or :prop_tgt:`AUTOUIC` is enabled and the origin target
+ depends on :prop_sf:`GENERATED` files which aren't excluded from autogen by
+ :prop_sf:`SKIP_AUTOMOC`, :prop_sf:`SKIP_AUTOUIC`, :prop_sf:`SKIP_AUTOGEN`
+ or :policy:`CMP0071`
+- :prop_tgt:`AUTORCC` is enabled and a ``.qrc`` file is listed in
+ the origin target sources
+- :prop_tgt:`AUTOGEN_TARGET_DEPENDS` lists a source file
+
qtmain.lib on Windows
=====================