summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorJuan Ramos <juanr0911@gmail.com>2020-11-28 18:42:46 (GMT)
committerBrad King <brad.king@kitware.com>2020-11-30 18:22:37 (GMT)
commit4b9fcadc9a923ce626ea57a6becf87d218418c8b (patch)
tree6473329ea42a766e413b5536555436f2946a2808 /Help
parentbcf19af5c71c7618aaf8fa6982e52c5e86d31eb1 (diff)
downloadCMake-4b9fcadc9a923ce626ea57a6becf87d218418c8b.zip
CMake-4b9fcadc9a923ce626ea57a6becf87d218418c8b.tar.gz
CMake-4b9fcadc9a923ce626ea57a6becf87d218418c8b.tar.bz2
Help: Describe definition values in target_compile_definitions
Fixes: #20573
Diffstat (limited to 'Help')
-rw-r--r--Help/command/target_compile_definitions.rst9
1 files changed, 9 insertions, 0 deletions
diff --git a/Help/command/target_compile_definitions.rst b/Help/command/target_compile_definitions.rst
index 09e2ded..3fb113a 100644
--- a/Help/command/target_compile_definitions.rst
+++ b/Help/command/target_compile_definitions.rst
@@ -39,3 +39,12 @@ For example, the following are all equivalent:
target_compile_definitions(foo PUBLIC -DFOO) # -D removed
target_compile_definitions(foo PUBLIC "" FOO) # "" ignored
target_compile_definitions(foo PUBLIC -D FOO) # -D becomes "", then ignored
+
+Definitions may optionally have values:
+
+.. code-block:: cmake
+
+ target_compile_definitions(foo PUBLIC FOO=1)
+
+Note that many compilers treat ``-DFOO`` as equivalent to ``-DFOO=1``, but
+other tools may not recognize this in all circumstances (e.g. IntelliSense).