浏览代码

Help: clarify add_definitions() and add_compile_definitions() behavior

Fixes: #20736
Marc Chevrier 5 年之前
父节点
当前提交
b3e4fb5144
共有 2 个文件被更改,包括 9 次插入7 次删除
  1. 6 4
      Help/command/add_compile_definitions.rst
  2. 3 3
      Help/command/add_definitions.rst

+ 6 - 4
Help/command/add_compile_definitions.rst

@@ -7,10 +7,12 @@ Add preprocessor definitions to the compilation of source files.
 
 
   add_compile_definitions(<definition> ...)
   add_compile_definitions(<definition> ...)
 
 
-Adds preprocessor definitions to the compiler command line for targets in the
-current directory and below (whether added before or after this command is
-invoked). See documentation of the :prop_dir:`directory <COMPILE_DEFINITIONS>`
-and :prop_tgt:`target <COMPILE_DEFINITIONS>` ``COMPILE_DEFINITIONS`` properties.
+Adds preprocessor definitions to the compiler command line.
+
+The preprocessor definitions are added to the :prop_dir:`COMPILE_DEFINITIONS`
+directory property for the current ``CMakeLists`` file. They are also added to
+the :prop_tgt:`COMPILE_DEFINITIONS` target property for each target in the
+current ``CMakeLists`` file.
 
 
 Definitions are specified using the syntax ``VAR`` or ``VAR=value``.
 Definitions are specified using the syntax ``VAR`` or ``VAR=value``.
 Function-style definitions are not supported. CMake will automatically
 Function-style definitions are not supported. CMake will automatically

+ 3 - 3
Help/command/add_definitions.rst

@@ -8,9 +8,9 @@ Add -D define flags to the compilation of source files.
   add_definitions(-DFOO -DBAR ...)
   add_definitions(-DFOO -DBAR ...)
 
 
 Adds definitions to the compiler command line for targets in the current
 Adds definitions to the compiler command line for targets in the current
-directory and below (whether added before or after this command is invoked).
-This command can be used to add any flags, but it is intended to add
-preprocessor definitions.
+directory, whether added before or after this command is invoked, and for
+the ones in sub-directories added after. This command can be used to add any
+flags, but it is intended to add preprocessor definitions.
 
 
 .. note::
 .. note::