CPS: Support additional metadata

Add support for specifying CPS's supplemental `description` and
`website` attributes. Add ability to inherit these from the `project()`,
similar to how version information can be inherited.
This commit is contained in:
Matthew Woehlke
2025-06-03 16:24:13 -04:00
parent f224e131a5
commit da97747dac
18 changed files with 89 additions and 6 deletions

View File

@@ -140,7 +140,9 @@ Exporting Targets to the |CPS|
[COMPAT_VERSION <version>]
[VERSION_SCHEMA <string>]]
[DEFAULT_TARGETS <target>...]
[DEFAULT_CONFIGURATIONS <config>...])
[DEFAULT_CONFIGURATIONS <config>...]
[DESCRIPTION <project-description-string>]
[HOMEPAGE_URL <url-string>])
.. versionadded:: 4.1
.. note::

View File

@@ -1001,6 +1001,8 @@ Signatures
[VERSION_SCHEMA <string>]]
[DEFAULT_TARGETS <target>...]
[DEFAULT_CONFIGURATIONS <config>...]
[DESCRIPTION <project-description-string>]
[HOMEPAGE_URL <url-string>]
[PERMISSIONS <permission>...]
[CONFIGURATIONS <config>...]
[COMPONENT <component>]
@@ -1057,6 +1059,17 @@ Signatures
configurations exists. If not specified, CMake will fall back to the
package's available configurations in an unspecified order.
``DESCRIPTION <project-description-string>``
.. versionadded:: 4.1
An informational description of the project. It is recommended that this
description is a relatively short string, usually no more than a few words.
``HOMEPAGE_URL <url-string>``
.. versionadded:: 4.1
An informational canonical home URL for the project.
By default, if the specified ``<package-name>`` matches the current CMake
:variable:`PROJECT_NAME`, package metadata will be inherited from the
project. The ``PROJECT <project-name>`` option may be used to specify a