From 775e06a59264a5c176d6a9e0bf556d6cf3203239 Mon Sep 17 00:00:00 2001
From: Chris Green <greenc@fnal.gov>
Date: Tue, 6 Feb 2024 10:33:47 -0600
Subject: [PATCH] Improve `cet_cmake_module_directories()` documentation per
 @knoepfel request

---
 Modules/CetCMakeUtils.cmake | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/Modules/CetCMakeUtils.cmake b/Modules/CetCMakeUtils.cmake
index b586a3dd..0c8fed13 100644
--- a/Modules/CetCMakeUtils.cmake
+++ b/Modules/CetCMakeUtils.cmake
@@ -638,16 +638,25 @@ endfunction()
      Also add the corresponding directories in the project build tree to
      :variable:`CMAKE_MODULE_PATH
      <cmake-ref-current:variable:CMAKE_MODULE_PATH>` in the current
-     scope.
+     scope (e.g. for generated CMake modules).
 
-     .. seealso:: :ref:`NO_LOCAL
-                  <cet_cmake_module_directories-NO_LOCAL>`
+     .. rst-class:: text-start
+
+     .. seealso:: :command:`configure_file()
+                  <cmake-ref-current:command:configure_file>`,
+                  :command:`cet_make_plugin_builder`,
+                  :command:`cet_collect_plugin_builders`.
+
+   .. _cet_cmake_module_directories-NO_CONFIG:
 
    ``NO_CONFIG``
      Do not add these directories to :variable:`CMAKE_MODULE_PATH
      <cmake-ref-current:variable:CMAKE_MODULE_PATH>` in the CMake config
      file for ``<project>``.
 
+     .. seealso:: :ref:`NO_LOCAL
+                  <cet_cmake_module_directories-NO_LOCAL>`
+
    .. _cet_cmake_module_directories-NO_LOCAL:
 
    ``NO_LOCAL``
@@ -656,6 +665,9 @@ endfunction()
      scope. Implied if ``<project>`` is not equal to the value of
      :variable:`CETMODULES_CURRENT_PROJECT_NAME`
 
+     .. seealso:: :ref:`NO_CONFIG
+                  <cet_cmake_module_directories-NO_CONFIG>`
+
    ``PROJECT <project>``
      Specify the project to which these module directories belong. If
      not specifed, ``<project>`` defaults to