From c2f4183399a697faa352cf65d932829fdfa30d86 Mon Sep 17 00:00:00 2001 From: Peter Kokot Date: Thu, 14 Nov 2024 20:28:36 +0100 Subject: [PATCH] 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. --- Help/manual/cmake-developer.7.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Help/manual/cmake-developer.7.rst b/Help/manual/cmake-developer.7.rst index fc7a27d972..2234d91a72 100644 --- a/Help/manual/cmake-developer.7.rst +++ b/Help/manual/cmake-developer.7.rst @@ -417,18 +417,18 @@ information from the ``Foo.pc`` file. 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 -look. +look before checking other default paths. .. code-block:: cmake find_path(Foo_INCLUDE_DIR NAMES foo.h - PATHS ${PC_Foo_INCLUDE_DIRS} + HINTS ${PC_Foo_INCLUDE_DIRS} PATH_SUFFIXES Foo ) find_library(Foo_LIBRARY NAMES foo - PATHS ${PC_Foo_LIBRARY_DIRS} + HINTS ${PC_Foo_LIBRARY_DIRS} ) 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 NAMES foo - PATHS ${PC_Foo_LIBRARY_DIRS}/Release + HINTS ${PC_Foo_LIBRARY_DIRS}/Release ) find_library(Foo_LIBRARY_DEBUG NAMES foo - PATHS ${PC_Foo_LIBRARY_DIRS}/Debug + HINTS ${PC_Foo_LIBRARY_DIRS}/Debug ) include(SelectLibraryConfigurations)