Browse Source

Help: Describe definition values in target_compile_definitions

Fixes: #20573
Juan Ramos 5 years ago
parent
commit
4b9fcadc9a
1 changed files with 9 additions and 0 deletions
  1. 9 0
      Help/command/target_compile_definitions.rst

+ 9 - 0
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).