From b6445ddeda9b4a608cd34d417f04aa2ee558ef76 Mon Sep 17 00:00:00 2001
From: Johan Andruejol <johan.andruejol@kitware.com>
Date: Mon, 15 Feb 2021 14:53:23 -0500
Subject: Help: Add SelectLibraryConfigurations example to cmake-developer(7)

---
 Help/manual/cmake-developer.7.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/Help/manual/cmake-developer.7.rst b/Help/manual/cmake-developer.7.rst
index af9a8ab..fe146de 100644
--- a/Help/manual/cmake-developer.7.rst
+++ b/Help/manual/cmake-developer.7.rst
@@ -350,6 +350,24 @@ look.
     PATHS ${PC_Foo_LIBRARY_DIRS}
   )
 
+Alternatively, if the library is available with multiple configurations, you can
+use :module:`SelectLibraryConfigurations` to automatically set the
+``Foo_LIBRARY`` variable instead:
+
+.. code-block:: cmake
+
+  find_library(Foo_LIBRARY_RELEASE
+    NAMES foo
+    PATHS ${PC_Foo_LIBRARY_DIRS}/Release
+  )
+  find_library(Foo_LIBRARY_DEBUG
+    NAMES foo
+    PATHS ${PC_Foo_LIBRARY_DIRS}/Debug
+  )
+
+  include(SelectLibraryConfigurations)
+  select_library_configurations(Foo)
+
 If you have a good way of getting the version (from a header file, for
 example), you can use that information to set ``Foo_VERSION`` (although
 note that find modules have traditionally used ``Foo_VERSION_STRING``,
-- 
cgit v0.12