From 9edb5f57127489dec4b7cbdc1e60920e6002abea Mon Sep 17 00:00:00 2001 From: "Friedrich W. H. Kossebau" Date: Sun, 12 Jun 2022 16:13:22 +0200 Subject: API dox: use more markup for code or commandline samples NO_CHANGELOG --- modules/ECMFindModuleHelpers.cmake | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) (limited to 'modules/ECMFindModuleHelpers.cmake') diff --git a/modules/ECMFindModuleHelpers.cmake b/modules/ECMFindModuleHelpers.cmake index ce873b4b..1375ebd4 100644 --- a/modules/ECMFindModuleHelpers.cmake +++ b/modules/ECMFindModuleHelpers.cmake @@ -6,9 +6,9 @@ ECMFindModuleHelpers -------------------- -Helper macros for find modules: ecm_find_package_version_check(), -ecm_find_package_parse_components() and -ecm_find_package_handle_library_components(). +Helper macros for find modules: ``ecm_find_package_version_check()``, +``ecm_find_package_parse_components()`` and +``ecm_find_package_handle_library_components()``. :: @@ -26,14 +26,14 @@ is older than that required by extra-cmake-modules. This macro will populate with a list of components found in _FIND_COMPONENTS, after checking that all those components are in the -list of KNOWN_COMPONENTS; if there are any unknown components, it will print +list of ``KNOWN_COMPONENTS``; if there are any unknown components, it will print an error or warning (depending on the value of _FIND_REQUIRED) and call -return(). +``return()``. The order of components in is guaranteed to match the order they -are listed in the KNOWN_COMPONENTS argument. +are listed in the ``KNOWN_COMPONENTS`` argument. -If SKIP_DEPENDENCY_HANDLING is not set, for each component the variable +If ``SKIP_DEPENDENCY_HANDLING`` is not set, for each component the variable __component_deps will be checked for dependent components. If is listed in _FIND_COMPONENTS, then all its (transitive) dependencies will also be added to . @@ -53,13 +53,13 @@ and __header variable should contain the name of a header file associated with it (whatever relative path is normally passed to '#include'). __header_subdir variable can be used to specify which subdirectory of the include path the headers will be found in. -ecm_find_package_components() will then search for the library +``ecm_find_package_components()`` will then search for the library and include directory (creating appropriate cache variables) and create an imported library target named ::. Additional variables can be used to provide additional information: -If SKIP_PKG_CONFIG, the __pkg_config variable is set, and +If ``SKIP_PKG_CONFIG``, the __pkg_config variable is set, and pkg-config is found, the pkg-config module given by __pkg_config will be searched for and used to help locate the library and header file. It will also be used to set @@ -69,13 +69,13 @@ Note that if version information is found via pkg-config, __FIND_VERSION can be set to require a particular version for each component. -If SKIP_DEPENDENCY_HANDLING is not set, the INTERFACE_LINK_LIBRARIES property +If ``SKIP_DEPENDENCY_HANDLING`` is not set, the ``INTERFACE_LINK_LIBRARIES`` property of the imported target for will be set to contain the imported targets for the components listed in __component_deps. -_FOUND will also be set to false if any of the components in +_FOUND will also be set to ``FALSE`` if any of the components in __component_deps are not found. This requires the components in __component_deps to be listed before in the -COMPONENTS argument. +``COMPONENTS`` argument. The following variables will be set: @@ -94,8 +94,8 @@ The following variables will be set: be altered Note that these variables are never cleared, so if -ecm_find_package_handle_library_components() is called multiple times with -different components (typically because of multiple find_package() calls) then +``ecm_find_package_handle_library_components()`` is called multiple times with +different components (typically because of multiple ``find_package()`` calls) then ``_TARGETS``, for example, will contain all the targets found in any call (although no duplicates). -- cgit v1.2.1