1CMP0080
2-------
3
4.. versionadded:: 3.13
5
6:module:`BundleUtilities` cannot be included at configure time.
7
8The macros provided by :module:`BundleUtilities` are intended to be invoked
9at install time rather than at configure time, because they depend on the
10listed targets already existing at the time they are invoked. If they are
11invoked at configure time, the targets haven't been built yet, and the
12commands will fail.
13
14This policy restricts the inclusion of :module:`BundleUtilities` to
15``cmake -P`` style scripts and install rules. Specifically, it looks for the
16presence of :variable:`CMAKE_GENERATOR` and throws a fatal error if it exists.
17
18The ``OLD`` behavior of this policy is to allow :module:`BundleUtilities` to
19be included at configure time. The ``NEW`` behavior of this policy is to
20disallow such inclusion.
21
22This policy was introduced in CMake version 3.13.  CMake version
23|release| warns when the policy is not set and uses ``OLD`` behavior.
24Use the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW``
25explicitly.
26
27.. include:: DEPRECATED.txt
28