catalyst-macros.cmake File Reference

Go to the source code of this file.

Functions
function	catalyst_library ()
	Mark a target as the Catalyst API implementation. More...
macro	c_set_if_not_set (variable)
function	c_install_targets ()
function	c_install_headers ()

Function Documentation

catalyst_library()

function catalyst_library

(

)

Mark a target as the Catalyst API implementation.

catalyst_library(
  TARGET    <target>
  [LIBRARY_DESTINATION <destination>]
  [INSTALL_EXPORT_DEFAULT]
  )

The TARGET identifies the target added using an add_library call. This function ensures that properties on the target are set up appropriately so that the generated library is ABI compatible with the Catalyst stub implementation.

LIBRARY_DESTINATION if specified, is used to determine the install destination. If not specified, no install rule is added.

INSTALL_EXPORT_DEFAULT is useful in projects that include Catalyst as a sub-project (instead of using it externally) to build Catalyst implementations. For such projects, the Catalyst library is often built as a part of the project. Providing INSTALL_EXPORT_DEFAULT ensures that the Catalyst implementation is added as a part of the export set for the Catalyst targets so that find_package(catalyst ... ) can work seamlessly. If LIBRARY_DESTINATION must be specified if INSTALL_EXPORT_DEFAULT specified.

Definition at line 34 of file catalyst-macros.cmake.

c_set_if_not_set()

macro c_set_if_not_set

(

variable

)

Definition at line 80 of file catalyst-macros.cmake.

c_install_targets()

function c_install_targets

(

)

Definition at line 86 of file catalyst-macros.cmake.

c_install_headers()

function c_install_headers

(

)

Definition at line 110 of file catalyst-macros.cmake.