summaryrefslogtreecommitdiffstats
path: root/Help/prop_tgt/AUTOGEN_PARALLEL.rst
diff options
context:
space:
mode:
authorSebastian Holtermann <sebholt@xwmw.org>2018-01-10 11:57:43 (GMT)
committerSebastian Holtermann <sebholt@xwmw.org>2018-01-17 16:23:49 (GMT)
commit45ee4979fb7c92502f6015ca3d93128f7c921b51 (patch)
tree77d06ad18684ddf253e92a531953c6dd7f4c8365 /Help/prop_tgt/AUTOGEN_PARALLEL.rst
parent6f4b661383fccc5f2f5a936499ba11cf2000b535 (diff)
downloadCMake-45ee4979fb7c92502f6015ca3d93128f7c921b51.zip
CMake-45ee4979fb7c92502f6015ca3d93128f7c921b51.tar.gz
CMake-45ee4979fb7c92502f6015ca3d93128f7c921b51.tar.bz2
Autogen: Add documentation for (CMAKE_)AUTOGEN_PARALLEL
Diffstat (limited to 'Help/prop_tgt/AUTOGEN_PARALLEL.rst')
-rw-r--r--Help/prop_tgt/AUTOGEN_PARALLEL.rst21
1 files changed, 21 insertions, 0 deletions
diff --git a/Help/prop_tgt/AUTOGEN_PARALLEL.rst b/Help/prop_tgt/AUTOGEN_PARALLEL.rst
new file mode 100644
index 0000000..07fbc5a
--- /dev/null
+++ b/Help/prop_tgt/AUTOGEN_PARALLEL.rst
@@ -0,0 +1,21 @@
+AUTOGEN_PARALLEL
+----------------
+
+Number of parallel ``moc`` or ``uic`` processes to start when using
+:prop_tgt:`AUTOMOC` and :prop_tgt:`AUTOUIC`.
+
+The custom `<origin>_autogen` target starts a number of threads of which
+each one parses a source file and on demand starts a ``moc`` or ``uic``
+process. :prop_tgt:`AUTOGEN_PARALLEL` controls how many parallel threads
+(and therefore ``moc`` or ``uic`` processes) are started.
+
+- An empty (or unset) value or the string ``AUTO`` sets the number of
+ threads/processes to the number of physical CPUs on the host system.
+- A positive non zero integer value sets the exact thread/process count.
+- Otherwise a single thread/process is started.
+
+By default :prop_tgt:`AUTOGEN_PARALLEL` is initialized from
+:variable:`CMAKE_AUTOGEN_PARALLEL`.
+
+See the :manual:`cmake-qt(7)` manual for more information on using CMake
+with Qt.