Help: Change PATHS to HINTS for pkg-config

When pkg-config is available and package is found with it, HINTS are a
better place where to hint the PC_Foo_* variables than PATHS. HINTS are
looked before the system default paths and those listed in PATHS.
This commit is contained in:
Peter Kokot
2024-11-14 20:28:36 +01:00
parent 03e7b8cb07
commit c2f4183399
+5 -5
View File
@@ -417,18 +417,18 @@ information from the ``Foo.pc`` file.
Now we need to find the libraries and include files; we use the Now we need to find the libraries and include files; we use the
information from ``pkg-config`` to provide hints to CMake about where to information from ``pkg-config`` to provide hints to CMake about where to
look. look before checking other default paths.
.. code-block:: cmake .. code-block:: cmake
find_path(Foo_INCLUDE_DIR find_path(Foo_INCLUDE_DIR
NAMES foo.h NAMES foo.h
PATHS ${PC_Foo_INCLUDE_DIRS} HINTS ${PC_Foo_INCLUDE_DIRS}
PATH_SUFFIXES Foo PATH_SUFFIXES Foo
) )
find_library(Foo_LIBRARY find_library(Foo_LIBRARY
NAMES foo NAMES foo
PATHS ${PC_Foo_LIBRARY_DIRS} HINTS ${PC_Foo_LIBRARY_DIRS}
) )
Alternatively, if the library is available with multiple configurations, you can Alternatively, if the library is available with multiple configurations, you can
@@ -439,11 +439,11 @@ use :module:`SelectLibraryConfigurations` to automatically set the
find_library(Foo_LIBRARY_RELEASE find_library(Foo_LIBRARY_RELEASE
NAMES foo NAMES foo
PATHS ${PC_Foo_LIBRARY_DIRS}/Release HINTS ${PC_Foo_LIBRARY_DIRS}/Release
) )
find_library(Foo_LIBRARY_DEBUG find_library(Foo_LIBRARY_DEBUG
NAMES foo NAMES foo
PATHS ${PC_Foo_LIBRARY_DIRS}/Debug HINTS ${PC_Foo_LIBRARY_DIRS}/Debug
) )
include(SelectLibraryConfigurations) include(SelectLibraryConfigurations)