1CMP0090
2-------
3
4.. versionadded:: 3.15
5
6:command:`export(PACKAGE)` does not populate package registry by default.
7
8In CMake 3.14 and below the :command:`export(PACKAGE)` command populated the
9user package registry by default and users needed to set the
10:variable:`CMAKE_EXPORT_NO_PACKAGE_REGISTRY` to disable it, e.g. in automated
11build and packaging environments.  Since the user package registry is stored
12outside the build tree, this side effect should not be enabled by default.
13Therefore CMake 3.15 and above prefer that :command:`export(PACKAGE)` does
14nothing unless an explicit :variable:`CMAKE_EXPORT_PACKAGE_REGISTRY` variable
15is set to enable it.  This policy provides compatibility with projects that
16have not been updated.
17
18The ``OLD`` behavior for this policy is for :command:`export(PACKAGE)` command
19to populate the user package registry unless
20:variable:`CMAKE_EXPORT_NO_PACKAGE_REGISTRY` is enabled.
21The ``NEW`` behavior is for :command:`export(PACKAGE)` command to do nothing
22unless the :variable:`CMAKE_EXPORT_PACKAGE_REGISTRY` is enabled.
23
24This policy was introduced in CMake version 3.15.  Use the
25:command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.
26Unlike most policies, CMake version |release| does *not* warn
27when this policy is not set and simply uses ``OLD`` behavior.
28
29.. include:: DEPRECATED.txt
30