From 8df169ebe1490abcb3eabe45dc5677e9d5a2bff5 Mon Sep 17 00:00:00 2001
From: "FeRD (Frank Dana)" <ferdnyc@gmail.com>
Date: Tue, 21 Jul 2026 12:40:38 -0400
Subject: [PATCH] Help: target_sources: Align descriptions with signatures

Recent changes to the `target_sources()` docs changed the `<items>`
placeholders to `<source>` or `<files>` (for `FILE_SET` commands),
but the documentation still used "items" frequently, and even
`<items>` once.

Change all mentions of "items" to use terms that match the
corresponding placeholders, for consistency.
---
 Help/command/target_sources.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/Help/command/target_sources.rst b/Help/command/target_sources.rst
index b3c55390dd..e31fdb77a8 100644
--- a/Help/command/target_sources.rst
+++ b/Help/command/target_sources.rst
@@ -15,7 +15,7 @@ Specifies sources to use when building a target and/or its dependents.
 The named ``<target>`` must have been created by a command such as
 :command:`add_executable` or :command:`add_library` or
 :command:`add_custom_target` and must not be an
-:ref:`ALIAS target <Alias Targets>`.  The ``<items>`` may use
+:ref:`ALIAS target <Alias Targets>`.  The ``<source>`` items may use
 :manual:`generator expressions <cmake-generator-expressions(7)>`.
 
 .. versionadded:: 3.20
@@ -23,20 +23,20 @@ The named ``<target>`` must have been created by a command such as
 
 The ``INTERFACE``, ``PUBLIC`` and ``PRIVATE`` keywords are required to
 specify the :ref:`scope <Target Command Scope>` of the source file paths
-(``<items>``) that follow them.  ``PRIVATE`` and ``PUBLIC`` items will
+(``<source>...``) that follow them.  ``PRIVATE`` and ``PUBLIC`` sources will
 populate the :prop_tgt:`SOURCES` property of ``<target>``, which are used when
-building the target itself. ``PUBLIC`` and ``INTERFACE`` items will populate the
-:prop_tgt:`INTERFACE_SOURCES` property of ``<target>``, which are used
+building the target itself. ``PUBLIC`` and ``INTERFACE`` sources will populate
+the :prop_tgt:`INTERFACE_SOURCES` property of ``<target>``, which are used
 when building dependents.  A target created by :command:`add_custom_target`
 can only have ``PRIVATE`` scope.
 
-Repeated calls for the same ``<target>`` append items in the order called.
+Repeated calls for the same ``<target>`` append sources in the order called.
 
 .. versionadded:: 3.3
   Allow exporting targets with :prop_tgt:`INTERFACE_SOURCES`.
 
 .. versionadded:: 3.11
-  Allow setting ``INTERFACE`` items on
+  Allow setting ``INTERFACE`` sources on
   :ref:`IMPORTED targets <Imported Targets>`.
 
 .. versionchanged:: 3.13
@@ -93,9 +93,9 @@ files within those directories.
   .. versionadded:: 4.4
 
   Specifies sources to use when building a target and/or its dependents.
-  With the scope ``PRIVATE`` and ``PUBLIC``, items will populate the
+  With the scope ``PRIVATE`` and ``PUBLIC``, ``<files>`` will populate the
   :prop_fs:`SOURCES` property of ``<set>``, which are used when building the
-  target itself. With the scope ``PUBLIC`` and ``INTERFACE``, items will
+  target itself. With the scope ``PUBLIC`` and ``INTERFACE``, ``<files>`` will
   populate the :prop_fs:`INTERFACE_SOURCES` property of ``<set>``, which are
   used when building dependents. The sources specified by the
   :prop_fs:`INTERFACE_SOURCES` property are propagated, transitively, to all