Merge topic 'target-sources-file-set'

e0a66059d4 Help: Fix target_sources FILE_SET signature summary
79d379fba6 Help: Add versionadded markup to target_sources FILE_SET feature

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !6703
This commit is contained in:
Brad King
2021-11-08 17:40:31 +00:00
committed by Kitware Robot
8 changed files with 21 additions and 2 deletions

View File

@@ -205,6 +205,8 @@ that may be installed:
``RESOURCE`` files. See :prop_tgt:`RESOURCE` for details.
``FILE_SET <set>``
.. versionadded:: 3.23
If the file set ``<set>`` exists and is ``PUBLIC`` or ``INTERFACE``, any
files added to the file set ``<set>`` created by
:command:`target_sources(FILE_SET)` are installed in the specified

View File

@@ -60,11 +60,16 @@ expressions to ensure the sources are correctly assigned to the target.
See the :manual:`cmake-buildsystem(7)` manual for more on defining
buildsystem properties.
File Sets
^^^^^^^^^
.. versionadded:: 3.23
.. code-block:: cmake
target_sources(<target>
<INTERFACE|PUBLIC|PRIVATE> [FILE_SET set1] [TYPE type1] [BASE_DIRS dirs1...] [FILES files1...]
[<INTERFACE|PUBLIC|PRIVATE> [FILE_SET set2] [TYPE type2] [BASE_DIRS dirs2...] [FILES files2...])
<INTERFACE|PUBLIC|PRIVATE> FILE_SET set1 [TYPE type1] [BASE_DIRS dirs1...] [FILES files1...]
[<INTERFACE|PUBLIC|PRIVATE> FILE_SET set2 [TYPE type2] [BASE_DIRS dirs2...] [FILES files2...])
Adds a file set to a target, or adds files to an existing file set. Targets
have zero or more named file sets. Each file set has a name, a type, a scope of

View File

@@ -1,6 +1,8 @@
HEADER_DIRS
-----------
.. versionadded:: 3.23
Semicolon-separated list of base directories of the default header set created
by :command:`target_sources(FILE_SET)`. This property supports
:manual:`generator expressions <cmake-generator-expressions(7)>`.

View File

@@ -1,6 +1,8 @@
HEADER_DIRS_<NAME>
------------------
.. versionadded:: 3.23
Semicolon-separated list of base directories of the header set with name
``<NAME>`` created by :command:`target_sources(FILE_SET)`. This property
supports :manual:`generator expressions <cmake-generator-expressions(7)>`.

View File

@@ -1,6 +1,8 @@
HEADER_SET
----------
.. versionadded:: 3.23
Semicolon-separated list of headers in the default header set created by
:command:`target_sources(FILE_SET)`. This property supports
:manual:`generator expressions <cmake-generator-expressions(7)>`. If any of the

View File

@@ -1,6 +1,8 @@
HEADER_SETS
-----------
.. versionadded:: 3.23
List of ``PRIVATE`` and ``PUBLIC`` header sets added by
:command:`target_sources(FILE_SET)`. Headers listed in these header sets are
treated as source files for the purposes of IDE integration.

View File

@@ -1,6 +1,8 @@
HEADER_SET_<NAME>
-----------------
.. versionadded:: 3.23
Semicolon-separated list of headers in the named header set ``<NAME>`` created
by :command:`target_sources(FILE_SET)`. This property supports
:manual:`generator expressions <cmake-generator-expressions(7)>`. If any of the

View File

@@ -1,6 +1,8 @@
INTERFACE_HEADER_SETS
---------------------
.. versionadded:: 3.23
List of ``INTERFACE`` and ``PUBLIC`` header sets added by
:command:`target_sources(FILE_SET)`. Headers listed in these header sets can be
installed with :command:`install(TARGETS)` and exported with