Help: Describe CPS support in find_package

Update find_package documentation to describe (the current state of)
support for Common Package Specification packages. Make some general
improvements to the same while we're at it. Add documentation blurb for
the experimental flag that enables CPS support.
This commit is contained in:
Matthew Woehlke
2024-11-19 15:26:13 -05:00
committed by Brad King
parent 34828650d6
commit 5236984a08
2 changed files with 114 additions and 30 deletions
+18
View File
@@ -56,6 +56,24 @@ When activated, this experimental feature provides the following:
* The experimental ``install(PACKAGE_INFO)`` command is available to export
package information in the |CPS|_ format.
Find/Import |CPS| Packages
==========================
In order to activate support for this experimental feature, set
* variable ``CMAKE_EXPERIMENTAL_FIND_CPS_PACKAGES`` to
* value ``e82e467b-f997-4464-8ace-b00808fff261``.
This UUID may change in future versions of CMake. Be sure to use the value
documented here by the source tree of the version of CMake with which you are
experimenting.
When activated, this experimental feature provides the following:
* The :command:`find_package` command will also search for packages which are
described using |CPS|_. Refer to the :command:`find_package` documentation
for details.
C++ ``import std`` support
==========================