mirror of
https://github.com/Kitware/CMake.git
synced 2026-02-26 10:48:38 -06:00
Merge topic 'NO_CMAKE_INSTALL_PREFIX'
42f7e39789 Find: Support per call disabling of CMAKE_INSTALL_PREFIX
Acked-by: Kitware Robot <kwrobot@kitware.com>
Acked-by: buildbot <buildbot@kitware.com>
Merge-request: !7163
This commit is contained in:
@@ -20,6 +20,7 @@ take precedence over this variable.
|
||||
|
||||
See also the :variable:`CMAKE_FIND_USE_CMAKE_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_CMAKE_SYSTEM_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_INSTALL_PREFIX`,
|
||||
:variable:`CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY`,
|
||||
:variable:`CMAKE_FIND_USE_PACKAGE_REGISTRY`,
|
||||
|
||||
@@ -20,6 +20,7 @@ take precedence over this variable.
|
||||
|
||||
See also the :variable:`CMAKE_FIND_USE_CMAKE_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_INSTALL_PREFIX`,
|
||||
:variable:`CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY`,
|
||||
:variable:`CMAKE_FIND_USE_PACKAGE_REGISTRY`,
|
||||
|
||||
39
Help/variable/CMAKE_FIND_USE_INSTALL_PREFIX.rst
Normal file
39
Help/variable/CMAKE_FIND_USE_INSTALL_PREFIX.rst
Normal file
@@ -0,0 +1,39 @@
|
||||
CMAKE_FIND_USE_INSTALL_PREFIX
|
||||
-----------------------------------
|
||||
|
||||
.. versionadded:: 3.24
|
||||
|
||||
Controls the default behavior of the following commands for whether or not to
|
||||
search the install location:
|
||||
|
||||
* :command:`find_program`
|
||||
* :command:`find_library`
|
||||
* :command:`find_file`
|
||||
* :command:`find_path`
|
||||
* :command:`find_package`
|
||||
|
||||
This is useful in cross-compiling environments.
|
||||
|
||||
Due to backwards compatibility with :variable:`CMAKE_FIND_NO_INSTALL_PREFIX`,
|
||||
the behavior of the find command change based on if this variable exists.
|
||||
|
||||
============================== ============================ ===========
|
||||
CMAKE_FIND_USE_INSTALL_PREFIX CMAKE_FIND_NO_INSTALL_PREFIX Search
|
||||
============================== ============================ ===========
|
||||
Not Defined On NO
|
||||
Not Defined Off || Not Defined YES
|
||||
Off On NO
|
||||
Off Off || Not Defined NO
|
||||
On On YES
|
||||
On Off || Not Defined YES
|
||||
============================== ============================ ===========
|
||||
|
||||
By default this variable is not defined. Explicit options given to the above
|
||||
commands take precedence over this variable.
|
||||
|
||||
See also the :variable:`CMAKE_FIND_USE_CMAKE_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY`,
|
||||
:variable:`CMAKE_FIND_USE_PACKAGE_REGISTRY`,
|
||||
and :variable:`CMAKE_FIND_USE_PACKAGE_ROOT_PATH` variables.
|
||||
@@ -26,6 +26,7 @@ the :ref:`User Package Registry` as if they were called with the
|
||||
See also :ref:`Disabling the Package Registry` and the
|
||||
:variable:`CMAKE_FIND_USE_CMAKE_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_INSTALL_PREFIX`,
|
||||
:variable:`CMAKE_FIND_USE_CMAKE_SYSTEM_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY`,
|
||||
|
||||
@@ -18,6 +18,7 @@ take precedence over this variable.
|
||||
|
||||
See also the :variable:`CMAKE_FIND_USE_CMAKE_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_INSTALL_PREFIX`,
|
||||
:variable:`CMAKE_FIND_USE_CMAKE_SYSTEM_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY`,
|
||||
|
||||
@@ -20,6 +20,7 @@ take precedence over this variable.
|
||||
|
||||
See also the :variable:`CMAKE_FIND_USE_CMAKE_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_INSTALL_PREFIX`,
|
||||
:variable:`CMAKE_FIND_USE_CMAKE_SYSTEM_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_PACKAGE_REGISTRY`,
|
||||
:variable:`CMAKE_FIND_USE_PACKAGE_ROOT_PATH`,
|
||||
|
||||
@@ -27,6 +27,7 @@ See also :ref:`Disabling the Package Registry`.
|
||||
|
||||
See also the :variable:`CMAKE_FIND_USE_CMAKE_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_INSTALL_PREFIX`,
|
||||
:variable:`CMAKE_FIND_USE_CMAKE_SYSTEM_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH`,
|
||||
:variable:`CMAKE_FIND_USE_PACKAGE_REGISTRY`,
|
||||
|
||||
Reference in New Issue
Block a user