dilim/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2026-08-10 17:14:10 +00:00
Code Issues Packages Projects Releases Wiki Activity

Help: target_sources: Align descriptions with signatures

Browse Source 
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.
This commit is contained in:
FeRD (Frank Dana)
2026-07-21 12:40:38 -04:00
committed by Brad King
parent 6a5e95f6c5
commit 8df169ebe1
1 changed files with 8 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
Help/command/target_sources.rst
View File

@@ -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