From 4b7ed0ec79d18e2036a40e7c56af3692d706c3ed Mon Sep 17 00:00:00 2001 From: Nikita Nemkin Date: Tue, 11 Feb 2025 14:42:25 +0500 Subject: Help: Clarify find_library() behavior for suffixed libraries The name is used as-is only if it contains a recognized suffix. Clarify this behavior and add links to the relevant variables. Fixes: #18401 --- Help/command/find_library.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/Help/command/find_library.rst b/Help/command/find_library.rst index ba046fa..fea5e74 100644 --- a/Help/command/find_library.rst +++ b/Help/command/find_library.rst @@ -52,8 +52,10 @@ for it. The ``NAMES_PER_DIR`` option tells this command to consider one directory at a time and search for all names in it. Each library name given to the ``NAMES`` option is first considered -as a library file name and then considered with platform-specific -prefixes (e.g. ``lib``) and suffixes (e.g. ``.so``). Therefore one +as is, if it contains a library suffix, and then considered with +platform-specific prefixes (e.g. ``lib``) and suffixes (e.g. ``.so``), +as defined by the variables :variable:`CMAKE_FIND_LIBRARY_PREFIXES` and +:variable:`CMAKE_FIND_LIBRARY_SUFFIXES`. Therefore one may specify library file names such as ``libfoo.a`` directly. This can be used to locate static libraries on UNIX-like systems. -- cgit v0.12