mirror of
https://gitlab.kitware.com/cmake/cmake.git
synced 2026-09-25 04:09:36 +03:00
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.
This commit is contained in:
committed by
Brad King
parent
4ef40610d9
commit
72ff5cb481
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user