summaryrefslogtreecommitdiffstats
path: root/Help/command
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2019-10-16 14:32:56 (GMT)
committerBrad King <brad.king@kitware.com>2019-10-16 14:32:56 (GMT)
commitac75886525c647ef7081dc11f6c0c128463b7ecd (patch)
treed34cfd6a5d869bc0674bd2252a165ccb610a8702 /Help/command
parent9150c818b7d2afb868575fcb2e0c9ba62b9d7f85 (diff)
downloadCMake-ac75886525c647ef7081dc11f6c0c128463b7ecd.zip
CMake-ac75886525c647ef7081dc11f6c0c128463b7ecd.tar.gz
CMake-ac75886525c647ef7081dc11f6c0c128463b7ecd.tar.bz2
PCH: Document and test COMPILE_LANGUAGE genex for per-language header
Fixes: #19839
Diffstat (limited to 'Help/command')
-rw-r--r--Help/command/target_precompile_headers.rst4
1 files changed, 4 insertions, 0 deletions
diff --git a/Help/command/target_precompile_headers.rst b/Help/command/target_precompile_headers.rst
index 3a32f41..d283948 100644
--- a/Help/command/target_precompile_headers.rst
+++ b/Help/command/target_precompile_headers.rst
@@ -47,6 +47,9 @@ with the syntax ``$<...>``.
See the :manual:`cmake-generator-expressions(7)` manual for available
expressions. See the :manual:`cmake-compile-features(7)` manual for
information on compile features and a list of supported compilers.
+The ``$<COMPILE_LANGUAGE:...>`` generator expression is particularly
+useful for specifying a language-specific header to precompile for
+only one language (e.g. ``CXX`` and not ``C``).
Usage
^^^^^
@@ -56,6 +59,7 @@ Usage
target_precompile_headers(<target>
PUBLIC
project_header.h
+ "$<$<COMPILE_LANGUAGE:CXX>:cxx_only.h>"
PRIVATE
[["other_header.h"]]
<unordered_map>