rapids_export_find_package_root

Added in version v21.10.00.

Record that for <PackageName> to be found correctly, the <PackageName>_ROOT_DIR needs to be set to the provided path.

rapids_export_find_package_root( (BUILD|INSTALL)
                                 <PackageName>
                                 <directory_path>
                                 (<ExportSetName> | EXPORT_SET [ExportSetName])
                                 [CONDITION <variableName>]
                                 )

When constructing complicated export sets, espically ones that install complicated dependencies it can be necessary to specify PackageName_ROOT so that we are sure we will find the packaged dependency.

BUILD

Record that the PackageName_ROOT will be set to <directory_path> before any find_dependency calls for PackageName for our build directory export set.

INSTALL

Record that the PackageName_ROOT will be set to <directory_path> before any find_dependency calls for PackageName for our install directory export set.

EXPORT_SET

List the export set name that the directory_path should be attached too. If no name is given the associated call will be ignored.

CONDITION

A boolean variable name, that when evaluates to undefined or a false value will cause the associated call to be ignored.