mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-05 21:31:08 -06:00
26 lines
1.1 KiB
ReStructuredText
26 lines
1.1 KiB
ReStructuredText
CMP0125
|
|
-------
|
|
|
|
.. versionadded:: 3.21
|
|
|
|
The :command:`find_file`, :command:`find_path`, :command:`find_library` and
|
|
:command:`find_program` commands handle cache variables in the same way
|
|
regardless of whether they are defined on the command line, with or without a
|
|
type, or using the :command:`set` command.
|
|
|
|
Starting with CMake 3.21, the :command:`find_file`, :command:`find_path`,
|
|
:command:`find_library`, and :command:`find_program` commands ensure that the
|
|
cache variables will be used in the same way regardless how they were defined
|
|
and the result will be always successful if the searched artifact exists.
|
|
|
|
The ``OLD`` behavior for this policy is to have the find commands' behaviors
|
|
differ depending on how the cache variable is defined. The ``NEW`` behavior for
|
|
this policy is to have consistent behavior.
|
|
|
|
This policy was introduced in CMake version 3.21. Use the
|
|
:command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.
|
|
Unlike many policies, CMake version |release| does *not* warn when the policy
|
|
is not set and simply uses ``OLD`` behavior.
|
|
|
|
.. include:: DEPRECATED.txt
|