summaryrefslogtreecommitdiffstats
path: root/Help/prop_tgt/PCH_INSTANTIATE_TEMPLATES.rst
diff options
context:
space:
mode:
authorTobias Hieta <tobias@plex.tv>2020-08-28 07:16:04 (GMT)
committerTobias Hieta <tobias@plex.tv>2020-09-02 06:30:55 (GMT)
commit8c8f03422e3197a3414a8ed1413fcb9576df0f4b (patch)
tree526e5b6341f3f63dd848623be82448fab17f5285 /Help/prop_tgt/PCH_INSTANTIATE_TEMPLATES.rst
parent8c833ff0e17e63d9cbf17622abcb70a5fab240b8 (diff)
downloadCMake-8c8f03422e3197a3414a8ed1413fcb9576df0f4b.zip
CMake-8c8f03422e3197a3414a8ed1413fcb9576df0f4b.tar.gz
CMake-8c8f03422e3197a3414a8ed1413fcb9576df0f4b.tar.bz2
PCH: Template instantiation support
Adds PCH_INSTANTIATE_TEMPLATES target property for enabling template instantiation in precompiled headers. Enabled by default. Currently only supported for Clang 11 and newer. Implements #21133.
Diffstat (limited to 'Help/prop_tgt/PCH_INSTANTIATE_TEMPLATES.rst')
-rw-r--r--Help/prop_tgt/PCH_INSTANTIATE_TEMPLATES.rst13
1 files changed, 13 insertions, 0 deletions
diff --git a/Help/prop_tgt/PCH_INSTANTIATE_TEMPLATES.rst b/Help/prop_tgt/PCH_INSTANTIATE_TEMPLATES.rst
new file mode 100644
index 0000000..7c1af2a
--- /dev/null
+++ b/Help/prop_tgt/PCH_INSTANTIATE_TEMPLATES.rst
@@ -0,0 +1,13 @@
+PCH_INSTANTIATE_TEMPLATES
+-------------------------
+
+.. versionadded:: 3.19
+
+When this property is set to true, the precompiled header compiler options
+will contain a flag to instantiate templates during the generation of the PCH
+if supported. This can significantly improve compile times. Supported in Clang
+since version 11.
+
+This property is initialized by the value of the
+:variable:`CMAKE_PCH_INSTANTIATE_TEMPLATES` variable if it is set when a target
+is created. If that variable is not set, the property defaults to ``ON``.