From ca6ea52e3293bbc6b637fbf7d4aadce75e6648d1 Mon Sep 17 00:00:00 2001 From: "Roscoe A. Bartlett" Date: Fri, 1 Nov 2024 11:46:17 -0600 Subject: [PATCH] Update howto with alternative lib names with tribits_tpl_find_include_dirs_and_libraries() Signed-off-by: Roscoe A. Bartlett --- tribits/doc/guides/TribitsGuidesBody.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/tribits/doc/guides/TribitsGuidesBody.rst b/tribits/doc/guides/TribitsGuidesBody.rst index b002cbc80..bcd68bed1 100644 --- a/tribits/doc/guides/TribitsGuidesBody.rst +++ b/tribits/doc/guides/TribitsGuidesBody.rst @@ -5942,6 +5942,22 @@ header files and libraries that must be found. A simple MUST_FIND_ALL_LIBS ) +Note that a set of alternate names for each library can be specified using +quotes around the set of alternative library names using the syntax:: + + tribits_tpl_find_include_dirs_and_libraries( + ... + REQUIRED_LIBS_NAMES " ..." ... + ... + ) + +This is most commonly used for simple single-library TPLs like BLAS that has +different potential implementations like:: + + tribits_tpl_find_include_dirs_and_libraries( BLAS + REQUIRED_LIBS_NAMES "blas openblas atlas" + ... + ) Requirements for FindTPL.cmake modules +++++++++++++++++++++++++++++++++++++++++++++++