summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2023-09-20 16:44:00 (GMT)
committerBrad King <brad.king@kitware.com>2023-09-20 16:44:00 (GMT)
commit51c292781653b3fe7a64a535744aea0d59f11a6e (patch)
treed85ff5f5d231ffe6b362a4f8e1c073f29458906c
parente625255fe45336d187a3fbe273dc158049f326f6 (diff)
downloadCMake-51c292781653b3fe7a64a535744aea0d59f11a6e.zip
CMake-51c292781653b3fe7a64a535744aea0d59f11a6e.tar.gz
CMake-51c292781653b3fe7a64a535744aea0d59f11a6e.tar.bz2
Help: Clarify requirements for find_package to use lib{64,32,x32} paths
Issue: #25157
-rw-r--r--Help/command/find_package.rst25
-rw-r--r--Help/variable/CMAKE_SIZEOF_VOID_P.rst4
2 files changed, 19 insertions, 10 deletions
diff --git a/Help/command/find_package.rst b/Help/command/find_package.rst
index c3d8c42..9a007fa 100644
--- a/Help/command/find_package.rst
+++ b/Help/command/find_package.rst
@@ -323,18 +323,27 @@ containing a configuration file:
In all cases the ``<name>`` is treated as case-insensitive and corresponds
to any of the names specified (``<PackageName>`` or names given by ``NAMES``).
-Paths with ``lib/<arch>`` are enabled if the
-:variable:`CMAKE_LIBRARY_ARCHITECTURE` variable is set. ``lib*`` includes one
-or more of the values ``lib64``, ``lib32``, ``libx32`` or ``lib`` (searched in
-that order).
+If at least one compiled language has been enabled, the architecture-specific
+``lib/<arch>`` and ``lib*`` directories may be searched based on the compiler's
+target architecture, in the following order:
-* Paths with ``lib64`` are searched on 64 bit platforms if the
+``lib/<arch>``
+ Searched if the :variable:`CMAKE_LIBRARY_ARCHITECTURE` variable is set.
+
+``lib64``
+ Searched on 64 bit platforms (:variable:`CMAKE_SIZEOF_VOID_P` is 8) and the
:prop_gbl:`FIND_LIBRARY_USE_LIB64_PATHS` property is set to ``TRUE``.
-* Paths with ``lib32`` are searched on 32 bit platforms if the
+
+``lib32``
+ Searched on 32 bit platforms (:variable:`CMAKE_SIZEOF_VOID_P` is 4) and the
:prop_gbl:`FIND_LIBRARY_USE_LIB32_PATHS` property is set to ``TRUE``.
-* Paths with ``libx32`` are searched on platforms using the x32 ABI
+
+``libx32``
+ Searched on platforms using the x32 ABI
if the :prop_gbl:`FIND_LIBRARY_USE_LIBX32_PATHS` property is set to ``TRUE``.
-* The ``lib`` path is always searched.
+
+``lib``
+ Always searched.
.. versionchanged:: 3.24
On ``Windows`` platform, it is possible to include registry queries as part
diff --git a/Help/variable/CMAKE_SIZEOF_VOID_P.rst b/Help/variable/CMAKE_SIZEOF_VOID_P.rst
index f5464d1..0c1fd7a 100644
--- a/Help/variable/CMAKE_SIZEOF_VOID_P.rst
+++ b/Help/variable/CMAKE_SIZEOF_VOID_P.rst
@@ -4,5 +4,5 @@ CMAKE_SIZEOF_VOID_P
Size of a ``void`` pointer.
This is set to the size of a pointer on the target machine, and is determined
-by a try compile. If a 64-bit size is found, then the library search
-path is modified to look for 64-bit libraries first.
+when a compiled language is enabled. If a 64-bit size is found, then the
+library search path is modified to look for 64-bit libraries first.