From b2feea6f3816574d8d1caae968c4ee036c237dcf Mon Sep 17 00:00:00 2001
From: Brad King <brad.king@kitware.com>
Date: Mon, 7 Sep 2026 11:13:59 -0400
Subject: [PATCH] Find{BLAS,LAPACK}: Document intended usage of `_LIBRARIES`
 more precisely

Remove the outdated promise of absolute paths in `_LIBRARIES`.
The "using full path name" phrasing was left from before imported
targets were a thing.

Issue: #28073
---
 Modules/FindBLAS.cmake   |  7 ++++---
 Modules/FindLAPACK.cmake | 11 ++++++-----
 2 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/Modules/FindBLAS.cmake b/Modules/FindBLAS.cmake
index 9f986a78e7..fbb5c4e777 100644
--- a/Modules/FindBLAS.cmake
+++ b/Modules/FindBLAS.cmake
@@ -36,12 +36,13 @@ This module defines the following variables:
   Boolean indicating whether the library implementing the BLAS interface
   was found.
 ``BLAS_LINKER_FLAGS``
-  Uncached list of required linker flags (excluding ``-l`` and ``-L``).
+  List of required linker flags, excluding ``-l`` and ``-L``,
+  to pass to :command:`target_link_options`.
 ``BLAS_LIBRARIES``
-  Uncached list of libraries (using full path name) to link against
+  List of libraries to link via :command:`target_link_libraries`
   to use BLAS (may be empty if compiler implicitly links BLAS).
 ``BLAS95_LIBRARIES``
-  Uncached list of libraries (using full path name) to link against
+  List of libraries to link via :command:`target_link_libraries`
   to use BLAS95 interface.
 ``BLAS95_FOUND``
   Boolean indicating whether the library implementing the BLAS95 interface
diff --git a/Modules/FindLAPACK.cmake b/Modules/FindLAPACK.cmake
index 52b13d9762..1927b60b50 100644
--- a/Modules/FindLAPACK.cmake
+++ b/Modules/FindLAPACK.cmake
@@ -36,13 +36,14 @@ This module defines the following variables:
   Boolean indicating whether the library implementing the LAPACK interface
   was found.
 ``LAPACK_LINKER_FLAGS``
-  Uncached list of required linker flags (excluding ``-l`` and ``-L``).
+  List of required linker flags, excluding ``-l`` and ``-L``,
+  to pass to :command:`target_link_options`.
 ``LAPACK_LIBRARIES``
-  Uncached list of libraries (using full path name) to link against to use
-  LAPACK.
+  List of libraries to link via :command:`target_link_libraries`
+  to use LAPACK.
 ``LAPACK95_LIBRARIES``
-  Uncached list of libraries (using full path name) to link against to use
-  LAPACK95.
+  List of libraries to link via :command:`target_link_libraries`
+  to use LAPACK95.
 ``LAPACK95_FOUND``
   Boolean indicating whether the library implementing the LAPACK95 interface
   was found.