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 +++++++++++++++++++++++++++++++++++++++++++++++