mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-04 12:49:36 -06:00
316815e1f4
Previously the command considered non-absolute source file paths relative to the associated target on the LHS. This causes problems in incremental builds where files are added from subdirectories and forces users to workaround by manually converting to absolute paths. Change this to enable more intuitive usage by projects. Fixes #17981
35 lines
1.4 KiB
ReStructuredText
35 lines
1.4 KiB
ReStructuredText
target_sources
|
|
--------------
|
|
|
|
Add sources to a target.
|
|
|
|
::
|
|
|
|
target_sources(<target>
|
|
<INTERFACE|PUBLIC|PRIVATE> [items1...]
|
|
[<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])
|
|
|
|
Specify sources to use when compiling a given target. Relative
|
|
source file paths are interpreted as being relative to the current
|
|
source directory (i.e. :variable:`CMAKE_CURRENT_SOURCE_DIR`). The
|
|
named ``<target>`` must have been created by a command such as
|
|
:command:`add_executable` or :command:`add_library` and must not be an
|
|
:ref:`ALIAS target <Alias Targets>`.
|
|
|
|
The ``INTERFACE``, ``PUBLIC`` and ``PRIVATE`` keywords are required to
|
|
specify the scope of the following arguments. ``PRIVATE`` and ``PUBLIC``
|
|
items will populate the :prop_tgt:`SOURCES` property of
|
|
``<target>``. ``PUBLIC`` and ``INTERFACE`` items will populate the
|
|
:prop_tgt:`INTERFACE_SOURCES` property of ``<target>``.
|
|
(:ref:`IMPORTED targets <Imported Targets>` only support ``INTERFACE`` items.)
|
|
The following arguments specify sources. Repeated calls for the same
|
|
``<target>`` append items in the order called.
|
|
|
|
Arguments to ``target_sources`` may use "generator expressions"
|
|
with the syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)`
|
|
manual for available expressions. See the :manual:`cmake-buildsystem(7)`
|
|
manual for more on defining buildsystem properties.
|
|
|
|
See also the :policy:`CMP0076` policy for older behavior related to the
|
|
handling of relative source file paths.
|