浏览代码

Merge topic 'doc-project-include-vars-3.29' into release-3.29

dcb894fb00 Help: Update project() code injection for new 3.29 include behavior
09cf39ab07 Help: Improve wording of CMAKE_PROJECT_..._INCLUDE... changes for 3.29

Acked-by: Kitware Robot <[email protected]>
Merge-request: !9343
Brad King 1 年之前
父节点
当前提交
8a40da1b71

+ 6 - 6
Help/command/project.rst

@@ -123,12 +123,12 @@ The following outlines the steps performed during a ``project()`` call:
 
 * .. versionadded:: 3.15
     For every ``project()`` call regardless of the project
-    name, include the file named by :variable:`CMAKE_PROJECT_INCLUDE_BEFORE`,
-    if set.
+    name, include the file(s) and module(s) named by
+    :variable:`CMAKE_PROJECT_INCLUDE_BEFORE`, if set.
 
 * .. versionadded:: 3.17
     If the ``project()`` command specifies ``<PROJECT-NAME>`` as its project
-    name, include the file named by
+    name, include the file(s) and module(s) named by
     :variable:`CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE_BEFORE`, if set.
 
 * Set the various project-specific variables detailed in the `Synopsis`_
@@ -156,11 +156,11 @@ The following outlines the steps performed during a ``project()`` call:
 
 * .. versionadded:: 3.15
     For every ``project()`` call regardless of the project
-    name, include the file named by :variable:`CMAKE_PROJECT_INCLUDE`,
-    if set.
+    name, include the file(s) and module(s) named by
+    :variable:`CMAKE_PROJECT_INCLUDE`, if set.
 
 * If the ``project()`` command specifies ``<PROJECT-NAME>`` as its project
-  name, include the file named by
+  name, include the file(s) and module(s) named by
   :variable:`CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE`, if set.
 
 Usage

+ 2 - 1
Help/variable/CMAKE_PROJECT_INCLUDE.rst

@@ -12,7 +12,8 @@ for a more detailed discussion of files potentially included during a
 .. versionadded:: 3.29
   This variable can be a :ref:`semicolon-separated list <CMake Language Lists>`
   of CMake language files to be included sequentially. It can also now refer to
-  module names to be found in :variable:`CMAKE_MODULE_PATH` or builtin to CMake.
+  module names to be found in :variable:`CMAKE_MODULE_PATH` or as a builtin
+  CMake module.
 
 See also the :variable:`CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE`,
 :variable:`CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE_BEFORE`,

+ 2 - 1
Help/variable/CMAKE_PROJECT_INCLUDE_BEFORE.rst

@@ -12,7 +12,8 @@ for a more detailed discussion of files potentially included during a
 .. versionadded:: 3.29
   This variable can be a :ref:`semicolon-separated list <CMake Language Lists>`
   of CMake language files to be included sequentially. It can also now refer to
-  module names to be found in :variable:`CMAKE_MODULE_PATH` or builtin to CMake.
+  module names to be found in :variable:`CMAKE_MODULE_PATH` or as a builtin
+  CMake module.
 
 See also the :variable:`CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE`,
 :variable:`CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE_BEFORE`,

+ 2 - 1
Help/variable/CMAKE_PROJECT_PROJECT-NAME_INCLUDE.rst

@@ -10,7 +10,8 @@ discussion of files potentially included during a :command:`project` call.
 .. versionadded:: 3.29
   This variable can be a :ref:`semicolon-separated list <CMake Language Lists>`
   of CMake language files to be included sequentially. It can also now refer to
-  module names to be found in :variable:`CMAKE_MODULE_PATH` or builtin to CMake.
+  module names to be found in :variable:`CMAKE_MODULE_PATH` or as a builtin
+  CMake module.
 
 See also the :variable:`CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE_BEFORE`,
 :variable:`CMAKE_PROJECT_INCLUDE`, :variable:`CMAKE_PROJECT_INCLUDE_BEFORE`,

+ 2 - 1
Help/variable/CMAKE_PROJECT_PROJECT-NAME_INCLUDE_BEFORE.rst

@@ -12,7 +12,8 @@ discussion of files potentially included during a :command:`project` call.
 .. versionadded:: 3.29
   This variable can be a :ref:`semicolon-separated list <CMake Language Lists>`
   of CMake language files to be included sequentially. It can also now refer to
-  module names to be found in :variable:`CMAKE_MODULE_PATH` or builtin to CMake.
+  module names to be found in :variable:`CMAKE_MODULE_PATH` or as a builtin
+  CMake module.
 
 See also the :variable:`CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE`,
 :variable:`CMAKE_PROJECT_INCLUDE`, :variable:`CMAKE_PROJECT_INCLUDE_BEFORE`,