diff --git a/Help/command/find_package.rst b/Help/command/find_package.rst index 7f076f9237..c99c73dd35 100644 --- a/Help/command/find_package.rst +++ b/Help/command/find_package.rst @@ -285,30 +285,40 @@ CMake constructs a set of possible installation prefixes for the package. Under each prefix several directories are searched for a configuration file. The tables below show the directories searched. Each entry is meant for installation trees following Windows (``W``), UNIX -(``U``), or Apple (``A``) conventions:: +(``U``), or Apple (``A``) conventions: - / (W) - /(cmake|CMake)/ (W) - /*/ (W) - /*/(cmake|CMake)/ (W) - /*/(cmake|CMake)/*/ (W) - /(lib/|lib*|share)/cmake/*/ (U) - /(lib/|lib*|share)/*/ (U) - /(lib/|lib*|share)/*/(cmake|CMake)/ (U) - /*/(lib/|lib*|share)/cmake/*/ (W/U) - /*/(lib/|lib*|share)/*/ (W/U) - /*/(lib/|lib*|share)/*/(cmake|CMake)/ (W/U) +==================================================================== ========== + Entry Convention +==================================================================== ========== + ``/`` W + ``/(cmake|CMake)/`` W + ``/*/`` W + ``/*/(cmake|CMake)/`` W + ``/*/(cmake|CMake)/*/`` [#]_ W + ``/(lib/|lib*|share)/cmake/*/`` U + ``/(lib/|lib*|share)/*/`` U + ``/(lib/|lib*|share)/*/(cmake|CMake)/`` U + ``/*/(lib/|lib*|share)/cmake/*/`` W/U + ``/*/(lib/|lib*|share)/*/`` W/U + ``/*/(lib/|lib*|share)/*/(cmake|CMake)/`` W/U +==================================================================== ========== + +.. [#] .. versionadded:: 3.25 On systems supporting macOS :prop_tgt:`FRAMEWORK` and :prop_tgt:`BUNDLE`, the following directories are searched for Frameworks or Application Bundles -containing a configuration file:: +containing a configuration file: - /.framework/Resources/ (A) - /.framework/Resources/CMake/ (A) - /.framework/Versions/*/Resources/ (A) - /.framework/Versions/*/Resources/CMake/ (A) - /.app/Contents/Resources/ (A) - /.app/Contents/Resources/CMake/ (A) +=========================================================== ========== + Entry Convention +=========================================================== ========== + ``/.framework/Resources/`` A + ``/.framework/Resources/CMake/`` A + ``/.framework/Versions/*/Resources/`` A + ``/.framework/Versions/*/Resources/CMake/`` A + ``/.app/Contents/Resources/`` A + ``/.app/Contents/Resources/CMake/`` A +=========================================================== ========== In all cases the ```` is treated as case-insensitive and corresponds to any of the names specified (```` or names given by ``NAMES``).