From 8817f3b131522cd7f3b482be915e42a20104224a Mon Sep 17 00:00:00 2001 From: Vito Gamberini Date: Wed, 19 Mar 2025 07:53:18 -0400 Subject: PkgC: Document cmake variables --- Help/manual/cmake-variables.7.rst | 5 +++++ Help/variable/CMAKE_PKG_CONFIG_DISABLE_UNINSTALLED.rst | 9 +++++++++ Help/variable/CMAKE_PKG_CONFIG_PC_LIB_DIRS.rst | 8 ++++++++ Help/variable/CMAKE_PKG_CONFIG_PC_PATH.rst | 8 ++++++++ Help/variable/CMAKE_PKG_CONFIG_SYSROOT_DIR.rst | 8 ++++++++ Help/variable/CMAKE_PKG_CONFIG_TOP_BUILD_DIR.rst | 7 +++++++ 6 files changed, 45 insertions(+) create mode 100644 Help/variable/CMAKE_PKG_CONFIG_DISABLE_UNINSTALLED.rst create mode 100644 Help/variable/CMAKE_PKG_CONFIG_PC_LIB_DIRS.rst create mode 100644 Help/variable/CMAKE_PKG_CONFIG_PC_PATH.rst create mode 100644 Help/variable/CMAKE_PKG_CONFIG_SYSROOT_DIR.rst create mode 100644 Help/variable/CMAKE_PKG_CONFIG_TOP_BUILD_DIR.rst diff --git a/Help/manual/cmake-variables.7.rst b/Help/manual/cmake-variables.7.rst index cbf8a92..07f3cf2 100644 --- a/Help/manual/cmake-variables.7.rst +++ b/Help/manual/cmake-variables.7.rst @@ -253,6 +253,11 @@ Variables that Change Behavior /variable/CMAKE_MESSAGE_LOG_LEVEL /variable/CMAKE_MFC_FLAG /variable/CMAKE_MODULE_PATH + /variable/CMAKE_PKG_CONFIG_DISABLE_UNINSTALLED + /variable/CMAKE_PKG_CONFIG_PC_LIB_DIRS + /variable/CMAKE_PKG_CONFIG_PC_PATH + /variable/CMAKE_PKG_CONFIG_SYSROOT_DIR + /variable/CMAKE_PKG_CONFIG_TOP_BUILD_DIR /variable/CMAKE_POLICY_DEFAULT_CMPNNNN /variable/CMAKE_POLICY_VERSION_MINIMUM /variable/CMAKE_POLICY_WARNING_CMPNNNN diff --git a/Help/variable/CMAKE_PKG_CONFIG_DISABLE_UNINSTALLED.rst b/Help/variable/CMAKE_PKG_CONFIG_DISABLE_UNINSTALLED.rst new file mode 100644 index 0000000..febd5a3 --- /dev/null +++ b/Help/variable/CMAKE_PKG_CONFIG_DISABLE_UNINSTALLED.rst @@ -0,0 +1,9 @@ +CMAKE_PKG_CONFIG_DISABLE_UNINSTALLED +------------------------------------ + +.. versionadded:: 4.0 + +Enable / Disable the default "uninstalled" search behavior of the +:command:`cmake_pkg_config` command. When this variable is false, package files +with an "-uninstalled" suffix have higher priority than exact package name +matches. diff --git a/Help/variable/CMAKE_PKG_CONFIG_PC_LIB_DIRS.rst b/Help/variable/CMAKE_PKG_CONFIG_PC_LIB_DIRS.rst new file mode 100644 index 0000000..20576fb --- /dev/null +++ b/Help/variable/CMAKE_PKG_CONFIG_PC_LIB_DIRS.rst @@ -0,0 +1,8 @@ +CMAKE_PKG_CONFIG_PC_LIB_DIRS +---------------------------- + +.. versionadded:: 4.0 + +:ref:`Semicolon-separated list ` of primary paths which +the :command:`cmake_pkg_config` command will search for package files by +default. Also used to derive the ``pc_path`` package variable. diff --git a/Help/variable/CMAKE_PKG_CONFIG_PC_PATH.rst b/Help/variable/CMAKE_PKG_CONFIG_PC_PATH.rst new file mode 100644 index 0000000..fd52c97 --- /dev/null +++ b/Help/variable/CMAKE_PKG_CONFIG_PC_PATH.rst @@ -0,0 +1,8 @@ +CMAKE_PKG_CONFIG_PC_PATH +------------------------ + +.. versionadded:: 4.0 + +:ref:`Semicolon-separated list ` of supplementary paths +which the :command:`cmake_pkg_config` command will search for package files by +efault. Also used to derive the ``pc_path`` package variable. diff --git a/Help/variable/CMAKE_PKG_CONFIG_SYSROOT_DIR.rst b/Help/variable/CMAKE_PKG_CONFIG_SYSROOT_DIR.rst new file mode 100644 index 0000000..e303ecd --- /dev/null +++ b/Help/variable/CMAKE_PKG_CONFIG_SYSROOT_DIR.rst @@ -0,0 +1,8 @@ +CMAKE_PKG_CONFIG_SYSROOT_DIR +---------------------------- + +.. versionadded:: 4.0 + +Path prepended to ``-I`` include directories and ``-L`` library directories +extracted by the :command:`cmake_pkg_config` command by default. Also used to +derive the ``pc_sysrootdir`` package variable. diff --git a/Help/variable/CMAKE_PKG_CONFIG_TOP_BUILD_DIR.rst b/Help/variable/CMAKE_PKG_CONFIG_TOP_BUILD_DIR.rst new file mode 100644 index 0000000..a343c94 --- /dev/null +++ b/Help/variable/CMAKE_PKG_CONFIG_TOP_BUILD_DIR.rst @@ -0,0 +1,7 @@ +CMAKE_PKG_CONFIG_TOP_BUILD_DIR +------------------------------ + +.. versionadded:: 4.0 + +Path used to derive the ``pc_top_builddir`` package variable by the +:command:`cmake_pkg_config` command by default. -- cgit v0.12