CMP0217 — CMake 4.4.20260621-gcc70e9e-dirty Documentation

# CMP0217

Added in version 4.4.

The `MACROS` directory property does not exist anymore.

In CMake 4.3 and below, the macros defined in a directory are registered in the `MACROS` directory property. However, the property does not have the same scope as macros, so it does not represent the actual list of macros. In CMake 4.4 and above, this property is not longer filled with the defined macros. One may still use `if(COMMAND myMacro)` to test whether one exists.

The `OLD` behavior for this policy is to store macros definition in the `MACROS` directory property. The `NEW` behavior for this policy is to no longer manage the `MACROS` directory property.

This policy was introduced in CMake version 4.4. It may be set by `cmake_policy()` or `cmake_minimum_required()`. If it is not set, CMake does not warn, and uses `OLD` behavior.

Note

The `OLD` behavior of a policy is deprecated by definition and may be removed in a future version of CMake.