From 7a39cfb012d96a344722a25d6f524f60ff58289b Mon Sep 17 00:00:00 2001 From: scivision Date: Fri, 23 Aug 2024 12:46:15 -0400 Subject: Help Check{Function,Library}Exists refer to CheckSourceCompiles help users be aware of more general/robust CheckSourceCompiles --- Modules/CheckFunctionExists.cmake | 9 ++++----- Modules/CheckLibraryExists.cmake | 9 +++++---- 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/Modules/CheckFunctionExists.cmake b/Modules/CheckFunctionExists.cmake index e7c47a4..76fa76a 100644 --- a/Modules/CheckFunctionExists.cmake +++ b/Modules/CheckFunctionExists.cmake @@ -5,7 +5,7 @@ CheckFunctionExists ------------------- -Check if a C function can be linked +Check once if a C function can be linked from system libraries. .. command:: check_function_exists @@ -14,8 +14,7 @@ Check if a C function can be linked check_function_exists( ) Checks that the ```` is provided by libraries on the system and store - the result in a ````, which will be created as an internal - cache variable. + the result in internal cache variable ````. The following variables may be set before calling this macro to modify the way the check is run: @@ -34,8 +33,8 @@ way the check is run: .. note:: - Prefer using :Module:`CheckSymbolExists` instead of this module, - for the following reasons: + Prefer using :module:`CheckSymbolExists` or :module:`CheckSourceCompiles` + instead of this module, for the following reasons: * ``check_function_exists()`` can't detect functions that are inlined in headers or specified as a macro. diff --git a/Modules/CheckLibraryExists.cmake b/Modules/CheckLibraryExists.cmake index 8340500..d48d7ec 100644 --- a/Modules/CheckLibraryExists.cmake +++ b/Modules/CheckLibraryExists.cmake @@ -5,7 +5,7 @@ CheckLibraryExists ------------------ -Check if the function exists. +Check once if the function exists in system or specified library. .. command:: CHECK_LIBRARY_EXISTS @@ -18,10 +18,11 @@ Check if the function exists. LIBRARY - the name of the library you are looking for FUNCTION - the name of the function LOCATION - location where the library should be found - VARIABLE - variable to store the result - Will be created as an internal cache variable. - + VARIABLE - internal cache variable to store the result +Prefer using :module:`CheckSymbolExists` or :module:`CheckSourceCompiles` +instead of this module for more robust detection if a function is available in +a library. The following variables may be set before calling this macro to modify the way the check is run: -- cgit v0.12