summaryrefslogtreecommitdiffstats
path: root/Help/policy/CMP0134.rst
blob: 2b562bc1a71029027e5c86d688976fb33ed61f41 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
CMP0134
-------

.. versionadded:: 3.24

The default registry view is ``TARGET`` for the :command:`find_file`,
:command:`find_path`, :command:`find_library`, and :command:`find_package`
commands and ``BOTH`` for the :command:`find_program` command.

The default registry views in CMake 3.23 and below are selected using the
following rules:

* if :variable:`CMAKE_SIZEOF_VOID_P` has value ``8``:

  * Use view ``64`` for all ``find_*`` commands except :command:`find_program`
    command.
  * Use view ``64_32`` for :command:`find_program` command.

* if :variable:`CMAKE_SIZEOF_VOID_P` has value ``4`` or is undefined:

  * Use view ``32`` for all ``find_*`` commands except :command:`find_program`
    command.
  * Use view ``32_64`` for :command:`find_program` command.

The ``OLD`` behavior for this policy is to use registry views ``64`` and
``64_32`` or ``32_64`` and ``32`` as default, depending of
:variable:`CMAKE_SIZEOF_VOID_P` variable value.
The ``NEW`` behavior for this policy is to use registry views ``TARGET`` and
``BOTH`` as default.

This policy was introduced in CMake version 3.24.  Use the
:command:`cmake_policy` command to set this policy to ``OLD`` or ``NEW``
explicitly. Unlike many policies, CMake version |release| does *not* warn
by default when this policy is not set and simply uses ``OLD`` behavior.
See documentation of the
:variable:`CMAKE_POLICY_WARNING_CMP0133 <CMAKE_POLICY_WARNING_CMP<NNNN>>`
variable to control the warning.

.. include:: DEPRECATED.txt