| CMP0102 | |
| ------- | |
| .. versionadded:: 3.17 | |
| The :command:`mark_as_advanced` command no longer creates a cache entry if one | |
| does not already exist. | |
| In CMake 3.16 and below, if a variable was not defined at all or just defined | |
| locally, the :command:`mark_as_advanced` command would create a new cache | |
| entry with an ``UNINITIALIZED`` type and no value. When a :command:`find_path` | |
| (or other similar ``find_`` command) would next run, it would find this | |
| undefined cache entry and set it up with an empty string value. This process | |
| would end up deleting the local variable in the process (due to the way the | |
| cache works), effectively clearing any stored ``find_`` results that were only | |
| available in the local scope. | |
| The ``OLD`` behavior for this policy is to create the empty cache definition. | |
| The ``NEW`` behavior of this policy is to ignore variables which do not | |
| already exist in the cache. | |
| .. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.17 | |
| .. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn by default | |
| .. include:: include/STANDARD_ADVICE.rst | |
| See documentation of the :variable:`CMAKE_POLICY_WARNING_CMP0102 | |
| <CMAKE_POLICY_WARNING_CMP<NNNN>>` variable to control the warning. | |
| .. include:: include/DEPRECATED.rst |