From 3af1daa186f01f1538cf9a7541e9269ac0c6e95a Mon Sep 17 00:00:00 2001 From: Ruslan Baratov Date: Tue, 20 Mar 2018 17:13:41 +0300 Subject: Help: Document target_compile_definitions handling of -D Add an example of using the `target_compile_definitions` command and a note about usage of ``-D`` in items. --- Help/command/target_compile_definitions.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Help/command/target_compile_definitions.rst b/Help/command/target_compile_definitions.rst index 3709e7a..a740117 100644 --- a/Help/command/target_compile_definitions.rst +++ b/Help/command/target_compile_definitions.rst @@ -27,3 +27,13 @@ Arguments to ``target_compile_definitions`` may use "generator expressions" with the syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)` manual for available expressions. See the :manual:`cmake-buildsystem(7)` manual for more on defining buildsystem properties. + +Any leading ``-D`` on an item will be removed. Empty items are ignored. +For example, the following are all equivalent: + +.. code-block:: cmake + + target_compile_definitions(foo PUBLIC FOO) + 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 -- cgit v0.12